@tryvitris/website-admin-contracts 1.3.1 → 1.5.0

package/README.md

@@ -1,3 +1,5 @@
-# Website Admin Contracts
-
-Validated installation manifests, roles, permissions and module contracts for `@tryvitris/website-admin-harness`. Node.js 24+. MIT licensed.
+# Website Admin Contracts
+
+Validated installation manifests, roles, permissions and module contracts for `@tryvitris/website-admin-harness`. Node.js 24+. MIT licensed.
+
+The maintenance contract exports the stable admin package family and typed installed/locked/published-version reports and preparation plans. Its policy is prepare-and-test under existing publication permissions. It does not execute updates or create schedules; use the runtime maintenance CLI and its agent guide.

package/dist/index.d.ts

@@ -214,3 +214,4 @@ export declare const workQueueModule: ModuleDefinition;
 export declare function isLoopback(origin: string): boolean;
 export declare function parseManifest(value: unknown): AdminManifest;
 export declare function validateModules(manifest: AdminManifest, modules: ModuleDefinition[]): void;
+export * from './maintenance.js';

package/dist/index.js

@@ -166,6 +166,7 @@ function validateModules(manifest, modules) {
   }
   for (const enabled of manifest.modules) if (!ids.has(enabled)) throw new Error(`Module ${enabled} is not installed`);
 }
+export * from "./maintenance.js";
 export {
   analyticsBreakdownKeys,
   analyticsMetricKeys,

package/dist/maintenance.d.ts

@@ -0,0 +1,47 @@
+/** Package maintenance is an agent workflow; this contract grants no deployment authority. */
+export declare const maintenanceVersion = 1;
+export declare const adminMaintenancePackages: readonly ["@tryvitris/website-admin-harness", "@tryvitris/website-admin-contracts", "@tryvitris/create-website-admin-harness"];
+export declare const maintenancePackages: readonly ["@tryvitris/website-admin-harness", "@tryvitris/website-admin-contracts", "@tryvitris/create-website-admin-harness", "@tryvitris/website-harness"];
+export type MaintenancePackage = typeof maintenancePackages[number];
+export type MaintenanceStatus = 'not-declared' | 'current' | 'update-available' | 'ahead' | 'unmanaged' | 'drift' | 'unavailable';
+export interface MaintenanceRelease {
+    name: MaintenancePackage;
+    version: string;
+    integrity: string;
+    tarball: string;
+}
+export interface MaintenanceEntry {
+    name: MaintenancePackage;
+    declared: string | null;
+    installed: string | null;
+    locked: string | null;
+    status: MaintenanceStatus;
+    change: 'none' | 'patch' | 'minor' | 'major' | 'unknown';
+    latest: MaintenanceRelease | null;
+}
+export interface MaintenanceReport {
+    schemaVersion: 1;
+    checkedAt: string;
+    policy: 'prepare-and-test';
+    adminRelease: {
+        version: string | null;
+        complete: boolean;
+    };
+    packages: MaintenanceEntry[];
+    baseline: Record<string, string>;
+    deployment: 'not-checked';
+}
+export interface MaintenancePlan {
+    schemaVersion: 1;
+    policy: 'prepare-and-test';
+    baseline: Record<string, string>;
+    ready: boolean;
+    held: MaintenancePackage[];
+    updates: MaintenanceRelease[];
+    install: {
+        command: 'npm';
+        args: string[];
+    } | null;
+    requiredChecks: string[];
+    deployment: 'follow-existing-permissions';
+}

package/dist/maintenance.js

@@ -0,0 +1,9 @@
+// packages/contracts/src/maintenance.ts
+var maintenanceVersion = 1;
+var adminMaintenancePackages = ["@tryvitris/website-admin-harness", "@tryvitris/website-admin-contracts", "@tryvitris/create-website-admin-harness"];
+var maintenancePackages = ["@tryvitris/website-admin-harness", "@tryvitris/website-admin-contracts", "@tryvitris/create-website-admin-harness", "@tryvitris/website-harness"];
+export {
+  adminMaintenancePackages,
+  maintenancePackages,
+  maintenanceVersion
+};

package/dist/pairing.d.ts

@@ -12,6 +12,13 @@ export declare const pairingPolicy: {
 export interface PairingStart {
     requestId: string;
     challenge: string;
+    signOn?: {
+        version: 1;
+        subject: {
+            id: string;
+            email: string;
+        };
+    };
 }
 export interface PairingExchange {
     requestId: string;
@@ -48,6 +55,10 @@ export interface PairingCapabilities {
     scope: 'analytics:read';
     requestPath: string;
     approvalPath: string;
+    connectionSetup?: {
+        version: 1;
+        signOn: boolean;
+    };
 }
 export interface PairingEnvelope {
     version: 1;
@@ -69,6 +80,11 @@ export interface PairingCredential {
     keyId: string;
     scope: 'analytics:read';
     operations: readonly ['status', 'analytics'];
+    signOn?: {
+        version: 1;
+        subjectId: string;
+        approved: boolean;
+    };
 }
 export interface PairingGrantView {
     id: string;
@@ -89,6 +105,21 @@ export interface PairingRequestView {
     status: 'pending' | 'approved' | 'revoked' | 'expired';
     scope: 'analytics:read';
     createsRelationship: boolean;
+    signOn?: {
+        version: 1;
+        subject: {
+            id: string;
+            email: string;
+        };
+        approved: boolean;
+        localUserId: string | null;
+        users: {
+            id: string;
+            email: string;
+            role: string;
+            permissions?: readonly string[];
+        }[];
+    };
 }
 export type PairingErrorCode = 'invalid_request' | 'unauthorized' | 'forbidden' | 'expired' | 'replay' | 'conflict' | 'unavailable' | 'unsupported';
 export declare function samePairingIdentity(a: PairingIdentity, b: PairingIdentity): boolean;

package/package.json

@@ -1,36 +1,46 @@
-{
-  "name": "@tryvitris/website-admin-contracts",
-  "version": "1.3.1",
-  "type": "module",
-  "license": "MIT",
-  "description": "Validated installation and module contracts for Cloudflare business admin apps",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
-    },
-    "./scheduling": {
-      "types": "./dist/scheduling.d.ts",
-      "default": "./dist/scheduling.js"
-    }
-  },
-  "files": [
-    "dist"
-  ],
-  "publishConfig": {
-    "access": "public",
-    "tag": "latest"
-  },
-  "engines": {
-    "node": ">=24"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/jackperrotta/website-admin-harness.git",
-    "directory": "packages/contracts"
-  },
-  "homepage": "https://github.com/jackperrotta/website-admin-harness#readme",
-  "bugs": {
-    "url": "https://github.com/jackperrotta/website-admin-harness/issues"
-  }
-}
+{
+  "name": "@tryvitris/website-admin-contracts",
+  "version": "1.5.0",
+  "type": "module",
+  "license": "MIT",
+  "description": "Validated installation and module contracts for Cloudflare business admin apps",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./scheduling": {
+      "types": "./dist/scheduling.d.ts",
+      "default": "./dist/scheduling.js"
+    }
+  },
+  "files": [
+    "dist",
+    "vitris-release.json"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "tag": "latest"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jackperrotta/website-admin-harness.git",
+    "directory": "packages/contracts"
+  },
+  "homepage": "https://github.com/jackperrotta/website-admin-harness#readme",
+  "bugs": {
+    "url": "https://github.com/jackperrotta/website-admin-harness/issues"
+  },
+  "vitris": {
+    "maintenance": {
+      "version": 1,
+      "policy": "prepare-and-test",
+      "stableChannel": "latest",
+      "command": "vitris-admin updates check --dir . --json",
+      "schedule": "reuse-existing-daily-care"
+    }
+  }
+}

package/vitris-release.json

@@ -0,0 +1,15 @@
+{
+  "schemaVersion": 1,
+  "name": "@tryvitris/website-admin-contracts",
+  "version": "1.5.0",
+  "title": "Typed agent maintenance reports and plans",
+  "notesScope": "package",
+  "notes": [
+    "Adds the shared package-family, status, release identity and prepare-and-test plan contract used by the admin and website daily maintenance tooling."
+  ],
+  "repository": "https://github.com/jackperrotta/website-admin-harness",
+  "readmePath": "packages/contracts/README.md",
+  "ref": "v1.5.0",
+  "documentation": "# Website Admin Contracts\r\n\r\nValidated installation manifests, roles, permissions and module contracts for `@tryvitris/website-admin-harness`. Node.js 24+. MIT licensed.\r\n\r\nThe maintenance contract exports the stable admin package family and typed installed/locked/published-version reports and preparation plans. Its policy is prepare-and-test under existing publication permissions. It does not execute updates or create schedules; use the runtime maintenance CLI and its agent guide.\r\n",
+  "documentationSha256": "53077ee5624185df808524801143734e7d9786aab747834e83a8603de06a1ee8"
+}