@ascendenceai/cortena-extensions-e2e-kit 0.1.0

package/dist/protocol/suite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suite.js","sourceRoot":"","sources":["../../src/protocol/suite.ts"],"names":[],"mappings":"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"}

package/dist/protocol/types.d.ts

@@ -0,0 +1,61 @@
+import type { BrandedAnnotation } from '@ascendenceai/cortena-extensions-assure-reporters/annotations';
+import type { ListStateFilter, ListStateOptions } from '../fixtures/list-state.js';
+import type { ShellExpectations } from '../fixtures/shell.js';
+/**
+ * The six cases, one per spec.
+ *
+ * They are passed **in** rather than built here, and that is not an oversight.
+ * `assure-sync-cases` reads `assureCase({ … })` out of the source *without
+ * running it* — it parses the object literal, and it skips `node_modules`. A
+ * case built inside this package is therefore a case the sync cannot see, and
+ * a spec with no case records no result. So the literals live in the
+ * extension's own `e2e/protocol.spec.ts`, where the scanner walks, and the
+ * *behaviour* lives here, where it is written once. The generator emits the
+ * literals; an adopter copies them with the config.
+ */
+export interface ProtocolCases {
+    login: BrandedAnnotation;
+    embedded: BrandedAnnotation;
+    consent: BrandedAnnotation;
+    popup: BrandedAnnotation;
+    listState: BrandedAnnotation;
+    shell: BrandedAnnotation;
+}
+export declare const PROTOCOL_CASE_KEYS: readonly ["login", "embedded", "consent", "popup", "listState", "shell"];
+/** What only the extension can say about its own screens. */
+export interface ProtocolExpectations extends ShellExpectations {
+    /**
+     * Something on the list route that proves it rendered — a heading, usually.
+     * Matched as an accessible name, so it is the thing a person reads.
+     */
+    listHeading: string | RegExp;
+    /** A question for the agent that is safe to ask on every run and changes nothing. */
+    agentPrompt: string;
+    /**
+     * A question whose answer the agent draws as A2UI or an MCP App. Left unset,
+     * the A2UI half of P-25 is asserted against whatever `agentPrompt` produced,
+     * which is usually nothing — so set it.
+     */
+    a2uiPrompt?: string;
+    /**
+     * The scopes the consent page must name. Left unset, the first scope the
+     * extension's own `/.well-known/oauth-protected-resource` advertises is
+     * asked for — which is the one an MCP client would discover.
+     */
+    consentScopes?: string[];
+}
+export interface ProtocolSuiteOptions {
+    /** The deployed test host, e.g. `https://test.tasks.ascendenceai.com`. */
+    host: string;
+    /** The extension's first list route, without a query. */
+    listRoute: string;
+    /** One filter on that list, as the query parameter that must hold it (§9). */
+    filter: ListStateFilter;
+    detail: ListStateOptions['detail'];
+    /** The AgentTemplate slug, which is also the extension id and the mark id (§19.1). */
+    agentSlug: string;
+    /** Words the help panel must contain — the extension's own functional document (§13). */
+    helpTopic: string;
+    expects: ProtocolExpectations;
+    cases: ProtocolCases;
+}

package/dist/protocol/types.js

@@ -0,0 +1,4 @@
+export const PROTOCOL_CASE_KEYS = [
+    'login', 'embedded', 'consent', 'popup', 'listState', 'shell',
+];
+//# sourceMappingURL=types.js.map

package/dist/protocol/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/protocol/types.ts"],"names":[],"mappings":"AAyBA,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO;CACR,CAAC"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@ascendenceai/cortena-extensions-e2e-kit",
+  "version": "0.1.0",
+  "description": "The shared Playwright layer-3 kit: the six protocol flows every extension must prove, as fixtures and one defineProtocolSuite() — §23.4, rule P-36.",
+  "license": "SEE LICENSE IN LICENSE",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Ascendence-AI-Technology-Pvt-Ltd/cortena-extensions.git",
+    "directory": "packages/e2e-kit"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./locators": {
+      "types": "./dist/locators.d.ts",
+      "default": "./dist/locators.js"
+    },
+    "./config": {
+      "types": "./dist/config.d.ts",
+      "default": "./dist/config.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@ascendenceai/cortena-extensions-assure-reporters": "0.1.0"
+  },
+  "peerDependencies": {
+    "@playwright/test": ">=1.50.0"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.50.0",
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit -p tsconfig.test.json",
+    "lint": "tsc --noEmit -p tsconfig.test.json",
+    "test": "vitest run"
+  }
+}