@hiscovega/vundle 0.0.15 → 0.0.17

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## [0.0.17](https://github.com/griddo/vundle/compare/v0.0.16...v0.0.17) (2026-01-23)
+
+
+### Features
+
+* add griddoDeployHashPlugin to include Git commit hash in build output ([d0dbe0e](https://github.com/griddo/vundle/commit/d0dbe0ee57bb19fd199e0fdd7e4036311d3c67fd))
+
+## [0.0.16](https://github.com/griddo/vundle/compare/v0.0.15...v0.0.16) (2026-01-21)
+
 ## [0.0.15](https://github.com/griddo/griddo-bundler/compare/v0.0.14...v0.0.15) (2026-01-21)
 
 

package/README.md

@@ -8,17 +8,21 @@ Griddo vite bundler configuration for Griddo Instance projects.
 npm install @hiscovega/vundle # at @hiscovega org for the beta testing
 ```
 
-## 🚀 Publishing
+## 🚀 Usage
 
-### Automated Releases with release-it
+### Build (from a client project)
 
-This package uses [release-it](https://github.com/release-it/release-it) for automated versioning and publishing.
+Run Vite using this package config:
 
-## 🚀 Usage
+```bash
+vite build --config node_modules/@hiscovega/vundle/vite.config.mjs
+```
+
+The bundler will look for the client `vite.config.*` in the current working directory and merge it on top of the master config.
 
-### Client Configuration (vite.config.mjs)
+### Client Configuration (`vite.config.mjs`)
 
-The bundler automatically looks for a `vite.config.mjs` file in a Griddo project root. Create this file to customize the build configuration.
+Create a `vite.config.mjs` (or `.ts/.js`) in your project root to customize the build configuration.
 
 ```javascript
 // vite.config.mjs (in your project root)
@@ -26,6 +30,10 @@ export default {
   plugins: [
     // Additional Vite plugins for your project
   ],
+
+  // Standard Vite/Rollup external (advanced). It will be COMPOSED with the bundler externals.
+  // build: { rollupOptions: { external: (id) => id === "my-heavy-dep" } },
+
   griddoOptions: {
     customExternals: [
       "some-heavy-package-foo", // Mark as external by exact name
@@ -35,21 +43,50 @@ export default {
 };
 ```
 
-## Salida del bundle
+### Notes
+
+- **Mandatory externals**: React, React DOM and `@griddo/core` are always externalized by the bundler.
+- **Optional assets**: `static/` and `thumbnails/` are copied into `dist/` if they exist. If they don't exist, the build will not fail.
+
+## Bundle output
 
-El bundle exporta cuatro elementos:
+The bundle exports four artifacts:
 
 ```
-dist/index.js # Antiguo src/index.js de la instancia: templates, modules, components, contextos, etc..
-dist/builder.js # Archivos relacionados con Gatsby: antiguos builder.browser.jsx, builder.ssr.jsx y builder.config.js
-dist/griddo.config.js # Antiguo griddo.config.ts
-dist/builder.css # Todo el css de la instancia empaquetado
+dist/index.js # Legacy instance entry: templates, modules, components, contexts, etc.
+dist/builder.js # Builder-related files (legacy): builder.browser.jsx, builder.ssr.jsx and builder.config.js
+dist/griddo.config.js # Legacy griddo.config.ts
+dist/builder.css # All instance CSS bundled
 ```
 
 ```
-Para importarlos en AX / CX
+Importing in AX / CX:
 import { SiteProvider, bundle, components, formsTemplates, templates } from "<bundle>"
 import { browser, config, ssr } from "<bundle>/builder"
 import griddoConfig from "<bundle>/griddo.config"
 import "<bundle>/builder.css"
 ```
+
+## ✅ Testing
+
+```bash
+npm test
+```
+
+## 🧪 Local fixture (simple client)
+
+This repo includes a minimal client fixture under `fixtures/client/`:
+
+```bash
+npm run fixture:build
+```
+
+## 🚀 Publishing
+
+This package uses [release-it](https://github.com/release-it/release-it) for automated versioning and publishing.
+
+Tip: if you run releases in a non-interactive environment (no TTY), use:
+
+```bash
+npm run release:patch -- --ci
+```

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@hiscovega/vundle",
-	"version": "0.0.15",
+	"version": "0.0.17",
 	"description": "Master bundler configuration for Griddo Instance projects",
 	"main": "vite.config.mjs",
 	"module": "vite.config.mjs",
@@ -51,10 +51,10 @@
 		"release:patch": "release-it patch"
 	},
 	"dependencies": {
-		"@vitejs/plugin-react": "5.0.4",
-		"vite": "7.1.10",
+		"@vitejs/plugin-react": "5.1.2",
+		"vite": "7.3.1",
 		"vite-plugin-dts": "4.5.4",
-		"vite-plugin-static-copy": "3.1.4"
+		"vite-plugin-static-copy": "3.1.5"
 	},
 	"peerDependencies": {
 		"@griddo/core": "latest",

package/plugins/index.mjs

@@ -1,8 +1,72 @@
 import react from "@vitejs/plugin-react";
 // import dts from "vite-plugin-dts";
 
+import { execSync } from "node:child_process";
+import { mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
 import { viteStaticCopy } from "vite-plugin-static-copy";
 
+const griddoDeployHashPlugin = () => {
+	/** @type {import("vite").ResolvedConfig | undefined} */
+	let resolvedConfig;
+
+	const getOutputDirs = () => {
+		/** @type {string[]} */
+		const dirs = [];
+
+		const output = resolvedConfig?.build?.rollupOptions?.output;
+		const outputs = Array.isArray(output) ? output : output ? [output] : [];
+
+		for (const o of outputs) {
+			if (typeof o?.dir === "string" && o.dir) dirs.push(o.dir);
+			if (typeof o?.file === "string" && o.file) dirs.push(path.dirname(o.file));
+		}
+
+		if (dirs.length === 0) {
+			const outDir = resolvedConfig?.build?.outDir || "dist";
+			dirs.push(outDir);
+		}
+
+		return [...new Set(dirs)];
+	};
+
+	const getGitHash = () => {
+		try {
+			return execSync("git rev-parse HEAD", {
+				cwd: resolvedConfig?.root || process.cwd(),
+				stdio: ["ignore", "pipe", "ignore"],
+			})
+				.toString()
+				.trim();
+		} catch {
+			// Fallbacks típicos en CI
+			return (
+				process.env.GITHUB_SHA || process.env.VERCEL_GIT_COMMIT_SHA || process.env.CF_PAGES_COMMIT_SHA || "unknown"
+			);
+		}
+	};
+
+	return {
+		name: "griddo-deploy-hash",
+		apply: "build",
+		configResolved(config) {
+			resolvedConfig = config;
+		},
+		async closeBundle() {
+			const hash = getGitHash();
+			const outputDirs = getOutputDirs();
+
+			await Promise.all(
+				outputDirs.map(async (dir) => {
+					const absoluteDir = path.isAbsolute(dir) ? dir : path.join(resolvedConfig?.root || process.cwd(), dir);
+					await mkdir(absoluteDir, { recursive: true });
+					await writeFile(path.join(absoluteDir, "_griddo-ds-deploy-hash"), `${hash}\n`, "utf8");
+				}),
+			);
+		},
+	};
+};
+
 export const plugins = [
 	react(),
 
@@ -26,4 +90,6 @@ export const plugins = [
 			{ src: "thumbnails", dest: "" },
 		],
 	}),
+
+	griddoDeployHashPlugin(),
 ];