@igstack/app-catalog-backend-core 0.5.0 → 0.6.1

package/dist/types/common/appCatalogTypes.d.mts

@@ -95,6 +95,10 @@ interface GroupingTagValue {
 interface VersionInfo {
   displayName: string;
   url?: string;
+  /** Short git SHA of the source this artifact was built from (e.g. 'a1b2c3d'). */
+  sha?: string;
+  /** Link to the commit for `sha` (e.g. a GitHub commit URL). */
+  shaUrl?: string;
 }
 interface AppVersionInfo {
   backend?: VersionInfo;

package/dist/types/common/appCatalogTypes.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"appCatalogTypes.d.mts","names":[],"sources":["../../../src/types/common/appCatalogTypes.ts"],"mappings":";;;;;;;;UAmBiB,WAAA;EACf,QAAA;EACA,WAAA;EACA,WAAA;EACA,MAAA;EACA,aAAA,GAAgB,gBAAA;AAAA;;;;;UAWD,eAAA;EACf,UAAA;EACA,GAAA;EACA,SAAA;AAAA;;;;;UAOe,QAAA;EACf,EAAA;EACA,IAAA;EAEA;EAAA,IAAA;EACA,WAAA;EACA,YAAA;EACA,SAAA;EACA,WAAA;EACA,KAAA;EACA,aAAA,GAAgB,gBAAA;EAChB,KAAA;EACA,IAAA;EACA,MAAA;EACA,KAAA;IAAU,GAAA;IAAa,KAAA;EAAA;EACvB,QAAA;EACA,aAAA;EACA,OAAA,cAAqB,eAAA;EACrB,UAAA;IAEE,0HAAA,IAAA,iCAIA;IAFA,eAAA,WAOF;IALE,OAAA;EAAA;EAWF;EARA,QAAA;EAYA;EAVA,SAAA;EAcA;EAZA,KAAA,GAAQ,WAAA;EAgBR;EAZA,UAAA;EAcQ;EAZR,IAAA;EAYc;EAVd,UAAA;EAc0B;EAZ1B,OAAA;EAaA;EAXA,eAAA;EAee;EAbf,0BAAA;;EAEA,cAAA;EAYA;EAVA,KAAA,GAAQ,MAAA;AAAA;AAAA,UAIO,WAAA;EACf,EAAA;EACA,IAAA;AAAA;AAAA,UAGe,qBAAA;EACf,MAAA;EACA,WAAA;EACA,WAAA;EACA,MAAA,EAAQ,gBAAA;AAAA;AAAA,KAGL,gBAAA,8BAA8C,CAAA,eAC/C,IAAA,CAAK,CAAA,EAAG,IAAA;AAAA,KAGA,iBAAA,GAAoB,gBAAA,CAC9B,cAAA;AAAA,UAIe,gBAAA;EACf,KAAA;EACA,WAAA;EACA,WAAA;AAAA;AAAA,UAGe,WAAA;EACf,WAAA;EACA,GAAA;AAAA;AAAA,UAGe,cAAA;EACf,OAAA,GAAU,WAAA;EACV,QAAA,GAAW,WAAA;EACX,WAAA,GAAc,WAAA;AAAA;AAAA,UAGC,cAAA;EACf,SAAA,EAAW,QAAA;EACX,eAAA,EAAiB,qBAAA;EACjB,eAAA,EAAiB,iBAAA;EACjB,OAAA,EAAS,MAAA;EACT,MAAA,EAAQ,KAAA;EACR,QAAA,GAAW,cAAA;AAAA"}
+{"version":3,"file":"appCatalogTypes.d.mts","names":[],"sources":["../../../src/types/common/appCatalogTypes.ts"],"mappings":";;;;;;;;UAmBiB,WAAA;EACf,QAAA;EACA,WAAA;EACA,WAAA;EACA,MAAA;EACA,aAAA,GAAgB,gBAAA;AAAA;;;;;UAWD,eAAA;EACf,UAAA;EACA,GAAA;EACA,SAAA;AAAA;;;;;UAOe,QAAA;EACf,EAAA;EACA,IAAA;EAEA;EAAA,IAAA;EACA,WAAA;EACA,YAAA;EACA,SAAA;EACA,WAAA;EACA,KAAA;EACA,aAAA,GAAgB,gBAAA;EAChB,KAAA;EACA,IAAA;EACA,MAAA;EACA,KAAA;IAAU,GAAA;IAAa,KAAA;EAAA;EACvB,QAAA;EACA,aAAA;EACA,OAAA,cAAqB,eAAA;EACrB,UAAA;IAEE,0HAAA,IAAA,iCAIA;IAFA,eAAA,WAOF;IALE,OAAA;EAAA;EAWF;EARA,QAAA;EAYA;EAVA,SAAA;EAcA;EAZA,KAAA,GAAQ,WAAA;EAgBR;EAZA,UAAA;EAcQ;EAZR,IAAA;EAYc;EAVd,UAAA;EAc0B;EAZ1B,OAAA;EAaA;EAXA,eAAA;EAee;EAbf,0BAAA;;EAEA,cAAA;EAYA;EAVA,KAAA,GAAQ,MAAA;AAAA;AAAA,UAIO,WAAA;EACf,EAAA;EACA,IAAA;AAAA;AAAA,UAGe,qBAAA;EACf,MAAA;EACA,WAAA;EACA,WAAA;EACA,MAAA,EAAQ,gBAAA;AAAA;AAAA,KAGL,gBAAA,8BAA8C,CAAA,eAC/C,IAAA,CAAK,CAAA,EAAG,IAAA;AAAA,KAGA,iBAAA,GAAoB,gBAAA,CAC9B,cAAA;AAAA,UAIe,gBAAA;EACf,KAAA;EACA,WAAA;EACA,WAAA;AAAA;AAAA,UAGe,WAAA;EACf,WAAA;EACA,GAAA;EAhBc;EAkBd,GAAA;EAf2B;EAiB3B,MAAA;AAAA;AAAA,UAGe,cAAA;EACf,OAAA,GAAU,WAAA;EACV,QAAA,GAAW,WAAA;EACX,WAAA,GAAc,WAAA;AAAA;AAAA,UAGC,cAAA;EACf,SAAA,EAAW,QAAA;EACX,eAAA,EAAiB,qBAAA;EACjB,eAAA,EAAiB,iBAAA;EACjB,OAAA,EAAS,MAAA;EACT,MAAA,EAAQ,KAAA;EACR,QAAA,GAAW,cAAA;AAAA"}

package/dist/utils/versionUtils.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"versionUtils.d.mts","names":[],"sources":["../../src/utils/versionUtils.ts"],"mappings":";;;;;AAQA;;iBAAgB,kBAAA,CAAA;;;AA0ChB;iBA3BgB,yBAAA,CACd,WAAA;;;;;;;iBA0Bc,cAAA,CAAe,OAAA;EAC7B,mBAAA;EACA,MAAA;AAAA,IACE,cAAA"}
+{"version":3,"file":"versionUtils.d.mts","names":[],"sources":["../../src/utils/versionUtils.ts"],"mappings":";;;;;AAQA;;iBAAgB,kBAAA,CAAA;;;;iBA0DA,yBAAA,CACd,WAAA;;;;;;;iBAWc,cAAA,CAAe,OAAA;EAC7B,mBAAA;EACA,MAAA;AAAA,IACE,cAAA"}

package/dist/utils/versionUtils.mjs

@@ -16,19 +16,44 @@ function getBuildPipelineId() {
 function getBuildPipelineUrl() {
 	return process.env.BUILD_PIPELINE_URL;
 }
+/** First 7 chars of a git SHA, or undefined when absent. */
+function shortSha(sha) {
+	return sha ? sha.slice(0, 7) : void 0;
+}
+/** Build a commit URL from a repo homepage + full/short SHA. */
+function getCommitUrl(homepage, sha) {
+	if (!homepage || !sha) return void 0;
+	return `${homepage.replace(/\/$/, "")}/commit/${sha}`;
+}
 /**
-* Gets frontend package version from node_modules
+* Reads `version`, `gitHead` (baked at publish time), and `homepage` from an
+* installed package.json under node_modules.
 */
-function getFrontendPackageVersion(packageName = "@igstack/app-catalog-frontend-core") {
+function getPackageMeta(packageName = "@igstack/app-catalog-frontend-core") {
 	try {
 		const pkgPath = join(process.cwd(), "node_modules", packageName, "package.json");
-		return JSON.parse(readFileSync(pkgPath, "utf-8")).version || null;
+		const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+		return {
+			version: pkg.version ?? null,
+			gitHead: pkg.gitHead ?? null,
+			homepage: pkg.homepage ?? null
+		};
 	} catch (error) {
-		console.warn(`[versionUtils] Failed to read frontend version from ${packageName}:`, error);
-		return null;
+		console.warn(`[versionUtils] Failed to read package meta from ${packageName}:`, error);
+		return {
+			version: null,
+			gitHead: null,
+			homepage: null
+		};
 	}
 }
 /**
+* Gets frontend package version from node_modules
+*/
+function getFrontendPackageVersion(packageName = "@igstack/app-catalog-frontend-core") {
+	return getPackageMeta(packageName).version;
+}
+/**
 * Complete helper to get both backend and frontend versions
 * Backend: reads BUILD_PIPELINE_ID and BUILD_PIPELINE_URL from environment
 * Frontend: reads version from package.json
@@ -42,8 +67,17 @@ function getVersionInfo(options) {
 		displayName: pipelineId,
 		...pipelineUrl && { url: pipelineUrl }
 	};
-	const frontendVersion = getFrontendPackageVersion(options?.frontendPackageName);
-	if (frontendVersion) versions.frontend = { displayName: frontendVersion };
+	const feMeta = getPackageMeta(options?.frontendPackageName);
+	if (feMeta.version) {
+		const sha = shortSha(feMeta.gitHead);
+		versions.frontend = {
+			displayName: feMeta.version,
+			...sha && {
+				sha,
+				shaUrl: getCommitUrl(feMeta.homepage ?? void 0, sha)
+			}
+		};
+	}
 	if (!options?.silent) {
 		console.log("=================================");
 		console.log("[Version Info]");

package/dist/utils/versionUtils.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"versionUtils.mjs","names":[],"sources":["../../src/utils/versionUtils.ts"],"sourcesContent":["import type { AppVersionInfo } from '../types/common/appCatalogTypes.js'\nimport { readFileSync } from 'node:fs'\nimport { join } from 'node:path'\n\n/**\n * Gets backend pipeline ID from environment variable\n * Use BUILD_PIPELINE_ID env var, otherwise 'local'\n */\nexport function getBuildPipelineId(): string {\n  return process.env.BUILD_PIPELINE_ID || 'local'\n}\n\n/**\n * Gets backend pipeline URL from environment variable\n * Use BUILD_PIPELINE_URL env var if available\n */\nexport function getBuildPipelineUrl(): string | undefined {\n  return process.env.BUILD_PIPELINE_URL\n}\n\n/**\n * Gets frontend package version from node_modules\n */\nexport function getFrontendPackageVersion(\n  packageName: string = '@igstack/app-catalog-frontend-core',\n): string | null {\n  try {\n    const pkgPath = join(\n      process.cwd(),\n      'node_modules',\n      packageName,\n      'package.json',\n    )\n    const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'))\n    return pkg.version || null\n  } catch (error) {\n    console.warn(\n      `[versionUtils] Failed to read frontend version from ${packageName}:`,\n      error,\n    )\n    return null\n  }\n}\n\n/**\n * Complete helper to get both backend and frontend versions\n * Backend: reads BUILD_PIPELINE_ID and BUILD_PIPELINE_URL from environment\n * Frontend: reads version from package.json\n * Logs version info to help debug CI/CD issues\n */\nexport function getVersionInfo(options?: {\n  frontendPackageName?: string\n  silent?: boolean\n}): AppVersionInfo {\n  const versions: AppVersionInfo = {}\n\n  // Backend version from environment\n  const pipelineId = getBuildPipelineId()\n  const pipelineUrl = getBuildPipelineUrl()\n\n  versions.backend = {\n    displayName: pipelineId,\n    ...(pipelineUrl && { url: pipelineUrl }),\n  }\n\n  // Frontend version from package.json\n  const frontendVersion = getFrontendPackageVersion(\n    options?.frontendPackageName,\n  )\n  if (frontendVersion) {\n    versions.frontend = { displayName: frontendVersion }\n  }\n\n  // Log for debugging CI/CD\n  if (!options?.silent) {\n    console.log('=================================')\n    console.log('[Version Info]')\n    console.log(`  Backend:  ${versions.backend.displayName}`)\n    if (versions.backend.url) {\n      console.log(`  URL:      ${versions.backend.url}`)\n    }\n    if (versions.frontend) {\n      console.log(`  Frontend: ${versions.frontend.displayName}`)\n    }\n    console.log('  Environment:')\n    console.log(\n      `    BUILD_PIPELINE_ID:  ${process.env.BUILD_PIPELINE_ID || '(not set)'}`,\n    )\n    console.log(\n      `    BUILD_PIPELINE_URL: ${process.env.BUILD_PIPELINE_URL || '(not set)'}`,\n    )\n    console.log('=================================')\n  }\n\n  return versions\n}\n"],"mappings":";;;;;;;;AAQA,SAAgB,qBAA6B;AAC3C,QAAO,QAAQ,IAAI,qBAAqB;;;;;;AAO1C,SAAgB,sBAA0C;AACxD,QAAO,QAAQ,IAAI;;;;;AAMrB,SAAgB,0BACd,cAAsB,sCACP;AACf,KAAI;EACF,MAAM,UAAU,KACd,QAAQ,KAAK,EACb,gBACA,aACA,eACD;AAED,SADY,KAAK,MAAM,aAAa,SAAS,QAAQ,CAAC,CAC3C,WAAW;UACf,OAAO;AACd,UAAQ,KACN,uDAAuD,YAAY,IACnE,MACD;AACD,SAAO;;;;;;;;;AAUX,SAAgB,eAAe,SAGZ;CACjB,MAAM,WAA2B,EAAE;CAGnC,MAAM,aAAa,oBAAoB;CACvC,MAAM,cAAc,qBAAqB;AAEzC,UAAS,UAAU;EACjB,aAAa;EACb,GAAI,eAAe,EAAE,KAAK,aAAa;EACxC;CAGD,MAAM,kBAAkB,0BACtB,SAAS,oBACV;AACD,KAAI,gBACF,UAAS,WAAW,EAAE,aAAa,iBAAiB;AAItD,KAAI,CAAC,SAAS,QAAQ;AACpB,UAAQ,IAAI,oCAAoC;AAChD,UAAQ,IAAI,iBAAiB;AAC7B,UAAQ,IAAI,eAAe,SAAS,QAAQ,cAAc;AAC1D,MAAI,SAAS,QAAQ,IACnB,SAAQ,IAAI,eAAe,SAAS,QAAQ,MAAM;AAEpD,MAAI,SAAS,SACX,SAAQ,IAAI,eAAe,SAAS,SAAS,cAAc;AAE7D,UAAQ,IAAI,iBAAiB;AAC7B,UAAQ,IACN,2BAA2B,QAAQ,IAAI,qBAAqB,cAC7D;AACD,UAAQ,IACN,2BAA2B,QAAQ,IAAI,sBAAsB,cAC9D;AACD,UAAQ,IAAI,oCAAoC;;AAGlD,QAAO"}
+{"version":3,"file":"versionUtils.mjs","names":[],"sources":["../../src/utils/versionUtils.ts"],"sourcesContent":["import type { AppVersionInfo } from '../types/common/appCatalogTypes.js'\nimport { readFileSync } from 'node:fs'\nimport { join } from 'node:path'\n\n/**\n * Gets backend pipeline ID from environment variable\n * Use BUILD_PIPELINE_ID env var, otherwise 'local'\n */\nexport function getBuildPipelineId(): string {\n  return process.env.BUILD_PIPELINE_ID || 'local'\n}\n\n/**\n * Gets backend pipeline URL from environment variable\n * Use BUILD_PIPELINE_URL env var if available\n */\nexport function getBuildPipelineUrl(): string | undefined {\n  return process.env.BUILD_PIPELINE_URL\n}\n\n/** First 7 chars of a git SHA, or undefined when absent. */\nexport function shortSha(sha?: string | null): string | undefined {\n  return sha ? sha.slice(0, 7) : undefined\n}\n\n/** Build a commit URL from a repo homepage + full/short SHA. */\nexport function getCommitUrl(\n  homepage: string | undefined,\n  sha: string | undefined,\n): string | undefined {\n  if (!homepage || !sha) return undefined\n  return `${homepage.replace(/\\/$/, '')}/commit/${sha}`\n}\n\n/**\n * Reads `version`, `gitHead` (baked at publish time), and `homepage` from an\n * installed package.json under node_modules.\n */\nexport function getPackageMeta(\n  packageName: string = '@igstack/app-catalog-frontend-core',\n): { version: string | null; gitHead: string | null; homepage: string | null } {\n  try {\n    const pkgPath = join(\n      process.cwd(),\n      'node_modules',\n      packageName,\n      'package.json',\n    )\n    const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'))\n    return {\n      version: pkg.version ?? null,\n      gitHead: pkg.gitHead ?? null,\n      homepage: pkg.homepage ?? null,\n    }\n  } catch (error) {\n    console.warn(\n      `[versionUtils] Failed to read package meta from ${packageName}:`,\n      error,\n    )\n    return { version: null, gitHead: null, homepage: null }\n  }\n}\n\n/**\n * Gets frontend package version from node_modules\n */\nexport function getFrontendPackageVersion(\n  packageName: string = '@igstack/app-catalog-frontend-core',\n): string | null {\n  return getPackageMeta(packageName).version\n}\n\n/**\n * Complete helper to get both backend and frontend versions\n * Backend: reads BUILD_PIPELINE_ID and BUILD_PIPELINE_URL from environment\n * Frontend: reads version from package.json\n * Logs version info to help debug CI/CD issues\n */\nexport function getVersionInfo(options?: {\n  frontendPackageName?: string\n  silent?: boolean\n}): AppVersionInfo {\n  const versions: AppVersionInfo = {}\n\n  // Backend version from environment\n  const pipelineId = getBuildPipelineId()\n  const pipelineUrl = getBuildPipelineUrl()\n\n  versions.backend = {\n    displayName: pipelineId,\n    ...(pipelineUrl && { url: pipelineUrl }),\n  }\n\n  // Frontend version + git SHA from package.json (SHA baked at publish time)\n  const feMeta = getPackageMeta(options?.frontendPackageName)\n  if (feMeta.version) {\n    const sha = shortSha(feMeta.gitHead)\n    versions.frontend = {\n      displayName: feMeta.version,\n      ...(sha && {\n        sha,\n        shaUrl: getCommitUrl(feMeta.homepage ?? undefined, sha),\n      }),\n    }\n  }\n\n  // Log for debugging CI/CD\n  if (!options?.silent) {\n    console.log('=================================')\n    console.log('[Version Info]')\n    console.log(`  Backend:  ${versions.backend.displayName}`)\n    if (versions.backend.url) {\n      console.log(`  URL:      ${versions.backend.url}`)\n    }\n    if (versions.frontend) {\n      console.log(`  Frontend: ${versions.frontend.displayName}`)\n    }\n    console.log('  Environment:')\n    console.log(\n      `    BUILD_PIPELINE_ID:  ${process.env.BUILD_PIPELINE_ID || '(not set)'}`,\n    )\n    console.log(\n      `    BUILD_PIPELINE_URL: ${process.env.BUILD_PIPELINE_URL || '(not set)'}`,\n    )\n    console.log('=================================')\n  }\n\n  return versions\n}\n"],"mappings":";;;;;;;;AAQA,SAAgB,qBAA6B;AAC3C,QAAO,QAAQ,IAAI,qBAAqB;;;;;;AAO1C,SAAgB,sBAA0C;AACxD,QAAO,QAAQ,IAAI;;;AAIrB,SAAgB,SAAS,KAAyC;AAChE,QAAO,MAAM,IAAI,MAAM,GAAG,EAAE,GAAG;;;AAIjC,SAAgB,aACd,UACA,KACoB;AACpB,KAAI,CAAC,YAAY,CAAC,IAAK,QAAO;AAC9B,QAAO,GAAG,SAAS,QAAQ,OAAO,GAAG,CAAC,UAAU;;;;;;AAOlD,SAAgB,eACd,cAAsB,sCACuD;AAC7E,KAAI;EACF,MAAM,UAAU,KACd,QAAQ,KAAK,EACb,gBACA,aACA,eACD;EACD,MAAM,MAAM,KAAK,MAAM,aAAa,SAAS,QAAQ,CAAC;AACtD,SAAO;GACL,SAAS,IAAI,WAAW;GACxB,SAAS,IAAI,WAAW;GACxB,UAAU,IAAI,YAAY;GAC3B;UACM,OAAO;AACd,UAAQ,KACN,mDAAmD,YAAY,IAC/D,MACD;AACD,SAAO;GAAE,SAAS;GAAM,SAAS;GAAM,UAAU;GAAM;;;;;;AAO3D,SAAgB,0BACd,cAAsB,sCACP;AACf,QAAO,eAAe,YAAY,CAAC;;;;;;;;AASrC,SAAgB,eAAe,SAGZ;CACjB,MAAM,WAA2B,EAAE;CAGnC,MAAM,aAAa,oBAAoB;CACvC,MAAM,cAAc,qBAAqB;AAEzC,UAAS,UAAU;EACjB,aAAa;EACb,GAAI,eAAe,EAAE,KAAK,aAAa;EACxC;CAGD,MAAM,SAAS,eAAe,SAAS,oBAAoB;AAC3D,KAAI,OAAO,SAAS;EAClB,MAAM,MAAM,SAAS,OAAO,QAAQ;AACpC,WAAS,WAAW;GAClB,aAAa,OAAO;GACpB,GAAI,OAAO;IACT;IACA,QAAQ,aAAa,OAAO,YAAY,QAAW,IAAI;IACxD;GACF;;AAIH,KAAI,CAAC,SAAS,QAAQ;AACpB,UAAQ,IAAI,oCAAoC;AAChD,UAAQ,IAAI,iBAAiB;AAC7B,UAAQ,IAAI,eAAe,SAAS,QAAQ,cAAc;AAC1D,MAAI,SAAS,QAAQ,IACnB,SAAQ,IAAI,eAAe,SAAS,QAAQ,MAAM;AAEpD,MAAI,SAAS,SACX,SAAQ,IAAI,eAAe,SAAS,SAAS,cAAc;AAE7D,UAAQ,IAAI,iBAAiB;AAC7B,UAAQ,IACN,2BAA2B,QAAQ,IAAI,qBAAqB,cAC7D;AACD,UAAQ,IACN,2BAA2B,QAAQ,IAAI,sBAAsB,cAC9D;AACD,UAAQ,IAAI,oCAAoC;;AAGlD,QAAO"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@igstack/app-catalog-backend-core",
-  "version": "0.5.0",
+  "version": "0.6.1",
   "description": "Backend core library for App Catalog",
   "homepage": "https://github.com/lislon/app-catalog",
   "repository": {
@@ -45,8 +45,8 @@
     "tsyringe": "^4.10.0",
     "yaml": "^2.8.0",
     "zod": "^4.3.5",
-    "@igstack/app-catalog-shared-core": "0.5.0",
-    "@igstack/app-catalog-table-sync": "0.5.0"
+    "@igstack/app-catalog-shared-core": "0.6.1",
+    "@igstack/app-catalog-table-sync": "0.6.1"
   },
   "devDependencies": {
     "@tanstack/vite-config": "^0.4.3",
@@ -73,6 +73,7 @@
   "engines": {
     "node": ">=24"
   },
+  "gitHead": "e83dc91aa65e1699c3fe578db7a62d81c4b27857",
   "scripts": {
     "build": "tsdown",
     "build:lenient": "tsdown",

package/src/__tests__/utils/versionUtils.test.ts

@@ -0,0 +1,30 @@
+import { describe, expect, it } from 'vitest'
+import { getCommitUrl, shortSha } from '../../utils/versionUtils.js'
+
+describe('shortSha', () => {
+  it('returns first 7 chars', () => {
+    expect(shortSha('abcdef1234567890')).toBe('abcdef1')
+  })
+  it('returns undefined for empty', () => {
+    expect(shortSha(undefined)).toBeUndefined()
+    expect(shortSha(null)).toBeUndefined()
+    expect(shortSha('')).toBeUndefined()
+  })
+})
+
+describe('getCommitUrl', () => {
+  it('builds a github commit url', () => {
+    expect(
+      getCommitUrl('https://github.com/lislon/app-catalog', 'abc1234'),
+    ).toBe('https://github.com/lislon/app-catalog/commit/abc1234')
+  })
+  it('strips a trailing slash from homepage', () => {
+    expect(getCommitUrl('https://github.com/lislon/app-catalog/', 'abc')).toBe(
+      'https://github.com/lislon/app-catalog/commit/abc',
+    )
+  })
+  it('returns undefined without homepage or sha', () => {
+    expect(getCommitUrl(undefined, 'abc')).toBeUndefined()
+    expect(getCommitUrl('https://x', undefined)).toBeUndefined()
+  })
+})

package/src/types/common/appCatalogTypes.ts

@@ -126,6 +126,10 @@ export interface GroupingTagValue {
 export interface VersionInfo {
   displayName: string
   url?: string
+  /** Short git SHA of the source this artifact was built from (e.g. 'a1b2c3d'). */
+  sha?: string
+  /** Link to the commit for `sha` (e.g. a GitHub commit URL). */
+  shaUrl?: string
 }
 
 export interface AppVersionInfo {

package/src/utils/versionUtils.ts

@@ -18,12 +18,27 @@ export function getBuildPipelineUrl(): string | undefined {
   return process.env.BUILD_PIPELINE_URL
 }
 
+/** First 7 chars of a git SHA, or undefined when absent. */
+export function shortSha(sha?: string | null): string | undefined {
+  return sha ? sha.slice(0, 7) : undefined
+}
+
+/** Build a commit URL from a repo homepage + full/short SHA. */
+export function getCommitUrl(
+  homepage: string | undefined,
+  sha: string | undefined,
+): string | undefined {
+  if (!homepage || !sha) return undefined
+  return `${homepage.replace(/\/$/, '')}/commit/${sha}`
+}
+
 /**
- * Gets frontend package version from node_modules
+ * Reads `version`, `gitHead` (baked at publish time), and `homepage` from an
+ * installed package.json under node_modules.
  */
-export function getFrontendPackageVersion(
+export function getPackageMeta(
   packageName: string = '@igstack/app-catalog-frontend-core',
-): string | null {
+): { version: string | null; gitHead: string | null; homepage: string | null } {
   try {
     const pkgPath = join(
       process.cwd(),
@@ -32,16 +47,29 @@ export function getFrontendPackageVersion(
       'package.json',
     )
     const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'))
-    return pkg.version || null
+    return {
+      version: pkg.version ?? null,
+      gitHead: pkg.gitHead ?? null,
+      homepage: pkg.homepage ?? null,
+    }
   } catch (error) {
     console.warn(
-      `[versionUtils] Failed to read frontend version from ${packageName}:`,
+      `[versionUtils] Failed to read package meta from ${packageName}:`,
       error,
     )
-    return null
+    return { version: null, gitHead: null, homepage: null }
   }
 }
 
+/**
+ * Gets frontend package version from node_modules
+ */
+export function getFrontendPackageVersion(
+  packageName: string = '@igstack/app-catalog-frontend-core',
+): string | null {
+  return getPackageMeta(packageName).version
+}
+
 /**
  * Complete helper to get both backend and frontend versions
  * Backend: reads BUILD_PIPELINE_ID and BUILD_PIPELINE_URL from environment
@@ -63,12 +91,17 @@ export function getVersionInfo(options?: {
     ...(pipelineUrl && { url: pipelineUrl }),
   }
 
-  // Frontend version from package.json
-  const frontendVersion = getFrontendPackageVersion(
-    options?.frontendPackageName,
-  )
-  if (frontendVersion) {
-    versions.frontend = { displayName: frontendVersion }
+  // Frontend version + git SHA from package.json (SHA baked at publish time)
+  const feMeta = getPackageMeta(options?.frontendPackageName)
+  if (feMeta.version) {
+    const sha = shortSha(feMeta.gitHead)
+    versions.frontend = {
+      displayName: feMeta.version,
+      ...(sha && {
+        sha,
+        shaUrl: getCommitUrl(feMeta.homepage ?? undefined, sha),
+      }),
+    }
   }
 
   // Log for debugging CI/CD