@solidxai/core 0.1.10-beta.3 → 0.1.10-beta.4

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/grouping-enhancements.md

@@ -0,0 +1,89 @@
+# Grouping & Aggregation Enhancements (Code Review Summary)
+
+This document explains the recent changes to grouping/aggregation in the CRUD helper/service, why they were made, and how to use them (with examples on `PincodeMaster`).
+
+## What Changed and Why
+- **Dedicated grouping pipeline**: Grouping no longer reuses the record-level query (which had `SELECT entity.*`, pagination, and default order). A separate path builds clean group queries to avoid SQL errors and ensure correct counts.
+- **Multiple group-by fields**: The one-field limit was removed. You can now group on multiple fields (including relations) in the requested order.
+- **Relation-safe grouping**: Group-by fields can traverse many-to-one relations (e.g., `state.name`, `city.name`). The helper reuses existing joins (from filters) or adds the necessary joins and aliases.
+- **Date granularity**: Grouping supports `day`, `week`, `month`, `year` granularities in a DB-aware way (Postgres, MySQL/MariaDB, SQL Server).
+- **Aggregates**: Supports a core, DB-agnostic set: `count`, `count_distinct`, `sum`, `avg`, `min`, `max`. If `aggregates` is omitted, it defaults to `count(*)`.
+- **Group sorting/pagination**: Sorting and pagination are applied to group rows (not entity rows). Record pagination is kept separate for non-grouped queries.
+- **Ordered group names**: Group names follow the order of `groupBy` fields. Relation values and date/grouped values are included in sequence.
+- **Formatted date group labels**: You can add an optional format specifier to a date groupBy field: `field:granularity:format`. Supported formats: `MMM`, `MMMM`, `YYYY`, `YYYY-MM`, `YYYY-MM-DD` (defaults to the raw value if omitted).
+- **Count of groups**: Group counts are computed without pagination interference, so `meta.totalRecords` reflects total groups.
+- **DTO update**: `BasicFilterDto` now includes optional `aggregates?: string[]`.
+
+## Caveats
+- `populateGroup` is **not** supported when grouping on relation fields (e.g., `state.name`, `city.name`). Use it for scalar group-by fields only; otherwise fetch group metadata and then retrieve records in a separate call with the group key.
+- Sorting works for group keys without extra colons (e.g., `state.name`) and for aggregate aliases (e.g., `id_max`). For date bucket group keys with granularity/format (`createdAt:month:YYYY`), the sort parser treats the last segment as the order; results may vary by driver and may not sort as expected in all cases.
+
+## Usage Examples (PincodeMaster)
+Assume `PincodeMaster` has many-to-one `state` and `city` relations and a `createdAt` timestamp.
+
+### 1) Group by State and City
+```
+GET /api/pincode-master?offset=0&limit=200&groupBy[0]=state.name&groupBy[1]=city.name
+```
+Returns groups for every state/city combination with default `count(*)` aggregate.
+
+### 2) Group by Relation + Filter on Relation
+```
+GET /api/pincode-master?offset=0&limit=200&groupBy[0]=state.name&filters[state][name][$eq]=Maharashtra
+```
+Groups by state name but only for rows where state is Maharashtra.
+
+### 3) Multiple Group Fields (Relation + Scalar)
+```
+GET /api/pincode-master?offset=0&limit=200&groupBy[0]=state.name&groupBy[1]=city.name&groupBy[2]=pincode
+```
+Group names are ordered: state → city → pincode.
+
+### 4) Group by Date with Granularity (Month)
+```
+GET /api/pincode-master?offset=0&limit=200&groupBy[0]=createdAt:month
+```
+Groups by month (driver-aware), default group labels are raw date buckets.
+
+### 5) Date Granularity with Formatting
+```
+GET /api/pincode-master?offset=0&limit=200&groupBy[0]=createdAt:month:MMM
+```
+Group labels use short month names (Jan, Feb, …). For full names: `createdAt:month:MMMM`. Other formats: `YYYY`, `YYYY-MM`, `YYYY-MM-DD`.
+
+### 6) Aggregates (Count Distinct)
+```
+GET /api/pincode-master?offset=0&limit=200&groupBy[0]=state.name&aggregates[0]=pincode:count_distinct
+```
+Shows distinct pincodes per state.
+
+### 7) Aggregates (Multiple)
+```
+GET /api/pincode-master?offset=0&limit=200&groupBy[0]=state.name&groupBy[1]=city.name&aggregates[0]=id:count&aggregates[1]=id:count_distinct
+```
+Returns both total rows and distinct IDs per state/city group.
+
+### 8) Date Granularity + Relations + Aggregates
+```
+GET /api/pincode-master?offset=0&limit=200&groupBy[0]=createdAt:year&groupBy[1]=state.name&aggregates[0]=pincode:count_distinct
+```
+Distinct pincodes per state, per year.
+
+### 9) Filters with Grouping (Many-to-One)
+```
+GET /api/pincode-master?offset=0&limit=200&groupBy[0]=state.name&groupBy[1]=city.name&filters[state][name][$eq]=Nagaland
+```
+Groups only rows where state.name = Nagaland.
+
+### 10) Group Sorting and Pagination
+- Sorting applies to the group rows. Example:
+```
+GET /api/pincode-master?offset=0&limit=50&groupBy[0]=state.name&sort[0]=state.name:ASC
+```
+- Pagination (`offset/limit`) limits the number of groups returned; total group count remains in `meta.totalRecords`.
+
+## Notes and Behavior
+- If `aggregates` is omitted, `COUNT(*)` is added automatically.
+- Group names reflect `groupBy` order and apply formatting when specified.
+- Group queries reuse joins from filters when possible; otherwise, they create necessary joins for relation paths.
+- Non-grouped find behavior remains unchanged.

package/docs/java-spring/README.md

@@ -0,0 +1,3 @@
+# Java Spring Docs
+
+- [solid-core-module Deep Dive Report](./solid-core-module-deep-dive-report.md)