@solidxai/core 0.1.11-beta.2 → 0.1.11-beta.5

package/dist-tests/api/authenticate.spec.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const test_1 = require("@playwright/test");
+const env_1 = require("../helpers/env");
+const baseURL = process.env.API_BASE_URL ?? "http://localhost:3000";
+const TEST_USER_EMAIL = (0, env_1.getRequiredEnv)("TEST_USER_EMAIL");
+const TEST_USER_PASSWORD = (0, env_1.getRequiredEnv)("TEST_USER_PASSWORD");
+function base64UrlDecode(input) {
+    const normalized = input.replace(/-/g, "+").replace(/_/g, "/");
+    const padded = normalized.length % 4 === 0
+        ? normalized
+        : normalized.padEnd(normalized.length + (4 - (normalized.length % 4)), "=");
+    return Buffer.from(padded, "base64").toString("utf-8");
+}
+function validateJwt(token) {
+    const parts = token.split(".");
+    if (parts.length !== 3) {
+        throw new Error("JWT must have three dot-separated parts.");
+    }
+    const headerJson = JSON.parse(base64UrlDecode(parts[0]));
+    const payloadJson = JSON.parse(base64UrlDecode(parts[1]));
+    if (!headerJson || typeof headerJson !== "object") {
+        throw new Error("JWT header must be a JSON object.");
+    }
+    if (!payloadJson || typeof payloadJson !== "object") {
+        throw new Error("JWT payload must be a JSON object.");
+    }
+    if (typeof payloadJson.exp !== "number") {
+        throw new Error("JWT payload.exp must be a number.");
+    }
+    return payloadJson;
+}
+(0, test_1.test)("API: authenticate succeeds with valid credentials", async () => {
+    const api = await test_1.request.newContext({
+        baseURL,
+        extraHTTPHeaders: {
+            accept: "*/*",
+            "content-type": "application/json",
+        },
+    });
+    try {
+        const res = await api.post("/api/iam/authenticate", {
+            data: {
+                email: TEST_USER_EMAIL,
+                username: "",
+                password: TEST_USER_PASSWORD,
+            },
+        });
+        (0, test_1.expect)(res.status()).toBe(200);
+        const json = await res.json();
+        (0, test_1.expect)(json.statusCode).toBe(200);
+        (0, test_1.expect)(Array.isArray(json.message)).toBe(true);
+        (0, test_1.expect)(json.message.length).toBe(0);
+        (0, test_1.expect)(json.error).toBe("");
+        const user = json.data?.user;
+        (0, test_1.expect)(user, "Expected data.user to be an object.").toBeTruthy();
+        (0, test_1.expect)(typeof user).toBe("object");
+        const email = user?.email;
+        (0, test_1.expect)(typeof email).toBe("string");
+        if (email === TEST_USER_EMAIL) {
+            (0, test_1.expect)(email).toBe(TEST_USER_EMAIL);
+        }
+        else {
+            (0, test_1.expect)(email.length).toBeGreaterThan(0);
+        }
+        (0, test_1.expect)(typeof user?.mobile).toBe("string");
+        (0, test_1.expect)(typeof user?.username).toBe("string");
+        (0, test_1.expect)(typeof user?.forcePasswordChange).toBe("boolean");
+        (0, test_1.expect)(typeof user?.id).toBe("number");
+        const roles = user?.roles;
+        (0, test_1.expect)(Array.isArray(roles)).toBe(true);
+        if (Array.isArray(roles)) {
+            (0, test_1.expect)(roles.every((role) => typeof role === "string")).toBe(true);
+            (0, test_1.expect)(roles).toContain("Admin");
+        }
+        const accessToken = json.data?.accessToken;
+        const refreshToken = json.data?.refreshToken;
+        (0, test_1.expect)(typeof accessToken).toBe("string");
+        (0, test_1.expect)(typeof refreshToken).toBe("string");
+        const accessPayload = validateJwt(accessToken);
+        const refreshPayload = validateJwt(refreshToken);
+        (0, test_1.expect)(typeof accessPayload.exp).toBe("number");
+        (0, test_1.expect)(typeof refreshPayload.exp).toBe("number");
+    }
+    finally {
+        await api.dispose();
+    }
+});
+(0, test_1.test)("API: authenticate fails with wrong password", async () => {
+    const api = await test_1.request.newContext({
+        baseURL,
+        extraHTTPHeaders: {
+            accept: "*/*",
+            "content-type": "application/json",
+        },
+    });
+    try {
+        const res = await api.post("/api/iam/authenticate", {
+            data: {
+                email: TEST_USER_EMAIL,
+                username: "",
+                password: `${TEST_USER_PASSWORD}__wrong`,
+            },
+        });
+        (0, test_1.expect)(res.status()).toBe(401);
+        const json = await res.json();
+        (0, test_1.expect)(json.statusCode).toBe(401);
+        (0, test_1.expect)(json.statusCodeMessage).toBe("Unauthorized");
+        (0, test_1.expect)(json.message).toBe("Invalid credentials");
+        (0, test_1.expect)(json.error).toBe("Invalid credentials");
+        (0, test_1.expect)(json.data?.statusCode).toBe(401);
+        (0, test_1.expect)(json.data?.error).toBe("Unauthorized");
+        (0, test_1.expect)(json.data?.message).toBe("Invalid credentials");
+    }
+    finally {
+        await api.dispose();
+    }
+});
+//# sourceMappingURL=authenticate.spec.js.map

package/dist-tests/api/authenticate.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authenticate.spec.js","sourceRoot":"","sources":["../../tests/api/authenticate.spec.ts"],"names":[],"mappings":"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","sourcesContent":["import { expect, request, test } from \"@playwright/test\";\nimport { getRequiredEnv } from \"../helpers/env\";\n\ntype JwtPayload = {\n  exp?: number;\n  [key: string]: unknown;\n};\n\nconst baseURL = process.env.API_BASE_URL ?? \"http://localhost:3000\";\nconst TEST_USER_EMAIL = getRequiredEnv(\"TEST_USER_EMAIL\");\nconst TEST_USER_PASSWORD = getRequiredEnv(\"TEST_USER_PASSWORD\");\n\nfunction base64UrlDecode(input: string): string {\n  const normalized = input.replace(/-/g, \"+\").replace(/_/g, \"/\");\n  const padded =\n    normalized.length % 4 === 0\n      ? normalized\n      : normalized.padEnd(\n        normalized.length + (4 - (normalized.length % 4)),\n        \"=\"\n      );\n  return Buffer.from(padded, \"base64\").toString(\"utf-8\");\n}\n\nfunction validateJwt(token: string): JwtPayload {\n  const parts = token.split(\".\");\n  if (parts.length !== 3) {\n    throw new Error(\"JWT must have three dot-separated parts.\");\n  }\n\n  const headerJson = JSON.parse(base64UrlDecode(parts[0]));\n  const payloadJson = JSON.parse(base64UrlDecode(parts[1]));\n\n  if (!headerJson || typeof headerJson !== \"object\") {\n    throw new Error(\"JWT header must be a JSON object.\");\n  }\n\n  if (!payloadJson || typeof payloadJson !== \"object\") {\n    throw new Error(\"JWT payload must be a JSON object.\");\n  }\n\n  if (typeof payloadJson.exp !== \"number\") {\n    throw new Error(\"JWT payload.exp must be a number.\");\n  }\n\n  return payloadJson as JwtPayload;\n}\n\ntest(\"API: authenticate succeeds with valid credentials\", async () => {\n  const api = await request.newContext({\n    baseURL,\n    extraHTTPHeaders: {\n      accept: \"*/*\",\n      \"content-type\": \"application/json\",\n    },\n  });\n\n  try {\n    const res = await api.post(\"/api/iam/authenticate\", {\n      data: {\n        email: TEST_USER_EMAIL,\n        username: \"\",\n        password: TEST_USER_PASSWORD,\n      },\n    });\n\n    expect(res.status()).toBe(200);\n    const json = await res.json();\n\n    expect(json.statusCode).toBe(200);\n    expect(Array.isArray(json.message)).toBe(true);\n    expect(json.message.length).toBe(0);\n    expect(json.error).toBe(\"\");\n\n    const user = json.data?.user as Record<string, unknown> | undefined;\n    expect(user, \"Expected data.user to be an object.\").toBeTruthy();\n    expect(typeof user).toBe(\"object\");\n\n    const email = user?.email;\n    expect(typeof email).toBe(\"string\");\n    if (email === TEST_USER_EMAIL) {\n      expect(email).toBe(TEST_USER_EMAIL);\n    } else {\n      // If your API returns a fixed system email, replace this with an exact match.\n      expect((email as string).length).toBeGreaterThan(0);\n    }\n\n    expect(typeof user?.mobile).toBe(\"string\");\n    expect(typeof user?.username).toBe(\"string\");\n    expect(typeof user?.forcePasswordChange).toBe(\"boolean\");\n    expect(typeof user?.id).toBe(\"number\");\n\n    const roles = user?.roles;\n    expect(Array.isArray(roles)).toBe(true);\n    if (Array.isArray(roles)) {\n      expect(roles.every((role) => typeof role === \"string\")).toBe(true);\n      expect(roles).toContain(\"Admin\");\n    }\n\n    const accessToken = json.data?.accessToken;\n    const refreshToken = json.data?.refreshToken;\n    expect(typeof accessToken).toBe(\"string\");\n    expect(typeof refreshToken).toBe(\"string\");\n\n    const accessPayload = validateJwt(accessToken as string);\n    const refreshPayload = validateJwt(refreshToken as string);\n\n    expect(typeof accessPayload.exp).toBe(\"number\");\n    expect(typeof refreshPayload.exp).toBe(\"number\");\n  } finally {\n    await api.dispose();\n  }\n});\n\ntest(\"API: authenticate fails with wrong password\", async () => {\n  const api = await request.newContext({\n    baseURL,\n    extraHTTPHeaders: {\n      accept: \"*/*\",\n      \"content-type\": \"application/json\",\n    },\n  });\n\n  try {\n    const res = await api.post(\"/api/iam/authenticate\", {\n      data: {\n        email: TEST_USER_EMAIL,\n        username: \"\",\n        password: `${TEST_USER_PASSWORD}__wrong`,\n      },\n    });\n\n    expect(res.status()).toBe(401);\n    const json = await res.json();\n\n    expect(json.statusCode).toBe(401);\n    expect(json.statusCodeMessage).toBe(\"Unauthorized\");\n    expect(json.message).toBe(\"Invalid credentials\");\n    expect(json.error).toBe(\"Invalid credentials\");\n    expect(json.data?.statusCode).toBe(401);\n    expect(json.data?.error).toBe(\"Unauthorized\");\n    expect(json.data?.message).toBe(\"Invalid credentials\");\n  } finally {\n    await api.dispose();\n  }\n});\n"]}

package/dist-tests/api/crud-service.findOne.cityMaster.spec.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const test_1 = require("@playwright/test");
+const auth_1 = require("../helpers/auth");
+const baseURL = process.env.API_BASE_URL ?? "http://localhost:3000";
+async function getCityByName(name) {
+    const api = await test_1.request.newContext({
+        baseURL,
+        extraHTTPHeaders: await (0, auth_1.getAuthHeaders)(baseURL),
+    });
+    try {
+        const res = await api.get(`/api/city-master?filters[name][$eq]=${encodeURIComponent(name)}&limit=1&offset=0`);
+        (0, test_1.expect)(res.status()).toBe(200);
+        const json = await res.json();
+        const record = json?.data?.records?.[0];
+        (0, test_1.expect)(record, `Expected city '${name}' in testData`).toBeTruthy();
+        (0, test_1.expect)(record.id, "Expected record to have id").toBeTruthy();
+        return record;
+    }
+    finally {
+        await api.dispose();
+    }
+}
+test_1.test.describe("CRUDService.findOne (cityMaster)", () => {
+    (0, test_1.test)("returns a city by id", async () => {
+        const city = await getCityByName("Mumbai");
+        const api = await test_1.request.newContext({
+            baseURL,
+            extraHTTPHeaders: await (0, auth_1.getAuthHeaders)(baseURL),
+        });
+        try {
+            const res = await api.get(`/api/city-master/${city.id}`);
+            (0, test_1.expect)(res.status()).toBe(200);
+            const json = await res.json();
+            (0, test_1.expect)(json?.data?.id).toBe(city.id);
+            (0, test_1.expect)(json?.data?.name).toBe("Mumbai");
+            (0, test_1.expect)(json?.data?.description).toBe("Mumbai city");
+        }
+        finally {
+            await api.dispose();
+        }
+    });
+    (0, test_1.test)("supports fields[] selection", async () => {
+        const city = await getCityByName("Pune");
+        const api = await test_1.request.newContext({
+            baseURL,
+            extraHTTPHeaders: await (0, auth_1.getAuthHeaders)(baseURL),
+        });
+        try {
+            const res = await api.get(`/api/city-master/${city.id}?fields[]=id&fields[]=name`);
+            (0, test_1.expect)(res.status()).toBe(200);
+            const json = await res.json();
+            (0, test_1.expect)(json?.data?.id).toBe(city.id);
+            (0, test_1.expect)(json?.data?.name).toBe("Pune");
+            (0, test_1.expect)(json?.data?.description).toBeUndefined();
+            (0, test_1.expect)(json?.data?.state).toBeUndefined();
+        }
+        finally {
+            await api.dispose();
+        }
+    });
+    (0, test_1.test)("supports populate=state", async () => {
+        const city = await getCityByName("Bengaluru");
+        const api = await test_1.request.newContext({
+            baseURL,
+            extraHTTPHeaders: await (0, auth_1.getAuthHeaders)(baseURL),
+        });
+        try {
+            const res = await api.get(`/api/city-master/${city.id}?populate=state`);
+            (0, test_1.expect)(res.status()).toBe(200);
+            const json = await res.json();
+            (0, test_1.expect)(json?.data?.name).toBe("Bengaluru");
+            (0, test_1.expect)(json?.data?.state).toBeTruthy();
+            (0, test_1.expect)(json?.data?.state?.name).toBe("Karnataka");
+        }
+        finally {
+            await api.dispose();
+        }
+    });
+    (0, test_1.test)("returns 404 for missing id", async () => {
+        const api = await test_1.request.newContext({
+            baseURL,
+            extraHTTPHeaders: await (0, auth_1.getAuthHeaders)(baseURL),
+        });
+        try {
+            const res = await api.get(`/api/city-master/99999999`);
+            (0, test_1.expect)(res.status()).toBe(404);
+            const json = await res.json();
+            (0, test_1.expect)(String(json?.message)).toContain("cityMaster");
+            (0, test_1.expect)(String(json?.message)).toContain("not found");
+        }
+        finally {
+            await api.dispose();
+        }
+    });
+});
+//# sourceMappingURL=crud-service.findOne.cityMaster.spec.js.map

package/dist-tests/api/crud-service.findOne.cityMaster.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crud-service.findOne.cityMaster.spec.js","sourceRoot":"","sources":["../../tests/api/crud-service.findOne.cityMaster.spec.ts"],"names":[],"mappings":"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","sourcesContent":["import { expect, request, test } from \"@playwright/test\";\nimport { getAuthHeaders } from \"../helpers/auth\";\n\nconst baseURL = process.env.API_BASE_URL ?? \"http://localhost:3000\";\n\nasync function getCityByName(name: string) {\n  const api = await request.newContext({\n    baseURL,\n    extraHTTPHeaders: await getAuthHeaders(baseURL),\n  });\n  try {\n    const res = await api.get(\n      `/api/city-master?filters[name][$eq]=${encodeURIComponent(name)}&limit=1&offset=0`\n    );\n    expect(res.status()).toBe(200);\n    const json = await res.json();\n\n    const record = json?.data?.records?.[0];\n    expect(record, `Expected city '${name}' in testData`).toBeTruthy();\n    expect(record.id, \"Expected record to have id\").toBeTruthy();\n\n    return record;\n  } finally {\n    await api.dispose();\n  }\n}\n\ntest.describe(\"CRUDService.findOne (cityMaster)\", () => {\n  test(\"returns a city by id\", async () => {\n    const city = await getCityByName(\"Mumbai\");\n\n    const api = await request.newContext({\n      baseURL,\n      extraHTTPHeaders: await getAuthHeaders(baseURL),\n    });\n    try {\n      const res = await api.get(`/api/city-master/${city.id}`);\n      expect(res.status()).toBe(200);\n\n      const json = await res.json();\n      expect(json?.data?.id).toBe(city.id);\n      expect(json?.data?.name).toBe(\"Mumbai\");\n      expect(json?.data?.description).toBe(\"Mumbai city\");\n    } finally {\n      await api.dispose();\n    }\n  });\n\n  test(\"supports fields[] selection\", async () => {\n    const city = await getCityByName(\"Pune\");\n\n    const api = await request.newContext({\n      baseURL,\n      extraHTTPHeaders: await getAuthHeaders(baseURL),\n    });\n    try {\n      const res = await api.get(\n        `/api/city-master/${city.id}?fields[]=id&fields[]=name`\n      );\n      expect(res.status()).toBe(200);\n\n      const json = await res.json();\n      expect(json?.data?.id).toBe(city.id);\n      expect(json?.data?.name).toBe(\"Pune\");\n      expect(json?.data?.description).toBeUndefined();\n      expect(json?.data?.state).toBeUndefined();\n    } finally {\n      await api.dispose();\n    }\n  });\n\n  test(\"supports populate=state\", async () => {\n    const city = await getCityByName(\"Bengaluru\");\n\n    const api = await request.newContext({\n      baseURL,\n      extraHTTPHeaders: await getAuthHeaders(baseURL),\n    });\n    try {\n      const res = await api.get(`/api/city-master/${city.id}?populate=state`);\n      expect(res.status()).toBe(200);\n\n      const json = await res.json();\n      expect(json?.data?.name).toBe(\"Bengaluru\");\n      expect(json?.data?.state).toBeTruthy();\n      expect(json?.data?.state?.name).toBe(\"Karnataka\");\n    } finally {\n      await api.dispose();\n    }\n  });\n\n  test(\"returns 404 for missing id\", async () => {\n    const api = await request.newContext({\n      baseURL,\n      extraHTTPHeaders: await getAuthHeaders(baseURL),\n    });\n    try {\n      const res = await api.get(`/api/city-master/99999999`);\n      expect(res.status()).toBe(404);\n\n      const json = await res.json();\n      expect(String(json?.message)).toContain(\"cityMaster\");\n      expect(String(json?.message)).toContain(\"not found\");\n    } finally {\n      await api.dispose();\n    }\n  });\n});\n"]}

package/dist-tests/api/ping.spec.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const test_1 = require("@playwright/test");
+(0, test_1.test)("GET /api/ping returns pong", async () => {
+    const baseURL = process.env.BASE_URL || "http://localhost:3000";
+    if (!baseURL) {
+        throw new Error("baseURL is not configured. Set API_BASE_URL or use the default.");
+    }
+    const api = await test_1.request.newContext({ baseURL });
+    const res = await api.get("/api/ping");
+    (0, test_1.expect)(res.status()).toBe(200);
+    const body = await res.json();
+    (0, test_1.expect)(body).toEqual({
+        statusCode: 200,
+        message: [],
+        error: "",
+        data: { pong: "v1.0.2" },
+    });
+    await api.dispose();
+});
+//# sourceMappingURL=ping.spec.js.map

package/dist-tests/api/ping.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ping.spec.js","sourceRoot":"","sources":["../../tests/api/ping.spec.ts"],"names":[],"mappings":";;AAAA,2CAAyD;AAEzD,IAAA,WAAI,EAAC,4BAA4B,EAAE,KAAK,IAAI,EAAE;IAC5C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,uBAAuB,CAAC;IAChE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;IACrF,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,cAAO,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IAElD,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAEvC,IAAA,aAAM,EAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAE/B,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAA,aAAM,EAAC,IAAI,CAAC,CAAC,OAAO,CAAC;QACnB,UAAU,EAAE,GAAG;QACf,OAAO,EAAE,EAAE;QACX,KAAK,EAAE,EAAE;QACT,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KACzB,CAAC,CAAC;IAEH,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;AACtB,CAAC,CAAC,CAAC","sourcesContent":["import { expect, request, test } from \"@playwright/test\";\n\ntest(\"GET /api/ping returns pong\", async () => {\n  const baseURL = process.env.BASE_URL || \"http://localhost:3000\";\n  if (!baseURL) {\n    throw new Error(\"baseURL is not configured. Set API_BASE_URL or use the default.\");\n  }\n  const api = await request.newContext({ baseURL });\n\n  const res = await api.get(\"/api/ping\");\n\n  expect(res.status()).toBe(200);\n\n  const body = await res.json();\n  expect(body).toEqual({\n    statusCode: 200,\n    message: [],\n    error: \"\",\n    data: { pong: \"v1.0.2\" },\n  });\n\n  await api.dispose();\n});\n"]}

package/dist-tests/helpers/auth.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAccessToken = getAccessToken;
+exports.getAuthHeaders = getAuthHeaders;
+const test_1 = require("@playwright/test");
+const env_1 = require("./env");
+async function getAccessToken(baseURL) {
+    const TEST_USER_EMAIL = (0, env_1.getRequiredEnv)("TEST_USER_EMAIL");
+    const TEST_USER_PASSWORD = (0, env_1.getRequiredEnv)("TEST_USER_PASSWORD");
+    const api = await test_1.request.newContext({
+        baseURL,
+        extraHTTPHeaders: {
+            accept: "*/*",
+            "content-type": "application/json",
+        },
+    });
+    try {
+        const res = await api.post("/api/iam/authenticate", {
+            data: {
+                email: TEST_USER_EMAIL,
+                username: "",
+                password: TEST_USER_PASSWORD,
+            },
+        });
+        (0, test_1.expect)(res.status()).toBe(200);
+        const json = await res.json();
+        const token = json?.data?.accessToken;
+        (0, test_1.expect)(token, "Expected access token from authenticate endpoint.").toBeTruthy();
+        return token;
+    }
+    finally {
+        await api.dispose();
+    }
+}
+async function getAuthHeaders(baseURL) {
+    const token = await getAccessToken(baseURL);
+    return {
+        authorization: `Bearer ${token}`,
+    };
+}
+//# sourceMappingURL=auth.js.map

package/dist-tests/helpers/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../tests/helpers/auth.ts"],"names":[],"mappings":";;AAGA,wCA6BC;AAED,wCAKC;AAvCD,2CAAmD;AACnD,+BAAuC;AAEhC,KAAK,UAAU,cAAc,CAAC,OAAe;IAClD,MAAM,eAAe,GAAG,IAAA,oBAAc,EAAC,iBAAiB,CAAC,CAAC;IAC1D,MAAM,kBAAkB,GAAG,IAAA,oBAAc,EAAC,oBAAoB,CAAC,CAAC;IAEhE,MAAM,GAAG,GAAG,MAAM,cAAO,CAAC,UAAU,CAAC;QACnC,OAAO;QACP,gBAAgB,EAAE;YAChB,MAAM,EAAE,KAAK;YACb,cAAc,EAAE,kBAAkB;SACnC;KACF,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,uBAAuB,EAAE;YAClD,IAAI,EAAE;gBACJ,KAAK,EAAE,eAAe;gBACtB,QAAQ,EAAE,EAAE;gBACZ,QAAQ,EAAE,kBAAkB;aAC7B;SACF,CAAC,CAAC;QAEH,IAAA,aAAM,EAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/B,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,IAAI,EAAE,IAAI,EAAE,WAAiC,CAAC;QAC5D,IAAA,aAAM,EAAC,KAAK,EAAE,mDAAmD,CAAC,CAAC,UAAU,EAAE,CAAC;QAChF,OAAO,KAAe,CAAC;IACzB,CAAC;YAAS,CAAC;QACT,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;IACtB,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,cAAc,CAAC,OAAe;IAClD,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;IAC5C,OAAO;QACL,aAAa,EAAE,UAAU,KAAK,EAAE;KACjC,CAAC;AACJ,CAAC","sourcesContent":["import { expect, request } from \"@playwright/test\";\nimport { getRequiredEnv } from \"./env\";\n\nexport async function getAccessToken(baseURL: string) {\n  const TEST_USER_EMAIL = getRequiredEnv(\"TEST_USER_EMAIL\");\n  const TEST_USER_PASSWORD = getRequiredEnv(\"TEST_USER_PASSWORD\");\n\n  const api = await request.newContext({\n    baseURL,\n    extraHTTPHeaders: {\n      accept: \"*/*\",\n      \"content-type\": \"application/json\",\n    },\n  });\n\n  try {\n    const res = await api.post(\"/api/iam/authenticate\", {\n      data: {\n        email: TEST_USER_EMAIL,\n        username: \"\",\n        password: TEST_USER_PASSWORD,\n      },\n    });\n\n    expect(res.status()).toBe(200);\n    const json = await res.json();\n    const token = json?.data?.accessToken as string | undefined;\n    expect(token, \"Expected access token from authenticate endpoint.\").toBeTruthy();\n    return token as string;\n  } finally {\n    await api.dispose();\n  }\n}\n\nexport async function getAuthHeaders(baseURL: string) {\n  const token = await getAccessToken(baseURL);\n  return {\n    authorization: `Bearer ${token}`,\n  };\n}\n"]}

package/dist-tests/helpers/env.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRequiredEnv = getRequiredEnv;
+function getRequiredEnv(name) {
+    const value = process.env[name];
+    if (!value) {
+        throw new Error(`Missing required env var: ${name}`);
+    }
+    return value;
+}
+//# sourceMappingURL=env.js.map

package/dist-tests/helpers/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../tests/helpers/env.ts"],"names":[],"mappings":";;AAAA,wCAMC;AAND,SAAgB,cAAc,CAAC,IAAY;IACzC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["export function getRequiredEnv(name: string): string {\n  const value = process.env[name];\n  if (!value) {\n    throw new Error(`Missing required env var: ${name}`);\n  }\n  return value;\n}\n"]}

package/docs/agent-hub-grooming.md

@@ -0,0 +1,301 @@
+# SolidX AI Agent Builder / Agent Registry Vision
+
+## Concept
+
+The **AI Agent Builder** is a SolidX module that allows teams to define, configure, test, and deploy AI agents as first-class metadata-driven entities.
+
+The goal is to make agents configurable through SolidX rather than hardcoded in application code.
+
+Each agent is powered by a **Mini-SWE style runtime loop**, but the behaviour of the agent is controlled by SolidX metadata:
+
+```text
+Agent Definition
++ Skills
++ Tools
++ Knowledge Base
++ Policies
++ Output Schema
+= Runnable Enterprise Agent
+```
+
+---
+
+## Module Installation
+
+The AI Agent Builder can be installed as a standard SolidX module.
+
+Once installed, it brings its own domain model, such as:
+
+```text
+Agent
+Agent Skill
+Agent Tool
+Agent Knowledge Base
+Agent Policy
+Agent Run
+Agent Interaction
+Tool Call Log
+```
+
+However, the actual agent configuration can be saved directly into SolidX metadata JSON, instead of requiring every configuration detail to be stored as transactional database rows.
+
+The database can mainly store runtime records such as:
+
+```text
+Agent Run
+Conversation History
+Tool Calls
+Execution Logs
+Errors
+Audit Trail
+```
+
+---
+
+## Agent Configuration UI
+
+SolidX can provide either:
+
+1. A native SolidX CRUD-style UI, or  
+2. A custom Agent Builder UI
+
+to manage agent artefacts.
+
+The user can configure:
+
+```text
+Agent name
+Agent description
+System instructions
+Allowed skills
+Allowed tools
+Linked knowledge bases
+Runtime limits
+Approval rules
+Output schema
+```
+
+Example:
+
+```text
+Customer Support Agent
+- Skill: Complaint Handling
+- Skill: Refund Policy Interpretation
+- Tool: Gmail
+- Tool: CRM
+- Knowledge Base: Support SOPs
+- Runtime: Mini-SWE
+```
+
+---
+
+## Skills
+
+A skill represents reusable know-how.
+
+Examples:
+
+```text
+Contract Review
+Invoice Validation
+Customer Escalation Handling
+Code Review
+Document Classification
+```
+
+A skill may contain:
+
+```text
+Instructions
+Prompt templates
+Examples
+Decision criteria
+Expected output format
+```
+
+Skill = **how to think / how to perform a task**
+
+---
+
+## Tools
+
+Tools are executable capabilities available to agents.
+
+Examples:
+
+```text
+Send Email
+Search Gmail
+Query Database
+Create Ticket
+Read File
+Call API
+Search Knowledge Base
+```
+
+Tool = **what action the agent can perform**
+
+SolidX can provide a screen where all registered/discovered tools are visible.
+
+The tool registry can include:
+
+```text
+Native SolidX tools
+Internal APIs
+MCP tools
+Composio tools
+Custom enterprise tools
+```
+
+Each tool can have metadata:
+
+```text
+Name
+Description
+Input schema
+Output schema
+Auth mode
+Approval requirement
+Allowed roles
+Provider
+```
+
+---
+
+## Knowledge Base
+
+Agents can be linked to one or more knowledge bases.
+
+Examples:
+
+```text
+Company policies
+Product documentation
+Support articles
+Technical specifications
+SOPs
+Contract templates
+```
+
+This allows each agent to operate with controlled enterprise context.
+
+---
+
+## Agent Runtime
+
+Each configured agent is executed as a Mini-SWE loop.
+
+When invoked, SolidX spawns an agent run and gives it:
+
+```text
+Goal
+User input
+Agent metadata
+Relevant skills
+Available tools
+Knowledge context
+Policies
+Output schema
+```
+
+The agent then runs autonomously:
+
+```text
+Plan
+Act
+Use tool
+Observe
+Re-plan
+Complete
+```
+
+The workflow engine or UI does not need to understand the internal reasoning loop.
+
+It only receives the final structured result.
+
+---
+
+## Test Interface
+
+Once an agent is configured, users can test it inside SolidX.
+
+Default interface:
+
+```text
+Chat-based test console
+```
+
+Future interfaces:
+
+```text
+Voice
+WhatsApp
+Slack
+Email
+Embedded app widget
+```
+
+This allows business users and developers to validate the agent before attaching it to workflows.
+
+---
+
+## Workflow Integration
+
+Any SolidX workflow can include an Agent Handoff step.
+
+Example:
+
+```text
+Workflow Step:
+Delegate document review to Document Review Agent
+```
+
+The workflow creates an Agent Run.
+
+The agent works asynchronously.
+
+When completed, it sends back a result.
+
+The workflow then continues.
+
+```text
+Workflow
+  ↓
+Agent Handoff
+  ↓
+Mini-SWE Agent Run
+  ↓
+Agent Result
+  ↓
+Workflow Continues
+```
+
+---
+
+## Strategic Value
+
+This makes SolidX an enterprise agent platform, not just a workflow or low-code platform.
+
+The key advantage is that agents become:
+
+```text
+Configurable
+Reusable
+Governed
+Auditable
+Workflow-aware
+Tool-aware
+Knowledge-aware
+```
+
+SolidX remains the control plane.
+
+Mini-SWE becomes the execution loop.
+
+Tools provide actions.
+
+Skills provide task expertise.
+
+Knowledge bases provide enterprise context.
+
+Together, this creates a metadata-driven framework for building and deploying enterprise-grade AI agents.