@grantex/conformance 0.1.0

package/dist/suites/tokens.js

@@ -0,0 +1,43 @@
+import { test, expectStatus, expectKeys, expectEqual, expectBoolean } from '../helpers.js';
+export const tokensSuite = {
+    name: 'tokens',
+    description: 'Token verification and revocation',
+    optional: false,
+    run: async (ctx) => {
+        const results = [];
+        const { agentId, agentDid } = ctx.sharedAgent;
+        // Execute full flow to get tokens (reuse shared agent)
+        const flow = await ctx.flow.executeFullFlow({ agentId, agentDid });
+        const grantToken = flow.grantToken;
+        results.push(await test('POST /v1/tokens/verify returns valid=true for active token', '§7.2', async () => {
+            const res = await ctx.http.post('/v1/tokens/verify', { token: grantToken });
+            expectStatus(res, 200);
+            expectKeys(res.body, ['valid', 'grantId', 'scopes', 'principal', 'agent', 'expiresAt']);
+            expectEqual(res.body.valid, true, 'valid');
+        }));
+        results.push(await test('POST /v1/tokens/revoke returns 204', '§7.3', async () => {
+            // Decode the JWT to get jti
+            const parts = grantToken.split('.');
+            const payload = JSON.parse(atob(parts[1]));
+            const res = await ctx.http.post('/v1/tokens/revoke', { jti: payload.jti });
+            expectStatus(res, 204);
+        }));
+        results.push(await test('POST /v1/tokens/verify returns valid=false after revocation', '§7.3', async () => {
+            const res = await ctx.http.post('/v1/tokens/verify', {
+                token: grantToken,
+            });
+            expectStatus(res, 200);
+            expectEqual(res.body.valid, false, 'valid');
+        }));
+        results.push(await test('POST /v1/tokens/verify returns valid=false for garbage token', '§7.2', async () => {
+            const res = await ctx.http.post('/v1/tokens/verify', {
+                token: 'not.a.valid.jwt.token',
+            });
+            expectStatus(res, 200);
+            expectBoolean(res.body.valid, 'valid');
+            expectEqual(res.body.valid, false, 'valid');
+        }));
+        return results;
+    },
+};
+//# sourceMappingURL=tokens.js.map

package/dist/suites/tokens.js.map

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

package/dist/suites/webhooks.d.ts

@@ -0,0 +1,3 @@
+import type { SuiteDefinition } from '../types.js';
+export declare const webhooksSuite: SuiteDefinition;
+//# sourceMappingURL=webhooks.d.ts.map

package/dist/suites/webhooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../../src/suites/webhooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAA4B,MAAM,aAAa,CAAC;AAG7E,eAAO,MAAM,aAAa,EAAE,eA+C3B,CAAC"}

package/dist/suites/webhooks.js

@@ -0,0 +1,36 @@
+import { test, expectStatus, expectKeys, expectString, expectArray } from '../helpers.js';
+export const webhooksSuite = {
+    name: 'webhooks',
+    description: 'Webhook registration and management',
+    optional: true,
+    run: async (ctx) => {
+        const results = [];
+        let webhookId = '';
+        results.push(await test('POST /v1/webhooks creates webhook (201)', '§11', async () => {
+            const res = await ctx.http.post('/v1/webhooks', {
+                url: 'https://example.com/webhook',
+                events: ['grant.created', 'grant.revoked'],
+            });
+            expectStatus(res, 201);
+            expectKeys(res.body, ['id', 'url', 'events', 'secret']);
+            expectString(res.body.id, 'id');
+            expectString(res.body.secret, 'secret');
+            webhookId = res.body.id;
+            ctx.cleanup.trackWebhook(webhookId);
+        }));
+        results.push(await test('GET /v1/webhooks lists webhooks', '§11', async () => {
+            const res = await ctx.http.get('/v1/webhooks');
+            expectStatus(res, 200);
+            expectKeys(res.body, ['webhooks']);
+            expectArray(res.body.webhooks, 'webhooks');
+        }));
+        results.push(await test('DELETE /v1/webhooks/:id returns 204', '§11', async () => {
+            if (!webhookId)
+                throw new Error('No webhook created');
+            const res = await ctx.http.delete(`/v1/webhooks/${webhookId}`);
+            expectStatus(res, 204);
+        }));
+        return results;
+    },
+};
+//# sourceMappingURL=webhooks.js.map

package/dist/suites/webhooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.js","sourceRoot":"","sources":["../../src/suites/webhooks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE1F,MAAM,CAAC,MAAM,aAAa,GAAoB;IAC5C,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,qCAAqC;IAClD,QAAQ,EAAE,IAAI;IACd,GAAG,EAAE,KAAK,EAAE,GAAiB,EAAyB,EAAE;QACtD,MAAM,OAAO,GAAiB,EAAE,CAAC;QACjC,IAAI,SAAS,GAAG,EAAE,CAAC;QAEnB,OAAO,CAAC,IAAI,CACV,MAAM,IAAI,CAAC,yCAAyC,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE;YACtE,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAK5B,cAAc,EAAE;gBACjB,GAAG,EAAE,6BAA6B;gBAClC,MAAM,EAAE,CAAC,eAAe,EAAE,eAAe,CAAC;aAC3C,CAAC,CAAC;YACH,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YACvB,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;YACxD,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YAChC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YACxC,SAAS,GAAG,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QACtC,CAAC,CAAC,CACH,CAAC;QAEF,OAAO,CAAC,IAAI,CACV,MAAM,IAAI,CAAC,iCAAiC,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE;YAC9D,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,GAAG,CAA0B,cAAc,CAAC,CAAC;YACxE,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YACvB,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;YACnC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAC7C,CAAC,CAAC,CACH,CAAC;QAEF,OAAO,CAAC,IAAI,CACV,MAAM,IAAI,CAAC,qCAAqC,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE;YAClE,IAAI,CAAC,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;YACtD,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,gBAAgB,SAAS,EAAE,CAAC,CAAC;YAC/D,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACzB,CAAC,CAAC,CACH,CAAC;QAEF,OAAO,OAAO,CAAC;IACjB,CAAC;CACF,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,60 @@
+export interface RunConfig {
+    baseUrl: string;
+    apiKey: string;
+    suite?: string;
+    include?: string[];
+    format: 'text' | 'json';
+    bail: boolean;
+}
+export interface HttpResponse<T = unknown> {
+    status: number;
+    body: T;
+    rawText: string;
+    durationMs: number;
+}
+export type TestStatus = 'pass' | 'fail' | 'skip';
+export interface TestResult {
+    name: string;
+    status: TestStatus;
+    durationMs: number;
+    specRef: string;
+    error?: string;
+}
+export interface SuiteResult {
+    name: string;
+    description: string;
+    optional: boolean;
+    tests: TestResult[];
+    durationMs: number;
+}
+export interface ConformanceReport {
+    suites: SuiteResult[];
+    summary: {
+        total: number;
+        passed: number;
+        failed: number;
+        skipped: number;
+        durationMs: number;
+    };
+}
+export interface SharedAgent {
+    agentId: string;
+    agentDid: string;
+    name: string;
+}
+export interface SuiteContext {
+    baseUrl: string;
+    apiKey: string;
+    http: import('./http-client.js').ConformanceHttpClient;
+    flow: import('./flow.js').AuthFlowHelper;
+    cleanup: import('./cleanup.js').CleanupTracker;
+    /** Pre-created agent shared across suites to avoid plan limits */
+    sharedAgent: SharedAgent;
+}
+export interface SuiteDefinition {
+    name: string;
+    description: string;
+    optional: boolean;
+    run: (ctx: SuiteContext) => Promise<TestResult[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,CAAC,CAAC;IACR,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAElD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,kBAAkB,EAAE,qBAAqB,CAAC;IACvD,IAAI,EAAE,OAAO,WAAW,EAAE,cAAc,CAAC;IACzC,OAAO,EAAE,OAAO,cAAc,EAAE,cAAc,CAAC;IAC/C,kEAAkE;IAClE,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,GAAG,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;CACnD"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@grantex/conformance",
+  "version": "0.1.0",
+  "description": "Conformance test suite for the Grantex protocol",
+  "type": "module",
+  "bin": {
+    "grantex-conformance": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "dev": "node --loader ts-node/esm src/index.ts"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0"
+  },
+  "overrides": {
+    "esbuild": ">=0.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.3.3",
+    "vitest": "^1.3.1"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "grantex",
+    "conformance",
+    "testing",
+    "protocol",
+    "ai-agents",
+    "authorization",
+    "oauth"
+  ],
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mishrasanjeev/grantex"
+  }
+}