@hubspot/local-dev-lib 0.7.4-experimental.4 → 0.7.5-experimental.0

package/api/projects.d.ts

@@ -1,5 +1,5 @@
 import { HubSpotPromise, QueryParams } from '../types/Http.js';
-import { Project, FetchProjectResponse, UploadProjectResponse, ProjectSettings, FetchPlatformVersionResponse, WarnLogsResponse, UploadIRResponse } from '../types/Project.js';
+import { Project, FetchProjectResponse, UploadProjectResponse, ProjectSettings, FetchPlatformVersionResponse, WarnLogsResponse, UploadIRResponse, Release, FetchListReleasesResponse } from '../types/Project.js';
 import { Build, FetchProjectBuildsResponse } from '../types/Build.js';
 import { ComponentStructureResponse, ProjectComponentsMetadata } from '../types/ComponentStructure.js';
 import { Deploy, ProjectDeployResponse, ProjectDeployResponseV1 } from '../types/Deploy.js';
@@ -31,6 +31,9 @@ export declare function deleteFileFromBuild(accountId: number, projectName: stri
 export declare function cancelStagedBuild(accountId: number, projectName: string): HubSpotPromise<void>;
 export declare function fetchBuildWarnLogs(accountId: number, projectName: string, buildId: number): HubSpotPromise<WarnLogsResponse>;
 export declare function fetchDeployWarnLogs(accountId: number, projectName: string, deployId: number): HubSpotPromise<WarnLogsResponse>;
+export declare function createRelease(accountId: number, projectName: string, buildId: number): HubSpotPromise<Release>;
+export declare function listReleases(accountId: number, projectName: string, params?: QueryParams): HubSpotPromise<FetchListReleasesResponse>;
+export declare function getReleaseInfo(accountId: number, projectName: string, releaseTag: string): HubSpotPromise<Release>;
 /**
  * @deprecated
  */

package/api/projects.js

@@ -202,6 +202,23 @@ export function fetchDeployWarnLogs(accountId, projectName, deployId) {
         url: `${PROJECTS_LOGS_API_PATH}/logs/projects/${encodeURIComponent(projectName)}/deploys/${deployId}/combined/warn`,
     });
 }
+export function createRelease(accountId, projectName, buildId) {
+    return http.post(accountId, {
+        url: `${PROJECTS_API_PATH}/${encodeURIComponent(projectName)}/releases`,
+        data: { buildId },
+    });
+}
+export function listReleases(accountId, projectName, params = {}) {
+    return http.get(accountId, {
+        url: `${PROJECTS_API_PATH}/${encodeURIComponent(projectName)}/releases`,
+        params,
+    });
+}
+export function getReleaseInfo(accountId, projectName, releaseTag) {
+    return http.get(accountId, {
+        url: `${PROJECTS_API_PATH}/${encodeURIComponent(projectName)}/releases/${encodeURIComponent(releaseTag)}`,
+    });
+}
 /**
  * @deprecated
  */

package/api/sandboxHubs.d.ts

@@ -1,5 +1,8 @@
 import { SandboxPersonalAccessKey, SandboxResponse, SandboxUsageLimitsResponse, V2Sandbox } from '../types/Sandbox.js';
 import { HubSpotPromise } from '../types/Http.js';
+/**
+ * @deprecated Use createV2Sandbox instead
+ */
 export declare function createSandbox(accountId: number, name: string, type: 1 | 2): HubSpotPromise<SandboxResponse>;
 export declare function deleteSandbox(parentAccountId: number, sandboxAccountId: number): HubSpotPromise<void>;
 export declare function getSandboxUsageLimits(parentAccountId: number): HubSpotPromise<SandboxUsageLimitsResponse>;

package/api/sandboxHubs.js

@@ -2,6 +2,10 @@ import { http } from '../http/index.js';
 import { SANDBOX_TIMEOUT } from '../constants/api.js';
 const SANDBOX_API_PATH = 'sandbox-hubs/v1';
 const SANDBOX_API_PATH_V2 = 'sandbox-hubs/v2';
+/* TODO: Delete createSandbox in the next major release (as of 2/20/2026) */
+/**
+ * @deprecated Use createV2Sandbox instead
+ */
 export function createSandbox(accountId, name, type) {
     return http.post(accountId, {
         data: { name, type, generatePersonalAccessKey: true }, // For CLI, generatePersonalAccessKey will always be true since we'll be saving the entry to the config

package/api/sandboxSync.d.ts

@@ -1,4 +1,10 @@
 import { InitiateSyncResponse, FetchTypesResponse, TaskRequestData } from '../types/Sandbox.js';
 import { HubSpotPromise } from '../types/Http.js';
+/**
+ * @deprecated Sync functionality has been deprecated and will be removed in a future release.
+ */
 export declare function initiateSync(fromHubId: number, toHubId: number, tasks: Array<TaskRequestData>, sandboxHubId: number): HubSpotPromise<InitiateSyncResponse>;
+/**
+ * @deprecated
+ */
 export declare function fetchTypes(accountId: number, toHubId: number): HubSpotPromise<FetchTypesResponse>;

package/api/sandboxSync.js

@@ -1,6 +1,10 @@
 import { http } from '../http/index.js';
 import { SANDBOX_TIMEOUT } from '../constants/api.js';
 const SANDBOXES_SYNC_API_PATH = 'sandboxes-sync/v1';
+/* TODO: Delete this entire file in the next major release (as of 2/20/2026) */
+/**
+ * @deprecated Sync functionality has been deprecated and will be removed in a future release.
+ */
 export async function initiateSync(fromHubId, toHubId, tasks, sandboxHubId) {
     return http.post(fromHubId, {
         data: {
@@ -14,6 +18,9 @@ export async function initiateSync(fromHubId, toHubId, tasks, sandboxHubId) {
         url: `${SANDBOXES_SYNC_API_PATH}/tasks/initiate/async`,
     });
 }
+/**
+ * @deprecated
+ */
 export async function fetchTypes(accountId, toHubId) {
     return http.get(accountId, {
         url: `${SANDBOXES_SYNC_API_PATH}/types${toHubId ? `?toHubId=${toHubId}` : ''}`,

package/config/defaultAccountOverride.d.ts

@@ -1,4 +1,3 @@
 import { HubSpotConfigAccount } from '../types/Accounts.js';
 export declare function getDefaultAccountOverrideAccountId(accounts: Array<HubSpotConfigAccount>): number | null;
-export declare function removeDefaultAccountOverrideFile(): void;
 export declare function getDefaultAccountOverrideFilePath(): string | null;

package/config/defaultAccountOverride.js

@@ -40,21 +40,6 @@ export function getDefaultAccountOverrideAccountId(accounts) {
     }
     return account.accountId;
 }
-export function removeDefaultAccountOverrideFile() {
-    const filePath = getDefaultAccountOverrideFilePath();
-    if (!filePath) {
-        return;
-    }
-    try {
-        fs.unlinkSync(filePath);
-    }
-    catch (e) {
-        throw new FileSystemError({ cause: e }, {
-            filepath: filePath,
-            operation: 'write',
-        });
-    }
-}
 export function getDefaultAccountOverrideFilePath() {
     return findup([DEFAULT_ACCOUNT_OVERRIDE_FILE_NAME], {
         cwd: getCwd(),

package/config/index.d.ts

@@ -18,7 +18,6 @@ export declare function getConfigAccountIfExists(identifier: number | string): H
 export declare function getConfigDefaultAccount(): HubSpotConfigAccount;
 export declare function getConfigDefaultAccountIfExists(): HubSpotConfigAccount | undefined;
 export declare function getAllConfigAccounts(): HubSpotConfigAccount[];
-export declare function getLinkedOrAllConfigAccounts(): HubSpotConfigAccount[];
 export declare function getConfigAccountEnvironment(identifier: number | string): Environment;
 export declare function addConfigAccount(accountToAdd: HubSpotConfigAccount): void;
 export declare function updateConfigAccount(updatedAccount: HubSpotConfigAccount): void;

package/config/index.js

@@ -11,7 +11,6 @@ import { HubSpotConfigError } from '../models/HubSpotConfigError.js';
 import { HUBSPOT_CONFIG_ERROR_TYPES } from '../constants/config.js';
 import { isDeepEqual } from '../lib/isDeepEqual.js';
 import { getCwd } from '../lib/path.js';
-import { getHsSettingsFileIfExists } from './hsSettings.js';
 const EMPTY_CONFIG = { accounts: [] };
 export function getGlobalConfigFilePath() {
     return GLOBAL_CONFIG_PATH;
@@ -153,17 +152,11 @@ export function getConfigAccountIfExists(identifier) {
 export function getConfigDefaultAccount() {
     const { accounts, defaultAccount } = getConfig();
     let defaultAccountToUse = defaultAccount;
-    const hsSettingsFile = getHsSettingsFileIfExists();
-    if (hsSettingsFile && hsSettingsFile.localDefaultAccount) {
-        defaultAccountToUse = hsSettingsFile.localDefaultAccount;
-    }
-    else {
-        const currentConfigPath = getConfigFilePath();
-        const globalConfigPath = getGlobalConfigFilePath();
-        if (currentConfigPath === globalConfigPath && globalConfigFileExists()) {
-            const defaultAccountOverrideAccountId = getDefaultAccountOverrideAccountId(accounts);
-            defaultAccountToUse = defaultAccountOverrideAccountId || defaultAccount;
-        }
+    const currentConfigPath = getConfigFilePath();
+    const globalConfigPath = getGlobalConfigFilePath();
+    if (currentConfigPath === globalConfigPath && globalConfigFileExists()) {
+        const defaultAccountOverrideAccountId = getDefaultAccountOverrideAccountId(accounts);
+        defaultAccountToUse = defaultAccountOverrideAccountId || defaultAccount;
     }
     if (!defaultAccountToUse) {
         throw new HubSpotConfigError(i18n('config.getConfigDefaultAccount.fieldMissingError'), HUBSPOT_CONFIG_ERROR_TYPES.NO_DEFAULT_ACCOUNT, HUBSPOT_CONFIG_OPERATIONS.READ);
@@ -179,17 +172,12 @@ export function getConfigDefaultAccount() {
 export function getConfigDefaultAccountIfExists() {
     const { accounts, defaultAccount } = getConfig();
     let defaultAccountToUse = defaultAccount;
-    const hsSettingsFile = getHsSettingsFileIfExists();
-    if (hsSettingsFile && hsSettingsFile.localDefaultAccount) {
-        defaultAccountToUse = hsSettingsFile.localDefaultAccount;
-    }
-    else {
-        const currentConfigPath = getConfigFilePath();
-        const globalConfigPath = getGlobalConfigFilePath();
-        if (currentConfigPath === globalConfigPath && globalConfigFileExists()) {
-            const defaultAccountOverrideAccountId = getDefaultAccountOverrideAccountId(accounts);
-            defaultAccountToUse = defaultAccountOverrideAccountId || defaultAccount;
-        }
+    // Only check for default account override if we're using the global config
+    const currentConfigPath = getConfigFilePath();
+    const globalConfigPath = getGlobalConfigFilePath();
+    if (currentConfigPath === globalConfigPath && globalConfigFileExists()) {
+        const defaultAccountOverrideAccountId = getDefaultAccountOverrideAccountId(accounts);
+        defaultAccountToUse = defaultAccountOverrideAccountId || defaultAccount;
     }
     if (!defaultAccountToUse) {
         return;
@@ -201,14 +189,6 @@ export function getAllConfigAccounts() {
     const { accounts } = getConfig();
     return accounts;
 }
-export function getLinkedOrAllConfigAccounts() {
-    const { accounts } = getConfig();
-    const hsSettingsFile = getHsSettingsFileIfExists();
-    if (!hsSettingsFile || hsSettingsFile.accounts.length === 0) {
-        return accounts;
-    }
-    return accounts.filter(a => hsSettingsFile.accounts.includes(a.accountId));
-}
 export function getConfigAccountEnvironment(identifier) {
     const config = getConfig();
     const account = getConfigAccountByInferredIdentifier(config.accounts, identifier);

package/constants/config.d.ts

@@ -102,6 +102,3 @@ export declare const HUBSPOT_CONFIG_OPERATIONS: {
     readonly WRITE: "WRITE";
     readonly DELETE: "DELETE";
 };
-export declare const HS_FOLDER = ".hs";
-export declare const HS_SETTINGS_FILENAME = "settings.json";
-export declare const HS_README_FILENAME = "README.txt";

package/constants/config.js

@@ -105,6 +105,3 @@ export const HUBSPOT_CONFIG_OPERATIONS = {
     WRITE: 'WRITE',
     DELETE: 'DELETE',
 };
-export const HS_FOLDER = '.hs';
-export const HS_SETTINGS_FILENAME = 'settings.json';
-export const HS_README_FILENAME = 'README.txt';

package/constants/projects.d.ts

@@ -9,5 +9,6 @@ export declare const PLATFORM_VERSIONS: {
     v2025_1: string;
     v2025_2: string;
     v2026_03_beta: string;
+    v2026_03: string;
     unstable: string;
 };

package/constants/projects.js

@@ -9,5 +9,6 @@ export const PLATFORM_VERSIONS = {
     v2025_1: '2025.1',
     v2025_2: '2025.2',
     v2026_03_beta: '2026.03-beta',
+    v2026_03: '2026.03',
     unstable: 'unstable',
 };

package/lib/gitignore.d.ts

@@ -1,4 +1,3 @@
 import { GitInclusionResult } from '../types/Config.js';
 export declare function checkAndAddConfigToGitignore(configPath: string): void;
-export declare function checkAndAddHsFolderToGitignore(settingsPath: string): void;
 export declare function checkGitInclusion(configPath: string): GitInclusionResult;

package/lib/gitignore.js

@@ -1,7 +1,7 @@
 import fs from 'fs-extra';
 import path from 'path';
 import { isConfigPathInGitRepo, getGitignoreFiles, configFilenameIsIgnoredByGitignore, } from '../utils/git.js';
-import { DEFAULT_HUBSPOT_CONFIG_YAML_FILE_NAME, HS_FOLDER, } from '../constants/config.js';
+import { DEFAULT_HUBSPOT_CONFIG_YAML_FILE_NAME } from '../constants/config.js';
 import { i18n } from '../utils/lang.js';
 const i18nKey = 'lib.gitignore';
 const GITIGNORE_FILE = '.gitignore';
@@ -23,27 +23,6 @@ export function checkAndAddConfigToGitignore(configPath) {
         throw new Error(i18n(`${i18nKey}.errors.configIgnore`), { cause: e });
     }
 }
-export function checkAndAddHsFolderToGitignore(settingsPath) {
-    try {
-        const hsDirPath = path.resolve(path.dirname(settingsPath));
-        const { configIgnored, gitignoreFiles } = checkGitInclusion(hsDirPath);
-        if (configIgnored)
-            return;
-        let gitignoreFilePath = gitignoreFiles && gitignoreFiles.length ? gitignoreFiles[0] : null;
-        if (!gitignoreFilePath) {
-            gitignoreFilePath = path.join(path.dirname(hsDirPath), GITIGNORE_FILE);
-            fs.writeFileSync(gitignoreFilePath, '');
-        }
-        const gitignoreContents = fs.readFileSync(gitignoreFilePath).toString();
-        if (gitignoreContents.includes(HS_FOLDER))
-            return;
-        const updatedContents = `${gitignoreContents.trim()}\n\n# HubSpot link folder\n${HS_FOLDER}\n`;
-        fs.writeFileSync(gitignoreFilePath, updatedContents);
-    }
-    catch (e) {
-        throw new Error(i18n(`${i18nKey}.errors.configIgnore`), { cause: e });
-    }
-}
 export function checkGitInclusion(configPath) {
     const result = {
         inGit: false,

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@hubspot/local-dev-lib",
-    "version": "0.7.4-experimental.4",
+    "version": "0.7.5-experimental.0",
     "type": "module",
     "description": "Provides library functionality for HubSpot local development tooling, including the HubSpot CLI",
     "repository": {
@@ -55,7 +55,6 @@
         "./config/defaultAccountOverride": "./config/defaultAccountOverride.js",
         "./config/migrate": "./config/migrate.js",
         "./config/state": "./config/state.js",
-        "./config/hsSettings": "./config/hsSettings.js",
         "./config": "./config/index.js",
         "./constants/*": "./constants/*.js",
         "./enums/*": "./enums/*.js",

package/types/Project.d.ts

@@ -1,6 +1,8 @@
 import type { Build } from './Build.js';
 import { GithubSourceData } from './Github.js';
 import { ProjectLog } from './ProjectLog.js';
+import { ValueOf } from './Utils.js';
+import { SUBBUILD_TYPES } from '../enums/build.js';
 export type Project = {
     createdAt: number;
     deletedAt: number;
@@ -48,3 +50,22 @@ export type FetchPlatformVersionResponse = {
 export type WarnLogsResponse = {
     logs: Array<ProjectLog>;
 };
+export type Release = {
+    releaseTag: string;
+    buildId: number;
+    createdAt: string;
+    components?: Array<{
+        buildType: ValueOf<typeof SUBBUILD_TYPES>;
+        buildName?: string;
+        rootPath?: string;
+        id?: string;
+    }>;
+};
+export type FetchListReleasesResponse = {
+    results: Array<Release>;
+    paging: {
+        next: {
+            after: string;
+        };
+    };
+};

package/types/Sandbox.d.ts

@@ -138,6 +138,9 @@ export type V2Sandbox = {
     updatedAt?: string;
     updatedByUser?: User | null;
 };
+/**
+ * @deprecated This type is deprecated and will be removed in the next major release.
+ */
 export type SandboxResponse = {
     sandbox: Sandbox;
     personalAccessKey: string;
@@ -176,6 +179,9 @@ export type SandboxType = {
     groupType: string;
     syncMandatory: boolean;
 };
+/**
+ * @deprecated This type is deprecated and will be removed in the next major release.
+ */
 export type FetchTypesResponse = {
     results: Array<SandboxType>;
 };

package/config/hsSettings.d.ts

@@ -1,4 +0,0 @@
-import { HsSettingsFile } from '../types/HsSettings.js';
-export declare function getHsSettingsFilePath(): string | null;
-export declare function getHsSettingsFileIfExists(): HsSettingsFile | null;
-export declare function writeHsSettingsFile(settingsFile: HsSettingsFile): void;

package/config/hsSettings.js

@@ -1,57 +0,0 @@
-import findupSync from 'findup-sync';
-import fs from 'fs';
-import path from 'path';
-import { HS_FOLDER, HS_README_FILENAME, HS_SETTINGS_FILENAME, } from '../constants/config.js';
-import { getCwd } from '../lib/path.js';
-import { FileSystemError } from '../models/FileSystemError.js';
-const HS_README_CONTENTS = `Why do I have a folder named ".hs" in my project?
-The ".hs" folder is created when you link a directory to a HubSpot project.
-
-What does the "settings.json" file contain?
-The "settings.json" file contains:
-- The ID(s) of the HubSpot account(s) that you linked ("accounts")
-- The ID of the HubSpot account that you set as the default for this directory ("linkedDefaultAccount")
-
-Should I commit the ".hs" folder?
-No, the ".hs" folder should not be committed to version control. It is automatically added to your .gitignore file when the directory is linked.
-`;
-export function getHsSettingsFilePath() {
-    return findupSync([`${HS_FOLDER}/${HS_SETTINGS_FILENAME}`], {
-        cwd: getCwd(),
-    });
-}
-export function getHsSettingsFileIfExists() {
-    const hsSettingsFilePath = getHsSettingsFilePath();
-    if (!hsSettingsFilePath) {
-        return null;
-    }
-    let hsSettingsFile;
-    try {
-        hsSettingsFile = JSON.parse(fs.readFileSync(hsSettingsFilePath, 'utf-8'));
-    }
-    catch (e) {
-        throw new FileSystemError({ cause: e }, {
-            filepath: hsSettingsFilePath,
-            operation: 'read',
-        });
-    }
-    return hsSettingsFile;
-}
-export function writeHsSettingsFile(settingsFile) {
-    const dir = getCwd();
-    const hsFolderPath = path.join(dir, HS_FOLDER);
-    const isFirstScaffold = !fs.existsSync(hsFolderPath);
-    try {
-        fs.mkdirSync(hsFolderPath, { recursive: true });
-        fs.writeFileSync(path.join(dir, HS_FOLDER, HS_SETTINGS_FILENAME), JSON.stringify(settingsFile, null, 2), 'utf8');
-        if (isFirstScaffold) {
-            fs.writeFileSync(path.join(hsFolderPath, HS_README_FILENAME), HS_README_CONTENTS, 'utf8');
-        }
-    }
-    catch (err) {
-        throw new FileSystemError({ cause: err }, {
-            filepath: dir,
-            operation: 'write',
-        });
-    }
-}

package/types/HsSettings.d.ts

@@ -1,4 +0,0 @@
-export type HsSettingsFile = {
-    localDefaultAccount: number | undefined;
-    accounts: number[];
-};

package/types/HsSettings.js

@@ -1 +0,0 @@
-export {};