@hubspot/project-parsing-lib 0.23.1 → 0.23.2-beta.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@hubspot/project-parsing-lib",
-    "version": "0.23.1",
+    "version": "0.23.2-beta.0",
     "description": "Parsing library for converting projects directory structures to their intermediate representation",
     "license": "Apache-2.0",
     "type": "module",

package/src/lang/copy.d.ts

@@ -4,6 +4,7 @@ export declare const errorMessages: {
         failedToFetchSchemas: string;
         failedToFetchSchemas403: string;
         accountIdIsRequiredToFetchSchemas: string;
+        platformVersionNotAvailable: (platformVersion: string) => string;
     };
     project: {
         mustHaveAppComponent: (componentType: string) => string;

package/src/lang/copy.js

@@ -5,6 +5,7 @@ export const errorMessages = {
         failedToFetchSchemas: 'Failed to fetch component schemas',
         failedToFetchSchemas403: 'Failed to fetch component schemas. Please verify that your personal access key provides access to developer projects.',
         accountIdIsRequiredToFetchSchemas: 'Account id is required to fetch component schemas',
+        platformVersionNotAvailable: (platformVersion) => `Platform version '${platformVersion}' is not available. No component schemas are registered for it. Check the "platformVersion" field in hsproject.json.`,
     },
     project: {
         mustHaveAppComponent: (componentType) => `This '${componentType}' component must be a child of the '${APP_KEY}' component. No *-hsmeta.json files were found with type '${APP_KEY}'`,
@@ -34,7 +35,7 @@ export const errorMessages = {
         unsupportedType: (type) => `Unsupported type: ${mapToUserFacingType(type)}`,
         errorWithField: (field, error) => `${field}: ${error || 'Unknown error'}`,
         invalidJson: 'Invalid JSON',
-        permissionsNotSupported: (platformVersion) => `The "permissions" field is not supported on platform version "${platformVersion}". Upgrade to "2026.09" or later to use component-level permissions.`,
+        permissionsNotSupported: (platformVersion) => `The "permissions" field is not supported on platform version "${platformVersion}". Upgrade to "2027.03-beta" or later to use component-level permissions.`,
         unexpectedToplevelFields: (unexpectedFields) => `Unexpected top-level properties found: ${unexpectedFields}`,
         wrongDirectoryForComponent: (directory, componentType, componentMetadata, correctDir) => `The directory '${directory}' is incorrect for type '${componentType}'. ${componentMetadata.userFriendlyName} ${componentMetadata.userFriendlyTypePlural} should only be placed in the '${correctDir}' directory`,
     },

package/src/lib/migrate.js

@@ -57,12 +57,16 @@ export async function migrate(inputDir, outputDir) {
         // Write the hsmeta file to the output directory
         fs.writeFileSync(hsmetaFilePath, JSON.stringify(component, null, 2));
     });
-    const IR = await translate({
+    // translate returns { intermediateRepresentation, skippedHsMetaFiles }.
+    // Only the intermediate representation belongs in OUTPUT_IR_FILE; the hsmeta
+    // files written above are generated into supported directories, so
+    // skippedHsMetaFiles is not expected to be populated here.
+    const translateResult = await translate({
         projectSourceDir: sourceCodeOutputDir,
         platformVersion: hsProjectJson.platformVersion,
     }, { skipValidation: true });
     // Write the IR file to the output directory
-    fs.writeFileSync(path.join(outputDir, OUTPUT_IR_FILE), JSON.stringify(IR, null, 2));
+    fs.writeFileSync(path.join(outputDir, OUTPUT_IR_FILE), JSON.stringify(translateResult.intermediateRepresentation, null, 2));
 }
 function ensureDirExists(dir) {
     if (!fs.existsSync(dir)) {

package/src/lib/schemas.js

@@ -1,12 +1,9 @@
 import { http } from '@hubspot/local-dev-lib/http';
+import { isLegacyProject } from './platformVersion.js';
 import { isHubSpotHttpError, isSpecifiedError, } from '@hubspot/local-dev-lib/errors/index';
 import { errorMessages } from '../lang/copy.js';
-export async function getIntermediateRepresentationSchema(translationContext) {
-    if (!translationContext.accountId) {
-        throw new Error(errorMessages.api.accountIdIsRequiredToFetchSchemas);
-    }
+async function fetchSchemas(accountId, platformVersion) {
     try {
-        const { accountId, platformVersion } = translationContext;
         const { data } = await http.get(accountId, {
             url: `project-components-external/project-schemas/v3/${platformVersion}`,
         });
@@ -22,3 +19,17 @@ export async function getIntermediateRepresentationSchema(translationContext) {
         throw new Error(errorMessages.api.failedToFetchSchemas, { cause: e });
     }
 }
+export async function getIntermediateRepresentationSchema(translationContext) {
+    if (!translationContext.accountId) {
+        throw new Error(errorMessages.api.accountIdIsRequiredToFetchSchemas);
+    }
+    const { accountId, platformVersion } = translationContext;
+    const schemas = await fetchSchemas(accountId, platformVersion);
+    // A platform version that is not open yet has no components registered against it, so this
+    // comes back empty and every component in the project would otherwise be reported as an
+    // unsupported type. Legacy versions predate components and legitimately register none.
+    if (!isLegacyProject(platformVersion) && Object.keys(schemas).length === 0) {
+        throw new Error(errorMessages.api.platformVersionNotAvailable(platformVersion));
+    }
+    return schemas;
+}

package/src/lib/validation.js

@@ -49,7 +49,7 @@ function validateIntermediateRepresentationNode(schema, transformation, irNode,
         shouldSkipValidation = true;
     }
     if (irNode.permissions &&
-        !meetsMinimumPlatformVersion(translationContext.platformVersion, PLATFORM_VERSIONS.v2026_09_BETA)) {
+        !meetsMinimumPlatformVersion(translationContext.platformVersion, PLATFORM_VERSIONS.v2027_03_BETA)) {
         transformation.fileParseResult.errors.push(errorMessages.validation.permissionsNotSupported(translationContext.platformVersion));
     }
     if (!schema[irNode.componentType]) {