@hubspot/local-dev-lib 0.0.2 → 0.0.3

package/config/environment.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfigFromEnvironment = exports.getValidEnv = void 0;
+const logger_1 = require("../utils/logger");
+const constants_1 = require("../constants");
+const auth_1 = require("../constants/auth");
+const configUtils_1 = require("./configUtils");
+function getValidEnv(env, useProdDefault = true) {
+    if (typeof env === 'string' && env.toLowerCase() === constants_1.ENVIRONMENTS.QA) {
+        return constants_1.ENVIRONMENTS.QA;
+    }
+    return useProdDefault ? constants_1.ENVIRONMENTS.PROD : undefined;
+}
+exports.getValidEnv = getValidEnv;
+function getConfigVariablesFromEnv() {
+    const env = process.env;
+    return {
+        apiKey: env[constants_1.ENVIRONMENT_VARIABLES.HUBSPOT_API_KEY],
+        clientId: env[constants_1.ENVIRONMENT_VARIABLES.HUBSPOT_CLIENT_ID],
+        clientSecret: env[constants_1.ENVIRONMENT_VARIABLES.HUBSPOT_CLIENT_SECRET],
+        personalAccessKey: env[constants_1.ENVIRONMENT_VARIABLES.HUBSPOT_PERSONAL_ACCESS_KEY],
+        accountId: parseInt(env[constants_1.ENVIRONMENT_VARIABLES.HUBSPOT_ACCOUNT_ID], 10),
+        refreshToken: env[constants_1.ENVIRONMENT_VARIABLES.HUBSPOT_REFRESH_TOKEN],
+        env: getValidEnv(env[constants_1.ENVIRONMENT_VARIABLES.HUBSPOT_ENVIRONMENT]),
+    };
+}
+function loadConfigFromEnvironment() {
+    const { apiKey, clientId, clientSecret, personalAccessKey, accountId, refreshToken, env, } = getConfigVariablesFromEnv();
+    if (!accountId) {
+        (0, logger_1.debug)('environment.loadConfig.missingAccountId');
+        return null;
+    }
+    if (!env) {
+        (0, logger_1.debug)('environment.loadConfig.env');
+        return null;
+    }
+    if (personalAccessKey) {
+        return (0, configUtils_1.generateConfig)(auth_1.PERSONAL_ACCESS_KEY_AUTH_METHOD.value, {
+            accountId,
+            personalAccessKey,
+            env,
+        });
+    }
+    else if (clientId && clientSecret && refreshToken) {
+        return (0, configUtils_1.generateConfig)(auth_1.OAUTH_AUTH_METHOD.value, {
+            accountId,
+            clientId,
+            clientSecret,
+            refreshToken,
+            scopes: auth_1.OAUTH_SCOPES.map((scope) => scope.value),
+            env,
+        });
+    }
+    else if (apiKey) {
+        return (0, configUtils_1.generateConfig)(auth_1.API_KEY_AUTH_METHOD.value, {
+            accountId,
+            apiKey,
+            env,
+        });
+    }
+    (0, logger_1.debug)('environment.loadConfig.unknownAuthType');
+    return null;
+}
+exports.loadConfigFromEnvironment = loadConfigFromEnvironment;

package/constants/auth.d.ts

@@ -0,0 +1,24 @@
+export declare const API_KEY_AUTH_METHOD: {
+    readonly value: "apikey";
+    readonly name: "API Key";
+};
+export declare const OAUTH_AUTH_METHOD: {
+    readonly value: "oauth2";
+    readonly name: "OAuth2";
+};
+export declare const PERSONAL_ACCESS_KEY_AUTH_METHOD: {
+    readonly value: "personalaccesskey";
+    readonly name: "Personal Access Key";
+};
+export declare const DEFAULT_OAUTH_SCOPES: readonly ["content"];
+export declare const OAUTH_SCOPES: readonly [{
+    readonly name: "All CMS APIs, Calendar API, Email and Email Events APIs";
+    readonly value: "content";
+    readonly checked: true;
+}, {
+    readonly name: "HubDB API";
+    readonly value: "hubdb";
+}, {
+    readonly name: "File Manager API";
+    readonly value: "files";
+}];

package/constants/auth.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OAUTH_SCOPES = exports.DEFAULT_OAUTH_SCOPES = exports.PERSONAL_ACCESS_KEY_AUTH_METHOD = exports.OAUTH_AUTH_METHOD = exports.API_KEY_AUTH_METHOD = void 0;
+exports.API_KEY_AUTH_METHOD = {
+    value: 'apikey',
+    name: 'API Key',
+};
+exports.OAUTH_AUTH_METHOD = {
+    value: 'oauth2',
+    name: 'OAuth2',
+};
+exports.PERSONAL_ACCESS_KEY_AUTH_METHOD = {
+    value: 'personalaccesskey',
+    name: 'Personal Access Key',
+};
+exports.DEFAULT_OAUTH_SCOPES = ['content'];
+exports.OAUTH_SCOPES = [
+    {
+        name: 'All CMS APIs, Calendar API, Email and Email Events APIs',
+        value: 'content',
+        checked: true,
+    },
+    {
+        name: 'HubDB API',
+        value: 'hubdb',
+    },
+    {
+        name: 'File Manager API',
+        value: 'files',
+    },
+];

package/constants/config.d.ts

@@ -0,0 +1,8 @@
+export declare const DEFAULT_HUBSPOT_CONFIG_YAML_FILE_NAME = "hubspot.config.yml";
+export declare const HUBSPOT_CONFIGURATION_FOLDER = ".hubspot";
+export declare const HUBSPOT_CONFIGURATION_FILE = "config.yml";
+export declare const DEFAULT_MODES: {
+    readonly draft: "draft";
+    readonly publish: "publish";
+};
+export declare const MIN_HTTP_TIMEOUT = 3000;

package/constants/config.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MIN_HTTP_TIMEOUT = exports.DEFAULT_MODES = exports.HUBSPOT_CONFIGURATION_FILE = exports.HUBSPOT_CONFIGURATION_FOLDER = exports.DEFAULT_HUBSPOT_CONFIG_YAML_FILE_NAME = void 0;
+// NOTE this is the legacy config file name (We still need to keep it around though)
+exports.DEFAULT_HUBSPOT_CONFIG_YAML_FILE_NAME = 'hubspot.config.yml';
+exports.HUBSPOT_CONFIGURATION_FOLDER = '.hubspot';
+exports.HUBSPOT_CONFIGURATION_FILE = 'config.yml';
+exports.DEFAULT_MODES = {
+    draft: 'draft',
+    publish: 'publish',
+};
+exports.MIN_HTTP_TIMEOUT = 3000;

package/constants/environments.d.ts

@@ -0,0 +1,13 @@
+export declare const ENVIRONMENTS: {
+    readonly PROD: "prod";
+    readonly QA: "qa";
+};
+export declare const ENVIRONMENT_VARIABLES: {
+    readonly HUBSPOT_API_KEY: "HUBSPOT_API_KEY";
+    readonly HUBSPOT_CLIENT_ID: "HUBSPOT_CLIENT_ID";
+    readonly HUBSPOT_CLIENT_SECRET: "HUBSPOT_CLIENT_SECRET";
+    readonly HUBSPOT_PERSONAL_ACCESS_KEY: "HUBSPOT_PERSONAL_ACCESS_KEY";
+    readonly HUBSPOT_ACCOUNT_ID: "HUBSPOT_ACCOUNT_ID";
+    readonly HUBSPOT_REFRESH_TOKEN: "HUBSPOT_REFRESH_TOKEN";
+    readonly HUBSPOT_ENVIRONMENT: "HUBSPOT_ENVIRONMENT";
+};

package/constants/environments.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ENVIRONMENT_VARIABLES = exports.ENVIRONMENTS = void 0;
+exports.ENVIRONMENTS = {
+    PROD: 'prod',
+    QA: 'qa',
+};
+exports.ENVIRONMENT_VARIABLES = {
+    HUBSPOT_API_KEY: 'HUBSPOT_API_KEY',
+    HUBSPOT_CLIENT_ID: 'HUBSPOT_CLIENT_ID',
+    HUBSPOT_CLIENT_SECRET: 'HUBSPOT_CLIENT_SECRET',
+    HUBSPOT_PERSONAL_ACCESS_KEY: 'HUBSPOT_PERSONAL_ACCESS_KEY',
+    HUBSPOT_ACCOUNT_ID: 'HUBSPOT_ACCOUNT_ID',
+    HUBSPOT_REFRESH_TOKEN: 'HUBSPOT_REFRESH_TOKEN',
+    HUBSPOT_ENVIRONMENT: 'HUBSPOT_ENVIRONMENT',
+};

package/constants/extensions.d.ts

@@ -0,0 +1 @@
+export declare const ALLOWED_EXTENSIONS: Set<string>;

package/constants/extensions.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ALLOWED_EXTENSIONS = void 0;
+exports.ALLOWED_EXTENSIONS = new Set([
+    'css',
+    'js',
+    'json',
+    'html',
+    'txt',
+    'md',
+    'jpg',
+    'jpeg',
+    'png',
+    'gif',
+    'map',
+    'svg',
+    'eot',
+    'ttf',
+    'woff',
+    'woff2',
+    'graphql',
+]);

package/constants/index.d.ts

@@ -0,0 +1,16 @@
+export declare const ENVIRONMENTS: {
+    readonly PROD: "prod";
+    readonly QA: "qa";
+};
+export declare const ENVIRONMENT_VARIABLES: {
+    readonly HUBSPOT_API_KEY: "HUBSPOT_API_KEY";
+    readonly HUBSPOT_CLIENT_ID: "HUBSPOT_CLIENT_ID";
+    readonly HUBSPOT_CLIENT_SECRET: "HUBSPOT_CLIENT_SECRET";
+    readonly HUBSPOT_PERSONAL_ACCESS_KEY: "HUBSPOT_PERSONAL_ACCESS_KEY";
+    readonly HUBSPOT_ACCOUNT_ID: "HUBSPOT_ACCOUNT_ID";
+    readonly HUBSPOT_REFRESH_TOKEN: "HUBSPOT_REFRESH_TOKEN";
+    readonly HUBSPOT_ENVIRONMENT: "HUBSPOT_ENVIRONMENT";
+};
+export declare const DEFAULT_HUBSPOT_CONFIG_YAML_FILE_NAME = "hubspot.config.yml";
+export declare const HUBSPOT_CONFIGURATION_FOLDER = ".hubspot";
+export declare const HUBSPOT_CONFIGURATION_FILE = "config.yml";

package/constants/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HUBSPOT_CONFIGURATION_FILE = exports.HUBSPOT_CONFIGURATION_FOLDER = exports.DEFAULT_HUBSPOT_CONFIG_YAML_FILE_NAME = exports.ENVIRONMENT_VARIABLES = exports.ENVIRONMENTS = void 0;
+const environments_1 = require("./environments");
+const config_1 = require("./config");
+// Environment Variables
+exports.ENVIRONMENTS = environments_1.ENVIRONMENTS;
+exports.ENVIRONMENT_VARIABLES = environments_1.ENVIRONMENT_VARIABLES;
+// Config Variables
+exports.DEFAULT_HUBSPOT_CONFIG_YAML_FILE_NAME = config_1.DEFAULT_HUBSPOT_CONFIG_YAML_FILE_NAME;
+exports.HUBSPOT_CONFIGURATION_FOLDER = config_1.HUBSPOT_CONFIGURATION_FOLDER;
+exports.HUBSPOT_CONFIGURATION_FILE = config_1.HUBSPOT_CONFIGURATION_FILE;

package/errors/HubSpotAuthError.d.ts

@@ -0,0 +1,3 @@
+import { BaseError } from '../types/Error';
+export declare class HubSpotAuthError extends Error implements BaseError {
+}

package/errors/HubSpotAuthError.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HubSpotAuthError = void 0;
+class HubSpotAuthError extends Error {
+}
+exports.HubSpotAuthError = HubSpotAuthError;

package/errors/cmsFieldsJsErrors.d.ts

@@ -0,0 +1,9 @@
+import { ValueOf } from '../types/Utils';
+import { BaseError } from '../types/Error';
+export declare const FieldErrors: {
+    readonly IsNotFunction: "IsNotFunction";
+    readonly DoesNotReturnArray: "DoesNotReturnArray";
+};
+export declare function throwFieldsJsError(e: BaseError | ValueOf<typeof FieldErrors>, path: string, info?: {
+    returned?: string;
+}): void;

package/errors/cmsFieldsJsErrors.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.throwFieldsJsError = exports.FieldErrors = void 0;
+const standardErrors_1 = require("./standardErrors");
+const i18nKey = 'errorTypes.cmsFields';
+exports.FieldErrors = {
+    IsNotFunction: 'IsNotFunction',
+    DoesNotReturnArray: 'DoesNotReturnArray',
+};
+function throwFieldsJsError(e, path, info = {}) {
+    if (e instanceof SyntaxError ||
+        (typeof e === 'object' && e.code === 'MODULE_NOT_FOUND')) {
+        (0, standardErrors_1.throwErrorWithMessage)(`${i18nKey}.syntaxError`, { path });
+    }
+    if (e === exports.FieldErrors.IsNotFunction) {
+        (0, standardErrors_1.throwErrorWithMessage)(`${i18nKey}.notFunction`, {
+            path,
+            returned: info.returned || '',
+        });
+    }
+    if (e === exports.FieldErrors.DoesNotReturnArray) {
+        (0, standardErrors_1.throwErrorWithMessage)(`${i18nKey}.notReturnArray`, {
+            path,
+            returned: info.returned || '',
+        });
+    }
+    if (typeof e === 'object' && e.code === 'ENOENT') {
+        (0, standardErrors_1.throwErrorWithMessage)(`${i18nKey}.invalidPath`, { path });
+    }
+}
+exports.throwFieldsJsError = throwFieldsJsError;

package/errors/fileSystemErrors.d.ts

@@ -0,0 +1,2 @@
+import { BaseError, FileSystemErrorContext } from '../types/Error';
+export declare function throwFileSystemError(error: BaseError, context: FileSystemErrorContext): void;

package/errors/fileSystemErrors.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.throwFileSystemError = void 0;
+const lang_1 = require("../utils/lang");
+const standardErrors_1 = require("./standardErrors");
+const i18nKey = 'errors.errorTypes.fileSystem';
+function throwFileSystemError(error, context) {
+    (0, standardErrors_1.debugErrorAndContext)(error, context);
+    let fileAction = '';
+    if (context.read) {
+        fileAction = (0, lang_1.i18n)(`${i18nKey}.readAction`);
+    }
+    else if (context.write) {
+        fileAction = (0, lang_1.i18n)(`${i18nKey}.writeAction`);
+    }
+    else {
+        fileAction = (0, lang_1.i18n)(`${i18nKey}.otherAction`);
+    }
+    const filepath = context.filepath
+        ? `"${context.filepath}"`
+        : (0, lang_1.i18n)(`${i18nKey}.unknownFilepath`);
+    const message = [(0, lang_1.i18n)(`${i18nKey}.baseMessage`, { fileAction, filepath })];
+    // Many `fs` errors will be `SystemError`s
+    if ((0, standardErrors_1.isSystemError)(error)) {
+        message.push((0, lang_1.i18n)(`${i18nKey}.baseMessage`, { errorMessage: error.message }));
+    }
+    throw new Error(message.join(' '));
+}
+exports.throwFileSystemError = throwFileSystemError;

package/errors/standardErrors.d.ts

@@ -0,0 +1,9 @@
+import { ErrorContext } from '../types/Error';
+import { BaseError } from '../types/Error';
+export declare function isSystemError(err: BaseError): boolean;
+export declare function isFatalError(err: BaseError): boolean;
+export declare function debugErrorAndContext(error: BaseError, context?: ErrorContext): void;
+export declare function throwErrorWithMessage(identifier: string, interpolation?: {
+    [key: string]: string | number;
+}): never;
+export declare function throwError(error: BaseError, context?: ErrorContext): never;

package/errors/standardErrors.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.throwError = exports.throwErrorWithMessage = exports.debugErrorAndContext = exports.isFatalError = exports.isSystemError = void 0;
+const HubSpotAuthError_1 = require("./HubSpotAuthError");
+const logger_1 = require("../utils/logger");
+const lang_1 = require("../utils/lang");
+function isSystemError(err) {
+    return err.errno != null && err.code != null && err.syscall != null;
+}
+exports.isSystemError = isSystemError;
+function isFatalError(err) {
+    return err instanceof HubSpotAuthError_1.HubSpotAuthError;
+}
+exports.isFatalError = isFatalError;
+function debugErrorAndContext(error, context) {
+    if (error.name === 'StatusCodeError') {
+        const { statusCode, message, response } = error;
+        (0, logger_1.debug)('standardErrors.error', {
+            error: JSON.stringify({
+                statusCode,
+                message,
+                url: response.request.href,
+                method: response.request.method,
+                response: response.body,
+                headers: response.headers,
+            }),
+        });
+    }
+    else {
+        (0, logger_1.debug)('standardErrors.error', { error: JSON.stringify(error) });
+    }
+    (0, logger_1.debug)('standardErrors.context', { context: JSON.stringify(context) });
+}
+exports.debugErrorAndContext = debugErrorAndContext;
+function throwErrorWithMessage(identifier, interpolation) {
+    throw new Error((0, lang_1.i18n)(`errors.${identifier}`, interpolation));
+}
+exports.throwErrorWithMessage = throwErrorWithMessage;
+function throwSystemError(error, context) {
+    debugErrorAndContext(error, context);
+    throwErrorWithMessage('errorTypes.standard.system', {
+        message: error.message,
+    });
+}
+// formally logErrorInstance
+function throwError(error, context) {
+    debugErrorAndContext(error, context);
+    if (isSystemError(error)) {
+        throwSystemError(error, context);
+    }
+    else {
+        // Error or Error subclass
+        const name = error.name || 'Error';
+        const message = [(0, lang_1.i18n)('errors.errorTypes.standard.generic', { name })];
+        [error.message, error.reason].forEach(msg => {
+            if (msg) {
+                message.push(msg);
+            }
+        });
+        throw new Error(message.join(' '));
+    }
+}
+exports.throwError = throwError;

package/index.d.ts

@@ -0,0 +1,2 @@
+import { extractZipArchive as __extractZipArchive } from './lib/archive';
+export declare const extractZipArchive: typeof __extractZipArchive;

package/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractZipArchive = void 0;
+const archive_1 = require("./lib/archive");
+exports.extractZipArchive = archive_1.extractZipArchive;

package/lib/archive.d.ts

@@ -0,0 +1,7 @@
+/// <reference types="node" />
+type CopySourceToDestOptions = {
+    sourceDir?: string;
+    includesRootDir?: boolean;
+};
+export declare function extractZipArchive(zip: Buffer, name: string, dest: string, { sourceDir, includesRootDir }?: CopySourceToDestOptions): Promise<boolean>;
+export {};

package/lib/archive.js

@@ -0,0 +1,113 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractZipArchive = void 0;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const path_1 = require("path");
+const os_1 = require("os");
+const util_1 = require("util");
+const extract_zip_1 = __importDefault(require("extract-zip"));
+const fileSystemErrors_1 = require("../errors/fileSystemErrors");
+const standardErrors_1 = require("../errors/standardErrors");
+const logger_1 = require("../utils/logger");
+const extract = (0, util_1.promisify)(extract_zip_1.default);
+async function extractZip(name, zip) {
+    const result = { extractDir: '', tmpDir: '' };
+    const TMP_FOLDER_PREFIX = `hubspot-temp-${name}-`;
+    (0, logger_1.debug)('archive.extractZip.init');
+    // Write zip to disk
+    let tmpZipPath = '';
+    try {
+        result.tmpDir = await fs_extra_1.default.mkdtemp((0, path_1.join)((0, os_1.tmpdir)(), TMP_FOLDER_PREFIX));
+        tmpZipPath = (0, path_1.join)(result.tmpDir, 'hubspot-temp.zip');
+        await fs_extra_1.default.ensureFile(tmpZipPath);
+        await fs_extra_1.default.writeFile(tmpZipPath, zip, {
+            mode: 0o777,
+        });
+    }
+    catch (err) {
+        (0, logger_1.debug)('archive.extractZip.writeError');
+        if (tmpZipPath || result.tmpDir) {
+            (0, fileSystemErrors_1.throwFileSystemError)(err, {
+                filepath: tmpZipPath || result.tmpDir,
+                write: true,
+            });
+        }
+        else {
+            (0, standardErrors_1.throwError)(err);
+        }
+        return result;
+    }
+    // Extract zip
+    try {
+        const tmpExtractPath = (0, path_1.join)(result.tmpDir, 'extracted');
+        await extract(tmpZipPath, { dir: tmpExtractPath });
+        result.extractDir = tmpExtractPath;
+    }
+    catch (err) {
+        (0, logger_1.debug)('archive.extractZip.extractError');
+        (0, standardErrors_1.throwError)(err);
+    }
+    (0, logger_1.debug)('archive.extractZip.success');
+    return result;
+}
+async function copySourceToDest(src, dest, { sourceDir, includesRootDir = true } = {}) {
+    try {
+        (0, logger_1.debug)('archive.copySourceToDest.init');
+        const srcDirPath = [src];
+        if (includesRootDir) {
+            const files = await fs_extra_1.default.readdir(src);
+            const rootDir = files[0];
+            if (!rootDir) {
+                (0, logger_1.debug)('archive.copySourceToDest.sourceEmpty');
+                // Create the dest path if it doesn't already exist
+                fs_extra_1.default.ensureDir(dest);
+                // No root found so nothing to copy
+                return true;
+            }
+            srcDirPath.push(rootDir);
+        }
+        if (sourceDir) {
+            srcDirPath.push(sourceDir);
+        }
+        const projectSrcDir = (0, path_1.join)(...srcDirPath);
+        await fs_extra_1.default.copy(projectSrcDir, dest);
+        (0, logger_1.debug)('archive.copySourceToDest.success');
+        return true;
+    }
+    catch (err) {
+        (0, logger_1.debug)('archive.copySourceToDest.error', { dest });
+        (0, fileSystemErrors_1.throwFileSystemError)(err, {
+            filepath: dest,
+            write: true,
+        });
+    }
+    return false;
+}
+function cleanupTempDir(tmpDir) {
+    if (!tmpDir)
+        return;
+    try {
+        fs_extra_1.default.remove(tmpDir);
+    }
+    catch (e) {
+        (0, logger_1.debug)('archive.cleanupTempDir.error', { tmpDir });
+    }
+}
+async function extractZipArchive(zip, name, dest, { sourceDir, includesRootDir } = {}) {
+    let success = false;
+    if (zip) {
+        const { extractDir, tmpDir } = await extractZip(name, zip);
+        if (extractDir !== null) {
+            success = await copySourceToDest(extractDir, dest, {
+                sourceDir,
+                includesRootDir,
+            });
+        }
+        cleanupTempDir(tmpDir);
+    }
+    return success;
+}
+exports.extractZipArchive = extractZipArchive;

package/lib/path.d.ts

@@ -0,0 +1,13 @@
+/// <reference types="node" />
+import path from 'path';
+export declare function convertToUnixPath(_path: string): string;
+export declare function convertToImportPath(_path: string): string;
+export declare function convertToLocalFileSystemPath(_path: string): string;
+export declare function splitLocalPath(filepath: string, pathImplementation?: path.PlatformPath): Array<string>;
+export declare function splitHubSpotPath(filepath: string): Array<string>;
+export declare function getCwd(): string;
+export declare function getExt(filepath: string): string;
+export declare const getAllowedExtensions: () => Set<string>;
+export declare function isAllowedExtension(filepath: string): boolean;
+export declare function getAbsoluteFilePath(_path: string): string;
+export declare function isRelativePath(_path: string): boolean;

package/lib/path.js

@@ -0,0 +1,101 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isRelativePath = exports.getAbsoluteFilePath = exports.isAllowedExtension = exports.getAllowedExtensions = exports.getExt = exports.getCwd = exports.splitHubSpotPath = exports.splitLocalPath = exports.convertToLocalFileSystemPath = exports.convertToImportPath = exports.convertToUnixPath = void 0;
+const path_1 = __importDefault(require("path"));
+const unixify_1 = __importDefault(require("unixify"));
+const extensions_1 = require("../constants/extensions");
+function convertToUnixPath(_path) {
+    return (0, unixify_1.default)(path_1.default.normalize(_path));
+}
+exports.convertToUnixPath = convertToUnixPath;
+function convertToWindowsPath(_path) {
+    const rgx = new RegExp(`\\${path_1.default.posix.sep}`, 'g');
+    return path_1.default.normalize(_path).replace(rgx, path_1.default.win32.sep);
+}
+// Converts a Win32 path to Posix, retaining the drive letter (ex. 'c:')
+function convertToImportPath(_path) {
+    if (path_1.default.sep === path_1.default.win32.sep) {
+        return _path.split(path_1.default.win32.sep).join(path_1.default.posix.sep);
+    }
+    return _path;
+}
+exports.convertToImportPath = convertToImportPath;
+function convertToLocalFileSystemPath(_path) {
+    switch (path_1.default.sep) {
+        case path_1.default.posix.sep:
+            return convertToUnixPath(_path);
+        case path_1.default.win32.sep:
+            return convertToWindowsPath(_path);
+        default:
+            return path_1.default.normalize(_path);
+    }
+}
+exports.convertToLocalFileSystemPath = convertToLocalFileSystemPath;
+function removeTrailingSlashFromSplits(parts) {
+    if (parts.length > 1 && parts[parts.length - 1] === '') {
+        return parts.slice(0, parts.length - 1);
+    }
+    return parts;
+}
+// Splits a filepath for local file system sources.
+function splitLocalPath(filepath, pathImplementation = path_1.default) {
+    if (!filepath)
+        return [];
+    const { sep } = pathImplementation;
+    const rgx = new RegExp(`\\${sep}+`, 'g');
+    const parts = pathImplementation.normalize(filepath).split(rgx);
+    // Restore posix root if present
+    if (sep === path_1.default.posix.sep && parts[0] === '') {
+        parts[0] = '/';
+    }
+    return removeTrailingSlashFromSplits(parts);
+}
+exports.splitLocalPath = splitLocalPath;
+// Splits a filepath for remote sources (HubSpot).
+function splitHubSpotPath(filepath) {
+    if (!filepath)
+        return [];
+    const rgx = new RegExp(`\\${path_1.default.posix.sep}+`, 'g');
+    const parts = convertToUnixPath(filepath).split(rgx);
+    // Restore root if present
+    if (parts[0] === '') {
+        parts[0] = '/';
+    }
+    return removeTrailingSlashFromSplits(parts);
+}
+exports.splitHubSpotPath = splitHubSpotPath;
+function getCwd() {
+    if (process.env.INIT_CWD) {
+        return process.env.INIT_CWD;
+    }
+    return process.cwd();
+}
+exports.getCwd = getCwd;
+function getExt(filepath) {
+    if (typeof filepath !== 'string')
+        return '';
+    const ext = path_1.default.extname(filepath).trim().toLowerCase();
+    return ext[0] === '.' ? ext.slice(1) : ext;
+}
+exports.getExt = getExt;
+const getAllowedExtensions = () => {
+    return extensions_1.ALLOWED_EXTENSIONS;
+};
+exports.getAllowedExtensions = getAllowedExtensions;
+function isAllowedExtension(filepath) {
+    const ext = getExt(filepath);
+    const allowedExtensions = (0, exports.getAllowedExtensions)();
+    return allowedExtensions.has(ext);
+}
+exports.isAllowedExtension = isAllowedExtension;
+function getAbsoluteFilePath(_path) {
+    return path_1.default.resolve(getCwd(), _path);
+}
+exports.getAbsoluteFilePath = getAbsoluteFilePath;
+function isRelativePath(_path) {
+    return !path_1.default.isAbsolute(_path);
+}
+exports.isRelativePath = isRelativePath;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@hubspot/local-dev-lib",
-    "version": "0.0.2",
+    "version": "0.0.3",
     "description": "Provides library functionality for HubSpot local development tooling, including the HubSpot CLI",
     "main": "dist/index.js",
     "repository": {
@@ -45,9 +45,6 @@
         "ts-jest": "^29.0.5",
         "typescript": "^4.9.5"
     },
-    "files": [
-        "dist/**/*"
-    ],
     "exports": {
         ".": "./dist/lib/index.js",
         "./cms": "./dist/lib/cms",