@open-mercato/shared 0.6.7-develop.6785.1.1dd7cfac55 → 0.6.7-develop.6788.1.c2a1520a30

package/build.mjs

@@ -2,6 +2,7 @@ import { readFileSync } from 'node:fs'
 import { dirname, join } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { buildPackage } from '../../scripts/build-package.mjs'
+import { buildVersionSource } from './scripts/versionSource.cjs'
 
 const packageDir = dirname(fileURLToPath(import.meta.url))
 const packageJson = JSON.parse(readFileSync(join(packageDir, 'package.json'), 'utf-8'))
@@ -12,10 +13,7 @@ const injectVersion = {
   name: 'inject-version',
   setup(build) {
     build.onLoad({ filter: /lib\/version\.ts$/ }, async () => ({
-      contents: `// Build-time generated version
-export const APP_VERSION = '${packageVersion}'
-export const appVersion = APP_VERSION
-`,
+      contents: buildVersionSource(packageVersion),
       loader: 'ts',
     }))
   },

package/dist/lib/version.js

@@ -1,4 +1,4 @@
-const APP_VERSION = "0.6.7-develop.6785.1.1dd7cfac55";
+const APP_VERSION = "0.6.7-develop.6788.1.c2a1520a30";
 const appVersion = APP_VERSION;
 export {
   APP_VERSION,

package/dist/lib/version.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/lib/version.ts"],
-  "sourcesContent": ["// Build-time generated version\nexport const APP_VERSION = '0.6.7-develop.6785.1.1dd7cfac55'\nexport const appVersion = APP_VERSION\n"],
+  "sourcesContent": ["// Build-time generated version\nexport const APP_VERSION = '0.6.7-develop.6788.1.c2a1520a30';\nexport const appVersion = APP_VERSION;\n"],
   "mappings": "AACO,MAAM,cAAc;AACpB,MAAM,aAAa;",
   "names": []
 }

package/jest.config.cjs

@@ -12,7 +12,8 @@ module.exports = {
     '^@open-mercato/core/(.*)$': '<rootDir>/../core/src/$1',
   },
   transform: {
-    '^.+\\.(t|j)sx?$': [
+    // `.cjs` is included so the build-time source emitters under scripts/ are testable.
+    '^.+\\.(cjs|(t|j)sx?)$': [
       '<rootDir>/../../scripts/jest-mikroorm-transformer.cjs',
       {
         tsconfig: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-mercato/shared",
-  "version": "0.6.7-develop.6785.1.1dd7cfac55",
+  "version": "0.6.7-develop.6788.1.c2a1520a30",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
@@ -105,7 +105,7 @@
     "@mikro-orm/core": "^7.1.5",
     "@mikro-orm/decorators": "^7.1.5",
     "@mikro-orm/postgresql": "^7.1.5",
-    "@open-mercato/cache": "0.6.7-develop.6785.1.1dd7cfac55",
+    "@open-mercato/cache": "0.6.7-develop.6788.1.c2a1520a30",
     "@types/sanitize-html": "^2.16.1",
     "dotenv": "^17.4.2",
     "pino": "^10.3.1",
@@ -119,6 +119,7 @@
     "@types/jest": "^30.0.0",
     "jest": "^30.4.2",
     "ts-jest": "^29.4.11",
+    "ts-morph": "^28.0.0",
     "typescript": "7.0.2"
   },
   "publishConfig": {

package/scripts/versionSource.cjs

@@ -0,0 +1,65 @@
+// Pure source emitter for the build-time replacement of src/lib/version.ts.
+// Kept side-effect free, and CommonJS so both build.mjs and the Jest suite can load it.
+
+const { Project, QuoteKind, ScriptKind, StructureKind, VariableDeclarationKind } = require('ts-morph')
+
+const VIRTUAL_FILE_NAME = 'version.ts'
+const BANNER = '// Build-time generated version\n'
+
+let sharedProject = null
+
+function getProject() {
+  if (!sharedProject) {
+    sharedProject = new Project({
+      useInMemoryFileSystem: true,
+      manipulationSettings: { quoteKind: QuoteKind.Single },
+    })
+  }
+
+  return sharedProject
+}
+
+function assertNoSyntacticDiagnostics(project, sourceFile) {
+  const diagnostics = project.getProgram().getSyntacticDiagnostics(sourceFile)
+  if (diagnostics.length === 0) return
+
+  const details = diagnostics
+    .map((diagnostic) => `  line ${diagnostic.getLineNumber() ?? 0}: ${diagnostic.getMessageText()}`)
+    .join('\n')
+  throw new Error(`[internal] Generated ${VIRTUAL_FILE_NAME} is not syntactically valid:\n${details}`)
+}
+
+function normalizeSourceText(text) {
+  const normalized = text.replace(/\r\n/g, '\n')
+  return normalized.endsWith('\n') ? normalized : `${normalized}\n`
+}
+
+function buildVersionSource(version) {
+  const project = getProject()
+  const sourceFile = project.createSourceFile(VIRTUAL_FILE_NAME, '', {
+    overwrite: true,
+    scriptKind: ScriptKind.TS,
+  })
+
+  sourceFile.addVariableStatement({
+    kind: StructureKind.VariableStatement,
+    isExported: true,
+    declarationKind: VariableDeclarationKind.Const,
+    declarations: [{ name: 'APP_VERSION', initializer: (writer) => writer.quote(String(version)) }],
+  })
+
+  sourceFile.addVariableStatement({
+    kind: StructureKind.VariableStatement,
+    isExported: true,
+    declarationKind: VariableDeclarationKind.Const,
+    declarations: [{ name: 'appVersion', initializer: 'APP_VERSION' }],
+  })
+
+  sourceFile.formatText({ indentSize: 2, convertTabsToSpaces: true })
+  sourceFile.insertText(0, BANNER)
+  assertNoSyntacticDiagnostics(project, sourceFile)
+
+  return normalizeSourceText(sourceFile.getFullText())
+}
+
+module.exports = { buildVersionSource }

package/src/lib/__tests__/versionSource.test.ts

@@ -0,0 +1,46 @@
+import { Project, SyntaxKind } from 'ts-morph'
+import { buildVersionSource } from '../../../scripts/versionSource.cjs'
+
+function parse(source: string) {
+  const project = new Project({ useInMemoryFileSystem: true })
+  const sourceFile = project.createSourceFile('version.ts', source, { overwrite: true })
+  return { project, sourceFile }
+}
+
+function exportedLiteral(source: string, name: string): string {
+  const { sourceFile } = parse(source)
+  return sourceFile.getVariableDeclarationOrThrow(name).getInitializerOrThrow().getText()
+}
+
+describe('buildVersionSource', () => {
+  it('exports both APP_VERSION and appVersion', () => {
+    const { sourceFile } = parse(buildVersionSource('1.2.3'))
+    expect([...sourceFile.getExportedDeclarations().keys()].sort()).toEqual(['APP_VERSION', 'appVersion'])
+  })
+
+  it('writes the supplied version as the APP_VERSION literal', () => {
+    expect(exportedLiteral(buildVersionSource('1.2.3'), 'APP_VERSION')).toBe("'1.2.3'")
+  })
+
+  it('aliases appVersion to APP_VERSION rather than repeating the literal', () => {
+    expect(exportedLiteral(buildVersionSource('1.2.3'), 'appVersion')).toBe('APP_VERSION')
+  })
+
+  it('escapes a version string that would otherwise break the literal', () => {
+    const source = buildVersionSource("0.0.0-dev'; drop")
+    const { sourceFile } = parse(source)
+    const literal = sourceFile
+      .getVariableDeclarationOrThrow('APP_VERSION')
+      .getInitializerIfKindOrThrow(SyntaxKind.StringLiteral)
+    expect(literal.getLiteralValue()).toBe("0.0.0-dev'; drop")
+  })
+
+  it('emits zero syntactic diagnostics', () => {
+    const { project, sourceFile } = parse(buildVersionSource('1.2.3'))
+    expect(project.getProgram().getSyntacticDiagnostics(sourceFile)).toEqual([])
+  })
+
+  it('keeps the build-time banner comment', () => {
+    expect(buildVersionSource('1.2.3').startsWith('// Build-time generated version\n')).toBe(true)
+  })
+})