@prostgles/app 2.3.6-dev.1789046358 → 2.3.6-dev.1789048658

package/dist/common/constants.d.ts

@@ -0,0 +1 @@
+export declare const CLIENT_LOGS_KEY = "__PRGL_DEBUG_LOGS";

package/dist/common/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../common/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,sBAAsB,CAAC"}

package/dist/common/constants.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CLIENT_LOGS_KEY = void 0;
+exports.CLIENT_LOGS_KEY = "__PRGL_DEBUG_LOGS";

package/dist/common/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../common/constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,eAAe,GAAG,mBAAmB,CAAC"}

package/dist/e2e/cli/index.d.ts

@@ -0,0 +1,18 @@
+import { type CreateTestDeploymentOptions, type TestDeployment } from "@prostgles/app/testing";
+import type { PageWIds } from "../tests/utils/utils";
+export { expect } from "@playwright/test";
+export { openTable, getTableWindow, insertRow, clickInsertRow, fillSmartForm, fillSmartFormAndInsert, setOrAddWorkspace, getDashboardUtils, type PageWIds, type LocatorWIds, } from "../tests/utils/utils";
+/** One isolated app per test; Playwright owns contexts and recording cleanup. */
+export declare const test: import("@playwright/test").TestType<import("@playwright/test").PlaywrightTestArgs & import("@playwright/test").PlaywrightTestOptions & {
+    clientLogs: void;
+} & {
+    deploymentOptions: CreateTestDeploymentOptions;
+    userKey: string;
+    deployment: TestDeployment;
+    app: {
+        page: PageWIds;
+        open: () => Promise<void>;
+    };
+}, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions>;
+/** Paths are relative to the generated app's e2e/playwright.config.ts. */
+export declare const defineE2EConfig: () => import("@playwright/test").PlaywrightTestConfig<{}, {}>;

package/dist/e2e/cli/index.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineE2EConfig = exports.test = exports.getDashboardUtils = exports.setOrAddWorkspace = exports.fillSmartFormAndInsert = exports.fillSmartForm = exports.clickInsertRow = exports.insertRow = exports.getTableWindow = exports.openTable = exports.expect = void 0;
+const fixtures_1 = require("../tests/utils/fixtures");
+const test_1 = require("@playwright/test");
+const testing_1 = require("@prostgles/app/testing");
+var test_2 = require("@playwright/test");
+Object.defineProperty(exports, "expect", { enumerable: true, get: function () { return test_2.expect; } });
+var utils_1 = require("../tests/utils/utils");
+Object.defineProperty(exports, "openTable", { enumerable: true, get: function () { return utils_1.openTable; } });
+Object.defineProperty(exports, "getTableWindow", { enumerable: true, get: function () { return utils_1.getTableWindow; } });
+Object.defineProperty(exports, "insertRow", { enumerable: true, get: function () { return utils_1.insertRow; } });
+Object.defineProperty(exports, "clickInsertRow", { enumerable: true, get: function () { return utils_1.clickInsertRow; } });
+Object.defineProperty(exports, "fillSmartForm", { enumerable: true, get: function () { return utils_1.fillSmartForm; } });
+Object.defineProperty(exports, "fillSmartFormAndInsert", { enumerable: true, get: function () { return utils_1.fillSmartFormAndInsert; } });
+Object.defineProperty(exports, "setOrAddWorkspace", { enumerable: true, get: function () { return utils_1.setOrAddWorkspace; } });
+Object.defineProperty(exports, "getDashboardUtils", { enumerable: true, get: function () { return utils_1.getDashboardUtils; } });
+/** One isolated app per test; Playwright owns contexts and recording cleanup. */
+exports.test = fixtures_1.test.extend({
+    deploymentOptions: [{ configId: "e2e" }, { option: true }],
+    userKey: ["admin", { option: true }],
+    deployment: [
+        async ({ deploymentOptions }, use, testInfo) => {
+            const deployment = await (0, testing_1.createTestDeployment)({
+                ...deploymentOptions,
+                logPath: testInfo.outputPath("deployment.log"),
+            });
+            try {
+                await use(deployment);
+            }
+            finally {
+                await deployment.dispose();
+            }
+        },
+        { timeout: 120_000 },
+    ],
+    baseURL: async ({ deployment }, use) => await use(deployment.endpoint),
+    storageState: async ({ deployment, userKey }, use) => await use(deployment.storageStateAs(userKey)),
+    app: async ({ page, deployment }, use) => {
+        await use({
+            page: page,
+            open: async () => {
+                await page.goto(deployment.dashboardUrl);
+                await page.getByTestId("dashboard.menu").waitFor({ state: "visible" });
+            },
+        });
+    },
+});
+/** Paths are relative to the generated app's e2e/playwright.config.ts. */
+const defineE2EConfig = () => (0, test_1.defineConfig)({
+    testDir: "./tests",
+    outputDir: "./test-results",
+    reporter: [
+        ["html", { outputFolder: "./playwright-report", open: "never" }],
+    ],
+    timeout: 120_000,
+    workers: 1,
+    fullyParallel: false,
+    forbidOnly: !!process.env.CI,
+    retries: 0,
+    use: {
+        ...test_1.devices["Desktop Chrome"],
+        testIdAttribute: "data-command",
+        video: "on",
+        trace: "on",
+        screenshot: "only-on-failure",
+        actionTimeout: 15_000,
+    },
+});
+exports.defineE2EConfig = defineE2EConfig;

package/dist/e2e/cli/template.d.ts

@@ -0,0 +1,13 @@
+export declare const getE2ETemplate: (configId: string) => {
+    "playwright.config.ts": string;
+    "tsconfig.json": string;
+    ".gitignore": string;
+    "AGENTS.md": string;
+    tests: {
+        "fixtures.ts": string;
+        admin: {
+            "dashboard.spec.ts": string;
+        };
+    };
+};
+//# sourceMappingURL=template.d.ts.map

package/dist/e2e/cli/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../../../e2e/cli/template.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,GAAI,UAAU,MAAM;;;;;;;;;;;CAuD7C,CAAC"}

package/dist/e2e/cli/template.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getE2ETemplate = void 0;
+const getE2ETemplate = (configId) => ({
+    "playwright.config.ts": `
+    import { defineE2EConfig } from "@prostgles/app/testing/ui";
+    export default defineE2EConfig();`,
+    "tsconfig.json": JSON.stringify({
+        compilerOptions: {
+            target: "ES2022",
+            module: "Node16",
+            moduleResolution: "Node16",
+            strict: true,
+            esModuleInterop: true,
+            skipLibCheck: true,
+            noEmit: true,
+        },
+        include: ["**/*.ts"],
+    }, null, 2),
+    ".gitignore": "test-results/\nplaywright-report/\n",
+    "AGENTS.md": `
+    # UI workflow tests
+
+    - Put business workflows in tests/<role>/*.spec.ts. Import test and expect from ../fixtures and UI helpers from @prostgles/app/testing/ui.
+    - Configure seeded users and deterministic data in tests/fixtures.ts using deploymentOptions.users and deploymentOptions.seed. Each test gets a fresh app and database; Docker must be available.
+    - Select a seeded user with test.use({ userKey: "member" }). Configure actual app permissions in src/; a user key is only a fixture name, not an authorization role.
+    - Start with await app.open(). Reuse openTable(app.page, tableName, true), getTableWindow(app.page, tableName), insertRow(app.page, tableName, values), fillSmartForm, fillSmartFormAndInsert, clickInsertRow and setOrAddWorkspace before adding selectors. These are the same helpers used by Prostgles UI's e2e tests.
+    - Assert visible business outcomes and denied actions for each role. Use deployment.connectProjectAs(userKey) when a database assertion helps. Keep app-specific helper functions here beside the workflows.
+    - Run npm run test:e2e:install once to install Chromium, then npm run test:e2e. To run a role or workflow: npm run test:e2e -- tests/admin or npm run test:e2e -- -g "workflow name".
+    - Videos and traces for every test, including passing tests, are saved in e2e/test-results/. Deployment and PostgreSQL logs are saved alongside them. Artifacts may contain test data and sessions; do not commit them.
+    - Run npm run test:e2e:report and select a test to play its video or inspect its trace. The HTML report is in e2e/playwright-report/. Results are replaced on the next run; copy them elsewhere inside the project if they must be kept.
+  `,
+    tests: {
+        "fixtures.ts": `
+      import { test as base } from "@prostgles/app/testing/ui";
+      export { expect } from "@prostgles/app/testing/ui";
+      export const test = base.extend({
+        deploymentOptions: {
+          configId: ${JSON.stringify(configId)},
+          users: [{ key: "admin", type: "admin" }, { key: "member", type: "default" }],
+          // seed: async ({ projectDatabase, stateDatabase }) => { ... },
+        },
+      });`,
+        admin: {
+            "dashboard.spec.ts": `
+        import { test, expect } from "../fixtures";
+        test.use({ userKey: "admin" });
+        test("admin opens the configured app", async ({ app }) => {
+          await app.open();
+          await expect(app.page.getByTestId("dashboard.menu")).toBeVisible();
+          // Add business workflows using openTable, insertRow and getTableWindow.
+        });`,
+        },
+    },
+});
+exports.getE2ETemplate = getE2ETemplate;
+//# sourceMappingURL=template.js.map

package/dist/e2e/cli/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../../../e2e/cli/template.ts"],"names":[],"mappings":";;;AAAO,MAAM,cAAc,GAAG,CAAC,QAAgB,EAAE,EAAE,CAAC,CAAC;IACnD,sBAAsB,EAAE;;sCAEY;IACpC,eAAe,EAAE,IAAI,CAAC,SAAS,CAC7B;QACE,eAAe,EAAE;YACf,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,QAAQ;YAChB,gBAAgB,EAAE,QAAQ;YAC1B,MAAM,EAAE,IAAI;YACZ,eAAe,EAAE,IAAI;YACrB,YAAY,EAAE,IAAI;YAClB,MAAM,EAAE,IAAI;SACb;QACD,OAAO,EAAE,CAAC,SAAS,CAAC;KACrB,EACD,IAAI,EACJ,CAAC,CACF;IACD,YAAY,EAAE,qCAAqC;IACnD,WAAW,EAAE;;;;;;;;;;;GAWZ;IACD,KAAK,EAAE;QACL,aAAa,EAAE;;;;;sBAKG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;;;;UAIpC;QACN,KAAK,EAAE;YACL,mBAAmB,EAAE;;;;;;;YAOf;SACP;KACF;CACF,CAAC,CAAC;AAvDU,QAAA,cAAc,kBAuDxB"}