Update changelog v2.0.6

Add possibility to add custom properties to theme.properties file

CHANGELOG.md

@@ -1,3 +1,18 @@
+### **2.0.6** (2021-07-08)  
+  
+- Merge pull request #18 from asashay/add-custom-props-to-theme-properties
+
+Add possibility to add custom properties to theme.properties file  
+- add possibility to add custom properties to theme.properties file    
+  
+### **2.0.5** (2021-07-05)  
+  
+- Fix broken url for big stylesheet #16    
+  
+### **2.0.4** (2021-07-03)  
+  
+- Fix: #7    
+  
 ### **2.0.3** (2021-06-30)  
   
 - Escape double quote in ftl to js conversion #15  

package.json

@@ -1,6 +1,6 @@
 {
     "name": "keycloakify",
-    "version": "2.0.3",
+    "version": "2.0.6",
     "description": "Keycloak theme generator for Reacts app",
     "repository": {
         "type": "git",

src/bin/build-keycloak-theme/build-keycloak-theme.ts

@@ -19,6 +19,7 @@ export function main() {
     console.log("🔏 Building the keycloak theme...⌚");
 
     const extraPagesId: string[] = (parsedPackageJson as any)["keycloakify"]?.["extraPages"] ?? [];
+    const extraThemeProperties: string[] = (parsedPackageJson as any)["keycloakify"]?.["extraThemeProperties"] ?? [];
 
     generateKeycloakThemeResources({
         keycloakThemeBuildingDirPath,
@@ -55,7 +56,8 @@ export function main() {
             };
 
         })(),
-        extraPagesId
+        extraPagesId,
+        extraThemeProperties
     });
 
     const { jarFilePath } = generateJavaStackFiles({

src/bin/build-keycloak-theme/generateKeycloakThemeResources.ts

@@ -23,12 +23,13 @@ export function generateKeycloakThemeResources(
         //If urlOrigin is not undefined then it means --externals-assets
         urlOrigin: undefined | string;
         extraPagesId: string[];
+        extraThemeProperties: string[];
     }
 ) {
 
     const { 
         themeName, reactAppBuildDirPath, keycloakThemeBuildingDirPath, 
-        urlPathname, urlOrigin, extraPagesId
+        urlPathname, urlOrigin, extraPagesId, extraThemeProperties
     } = params;
 
     const themeDirPath = pathJoin(keycloakThemeBuildingDirPath, "src", "main", "resources", "theme", themeName, "login");
@@ -166,7 +167,10 @@ export function generateKeycloakThemeResources(
 
     fs.writeFileSync(
         pathJoin(themeDirPath, "theme.properties"),
-        Buffer.from("parent=keycloak", "utf8")
+        Buffer.from(
+            "parent=keycloak".concat("\n\n", extraThemeProperties.join("\n\n")),
+            "utf8"
+        )
     );
 
 }

src/bin/build-keycloak-theme/replaceImportFromStatic.ts

@@ -5,18 +5,39 @@ import { ftlValuesGlobalName } from "./ftlValuesGlobalName";
 export function replaceImportsFromStaticInJsCode(
     params: {
         jsCode: string;
-        urlOrigin: undefined | string;
+        urlOrigin: undefined | string;
     }
 ): { fixedJsCode: string; } {
 
+    /* 
+    NOTE:
+
+    When we have urlOrigin defined it means that 
+    we are building with --external-assets
+    so we have to make sur that the fixed js code will run 
+    inside and outside keycloak.
+
+    When urlOrigin isn't defined we can assume the fixedJsCode
+    will always run in keycloak context.
+    */
+
     const { jsCode, urlOrigin } = params;
 
-    const fixedJsCode = jsCode.replace(
+    const fixedJsCode =
+        jsCode
+            .replace(
                 /([a-z]+\.[a-z]+)\+"static\//g,
                 (...[, group]) =>
                     urlOrigin === undefined ?
                         `window.${ftlValuesGlobalName}.url.resourcesPath + "/build/static/` :
                         `("${ftlValuesGlobalName}" in window ? "${urlOrigin}" : "") + ${group} + "static/`
+            )
+            .replace(
+                /".chunk.css",([a-z])+=([a-z]+\.[a-z]+)\+([a-z]+),/,
+                (...[, group1, group2, group3]) =>
+                    urlOrigin === undefined ?
+                        `".chunk.css",${group1} = window.${ftlValuesGlobalName}.url.resourcesPath + "/build/" + ${group3},` :
+                        `".chunk.css",${group1} = ("${ftlValuesGlobalName}" in window ? "${urlOrigin}" : "") + ${group2} + ${group3},`
             );
 
     return { fixedJsCode };

src/lib/getKcContext/getKcContext.ts

@@ -8,9 +8,9 @@ import { deepAssign } from "../tools/deepAssign";
 
 
 export type ExtendsKcContextBase<
-	KcContextExtended extends ({ pageId: string; } | undefined)
+	KcContextExtended extends { pageId: string; }
 	> =
-	KcContextExtended extends undefined ?
+	[KcContextExtended] extends [never] ?
 	KcContextBase :
 	AndByDiscriminatingKey<
 		"pageId",
@@ -18,7 +18,7 @@ export type ExtendsKcContextBase<
 		KcContextBase
 	>;
 
-export function getKcContext<KcContextExtended extends ({ pageId: string; } | undefined) = undefined>(
+export function getKcContext<KcContextExtended extends { pageId: string; } = never>(
 	params?: {
 		mockPageId?: ExtendsKcContextBase<KcContextExtended>["pageId"];
 		mockData?: readonly DeepPartial<ExtendsKcContextBase<KcContextExtended>>[];
@@ -51,22 +51,15 @@ export function getKcContext<KcContextExtended extends ({ pageId: string; } | un
 
 		}
 
-		const kcContext: any = { "pageId": mockPageId };
+		const kcContext: any = {};
 
 		deepAssign({
 			"target": kcContext,
-			"source": kcContextCommonMock
+			"source": kcContextDefaultMock !== undefined ?
+				kcContextDefaultMock :
+				{ "pageId": mockPageId, ...kcContextCommonMock,  }
 		});
 
-		if (kcContextDefaultMock !== undefined) {
-
-			deepAssign({
-				"target": kcContext,
-				"source": kcContextDefaultMock
-			});
-
-		}
-
 		if (partialKcContextCustomMock !== undefined) {
 
 			deepAssign({

src/lib/tools/deepAssign.ts

@@ -2,6 +2,7 @@
 import { assert } from "tsafe/assert";
 import { is } from "tsafe/is";
 
+//Warning: Be mindful that because of array this is not idempotent.
 export function deepAssign(
 	params: {
 		target: Record<string, unknown>;

src/test/bin/generateKeycloakThemeResources.ts

@@ -14,6 +14,7 @@ generateKeycloakThemeResources({
     "keycloakThemeBuildingDirPath": pathJoin(sampleReactProjectDirPath, "build_keycloak_theme"),
     "urlPathname": "/keycloakify-demo-app/",
     "urlOrigin": undefined,
-    "extraPagesId": ["my-custom-page.ftl"]
+    "extraPagesId": ["my-custom-page.ftl"],
+    "extraThemeProperties": ["env=test"]
 });
 

src/test/lib/getKcContext.ts

@@ -6,37 +6,42 @@ import { same } from "evt/tools/inDepth";
 import { doExtends } from "tsafe/doExtends";
 import { assert } from "tsafe/assert";
 import { kcContextMocks, kcContextCommonMock } from "../../lib/getKcContext/kcContextMocks";
-import { deepClone } from "../../lib/tools/deepClone";
+import { deepClone } from "../../lib/tools/deepClone";
 import type { Any } from "ts-toolbelt";
 
+{
 
-const authorizedMailDomains = [
+	const authorizedMailDomains = [
 		"example.com",
 		"another-example.com",
 		"*.yet-another-example.com",
 		"*.example.com",
 		"hello-world.com"
-];
+	];
 
-const displayName = "this is an overwritten common value";
+	const displayName = "this is an overwritten common value";
 
-const aNonStandardValue = "a non standard value";
+	const aNonStandardValue1 = "a non standard value 1";
+	const aNonStandardValue2 = "a non standard value 2";
 
-type KcContextExtended = {
+	type KcContextExtended = {
 		pageId: "register.ftl";
 		authorizedMailDomains: string[];
-} | {
+	} | {
+		pageId: "info.ftl";
+		aNonStandardValue1: string;
+	} | {
 		pageId: "my-extra-page-1.ftl";
-} | {
+	} | {
 		pageId: "my-extra-page-2.ftl";
-	aNonStandardValue: string;
+		aNonStandardValue2: string;
-};
+	};
 
-function getKcContextProxy(
+	const getKcContextProxy = (
 		params: {
 			mockPageId: ExtendsKcContextBase<KcContextExtended>["pageId"];
 		}
-) {
+	) => {
 
 		const { mockPageId } = params;
 
@@ -47,33 +52,34 @@ function getKcContextProxy(
 					"pageId": "login.ftl",
 					"realm": { displayName }
 				},
+				{
+					"pageId": "info.ftl",
+					aNonStandardValue1
+				},
 				{
 					"pageId": "register.ftl",
 					authorizedMailDomains
 				},
 				{
 					"pageId": "my-extra-page-2.ftl",
-				aNonStandardValue
+					aNonStandardValue2
 				}
 			]
 		});
 
 		return { kcContext };
 
-}
+	};
 
-{
+	{
 
-	const pageId= "login.ftl";
+		const pageId = "login.ftl";
 
 		const { kcContext } = getKcContextProxy({ "mockPageId": pageId });
 
-	//@ts-expect-error
-	doExtends<Any.Equals<typeof kcContext, any>, 1>();
-
 		assert(kcContext?.pageId === pageId);
 
-	doExtends<typeof kcContext, KcContextBase.Login>();
+		doExtends<Any.Equals<typeof kcContext, KcContextBase.Login>, 1>();
 
 		assert(same(
 			//NOTE: deepClone for printIfExists or other functions...
@@ -91,19 +97,44 @@ function getKcContextProxy(
 
 		console.log(`PASS ${pageId}`);
 
-}
+	}
 
-{
+	{
+		const pageId = "info.ftl";
+
+		const { kcContext } = getKcContextProxy({ "mockPageId": pageId });
+
+		assert(kcContext?.pageId === pageId);
+
+		//NOTE: I don't understand the need to add: pageId: typeof pageId; ...
+		doExtends<Any.Equals<typeof kcContext, KcContextBase.Info & { pageId: typeof pageId; aNonStandardValue1: string; }>, 1>();
+
+		assert(same(
+			deepClone(kcContext),
+			(() => {
+
+				const mock = deepClone(kcContextMocks.find(({ pageId: pageId_i }) => pageId_i === pageId)!);
+
+				Object.assign(mock, { aNonStandardValue1 });
+
+				return mock;
+
+			})()
+		));
+
+		console.log(`PASS ${pageId}`);
+
+	}
+
+	{
 		const pageId = "register.ftl";
 
 		const { kcContext } = getKcContextProxy({ "mockPageId": pageId });
 
-	//@ts-expect-error
-	doExtends<Any.Equals<typeof kcContext, any>, 1>();
-
 		assert(kcContext?.pageId === pageId);
 
-	doExtends<typeof kcContext, KcContextBase.Register>();
+		//NOTE: I don't understand the need to add: pageId: typeof pageId; ...
+		doExtends<Any.Equals<typeof kcContext, KcContextBase.Register & { pageId: typeof pageId; authorizedMailDomains: string[]; }>, 1>();
 
 		assert(same(
 			deepClone(kcContext),
@@ -120,23 +151,19 @@ function getKcContextProxy(
 
 		console.log(`PASS ${pageId}`);
 
-}
+	}
 
-{
+	{
 
 		const pageId = "my-extra-page-2.ftl";
 
 		const { kcContext } = getKcContextProxy({ "mockPageId": pageId });
 
-	//@ts-expect-error
-	doExtends<Any.Equals<typeof kcContext, any>, 1>();
-
 		assert(kcContext?.pageId === pageId);
 
-	//@ts-expect-error
+		doExtends<Any.Equals<typeof kcContext, KcContextBase.Common & { pageId: typeof pageId; aNonStandardValue2: string; }>, 1>();
-	doExtends<typeof kcContext, KcContextBase>();
 
-	doExtends<typeof kcContext, KcContextBase.Common>();
+		kcContext.aNonStandardValue2;
 
 		assert(same(
 			deepClone(kcContext),
@@ -144,7 +171,7 @@ function getKcContextProxy(
 
 				const mock = deepClone(kcContextCommonMock);
 
-			Object.assign(mock, { pageId, aNonStandardValue });
+				Object.assign(mock, { pageId, aNonStandardValue2 });
 
 				return mock;
 
@@ -153,9 +180,9 @@ function getKcContextProxy(
 
 		console.log(`PASS ${pageId}`);
 
-}
+	}
 
-{
+	{
 
 		const pageId = "my-extra-page-1.ftl";
 
@@ -163,15 +190,10 @@ function getKcContextProxy(
 
 		const { kcContext } = getKcContextProxy({ "mockPageId": pageId });
 
-	//@ts-expect-error
-	doExtends<Any.Equals<typeof kcContext, any>, 1>();
 
 		assert(kcContext?.pageId === pageId);
 
-	//@ts-expect-error
+		doExtends<Any.Equals<typeof kcContext, KcContextBase.Common & { pageId: typeof pageId;  }>, 1>();
-	doExtends<typeof kcContext, KcContextBase>();
-
-	doExtends<typeof kcContext, KcContextBase.Common>();
 
 		assert(same(
 			deepClone(kcContext),
@@ -188,20 +210,41 @@ function getKcContextProxy(
 
 		console.log(`PASS ${pageId}`);
 
+	}
+
 }
 
 {
+
+	const pageId = "login.ftl";
+
+	const { kcContext } = getKcContext({
+		"mockPageId": pageId
+	});
+
+	doExtends<Any.Equals<typeof kcContext, KcContextBase | undefined>, 1>();
+
+	assert(same(
+		deepClone(kcContext),
+		deepClone(kcContextMocks.find(({ pageId: pageId_i }) => pageId_i === pageId)!)
+	));
+
+	console.log("PASS no extension");
+
+}
+
+
+{
+
 	const { kcContext } = getKcContext();
 
-	//@ts-expect-error
+	doExtends<Any.Equals<typeof kcContext, KcContextBase | undefined>, 1>();
-	doExtends<Any.Equals<typeof kcContext, any>, 1>();
 
-	doExtends<typeof kcContext, KcContextBase | undefined>();
+	assert(kcContext === undefined);
+
+	console.log("PASS no extension, no mock");
 
 }
 
 
 
-
-
-