@checkstack/test-utils-backend 0.0.4 → 0.1.1

package/CHANGELOG.md

@@ -1,5 +1,92 @@
 # @checkstack/test-utils-backend
 
+## 0.1.1
+
+### Patch Changes
+
+- Updated dependencies [9a27800]
+  - @checkstack/queue-api@0.0.6
+  - @checkstack/backend-api@0.3.1
+
+## 0.1.0
+
+### Minor Changes
+
+- 9faec1f: # Unified AccessRule Terminology Refactoring
+
+  This release completes a comprehensive terminology refactoring from "permission" to "accessRule" across the entire codebase, establishing a consistent and modern access control vocabulary.
+
+  ## Changes
+
+  ### Core Infrastructure (`@checkstack/common`)
+
+  - Introduced `AccessRule` interface as the primary access control type
+  - Added `accessPair()` helper for creating read/manage access rule pairs
+  - Added `access()` builder for individual access rules
+  - Replaced `Permission` type with `AccessRule` throughout
+
+  ### API Changes
+
+  - `env.registerPermissions()` → `env.registerAccessRules()`
+  - `meta.permissions` → `meta.access` in RPC contracts
+  - `usePermission()` → `useAccess()` in frontend hooks
+  - Route `permission:` field → `accessRule:` field
+
+  ### UI Changes
+
+  - "Roles & Permissions" tab → "Roles & Access Rules"
+  - "You don't have permission..." → "You don't have access..."
+  - All permission-related UI text updated
+
+  ### Documentation & Templates
+
+  - Updated 18 documentation files with AccessRule terminology
+  - Updated 7 scaffolding templates with `accessPair()` pattern
+  - All code examples use new AccessRule API
+
+  ## Migration Guide
+
+  ### Backend Plugins
+
+  ```diff
+  - import { permissionList } from "./permissions";
+  - env.registerPermissions(permissionList);
+  + import { accessRules } from "./access";
+  + env.registerAccessRules(accessRules);
+  ```
+
+  ### RPC Contracts
+
+  ```diff
+  - .meta({ userType: "user", permissions: [permissions.read.id] })
+  + .meta({ userType: "user", access: [access.read] })
+  ```
+
+  ### Frontend Hooks
+
+  ```diff
+  - const canRead = accessApi.usePermission(permissions.read.id);
+  + const canRead = accessApi.useAccess(access.read);
+  ```
+
+  ### Routes
+
+  ```diff
+  - permission: permissions.entityRead.id,
+  + accessRule: access.read,
+  ```
+
+### Patch Changes
+
+- Updated dependencies [9faec1f]
+- Updated dependencies [827b286]
+- Updated dependencies [f533141]
+- Updated dependencies [aa4a8ab]
+  - @checkstack/backend-api@0.3.0
+  - @checkstack/common@0.2.0
+  - @checkstack/signal-common@0.1.0
+  - @checkstack/queue-api@0.0.5
+
 ## 0.0.4
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@checkstack/test-utils-backend",
-  "version": "0.0.4",
+  "version": "0.1.1",
   "type": "module",
   "main": "src/index.ts",
   "scripts": {

package/src/mock-signal-service.ts

@@ -1,4 +1,4 @@
-import { qualifyPermissionId } from "@checkstack/common";
+import { qualifyAccessRuleId } from "@checkstack/common";
 import type { SignalService, Signal } from "@checkstack/signal-common";
 
 /**
@@ -9,7 +9,7 @@ export interface RecordedSignal<T = unknown> {
   payload: T;
   targetType: "broadcast" | "user" | "users" | "authorized";
   userIds?: string[];
-  permission?: string; // For authorized signals
+  accessRule?: string; // For authorized signals
   timestamp: Date;
 }
 
@@ -48,11 +48,11 @@ export interface MockSignalService extends SignalService {
   wasSignalSentToUser(signalId: string, userId: string): boolean;
 
   /**
-   * Set a permission filter function for sendToAuthorizedUsers testing.
+   * Set a access filter function for sendToAuthorizedUsers testing.
    * If not set, sendToAuthorizedUsers will pass through all users.
    */
-  setPermissionFilter(
-    filter: (userIds: string[], permission: string) => string[]
+  setAccessFilter(
+    filter: (userIds: string[], accessRule: string) => string[]
   ): void;
 }
 
@@ -79,8 +79,8 @@ export interface MockSignalService extends SignalService {
  */
 export function createMockSignalService(): MockSignalService {
   const recordedSignals: RecordedSignal[] = [];
-  let permissionFilter:
-    | ((userIds: string[], permission: string) => string[])
+  let accessFilter:
+    | ((userIds: string[], accessRule: string) => string[])
     | undefined;
 
   return {
@@ -157,17 +157,17 @@ export function createMockSignalService(): MockSignalService {
       userIds: string[],
       payload: T,
       pluginMetadata: { pluginId: string },
-      permission: { id: string }
+      accessRule: { id: string }
     ): Promise<void> {
-      // Construct fully-qualified permission ID
-      const qualifiedPermission = qualifyPermissionId(
+      // Construct fully-qualified access rule ID
+      const qualifiedAccessRule = qualifyAccessRuleId(
         pluginMetadata,
-        permission
+        accessRule
       );
 
-      // Apply permission filter if set
-      const filteredUserIds = permissionFilter
-        ? permissionFilter(userIds, qualifiedPermission)
+      // Apply access filter if set
+      const filteredUserIds = accessFilter
+        ? accessFilter(userIds, qualifiedAccessRule)
         : userIds;
 
       recordedSignals.push({
@@ -175,15 +175,15 @@ export function createMockSignalService(): MockSignalService {
         payload,
         targetType: "authorized",
         userIds: filteredUserIds,
-        permission: qualifiedPermission,
+        accessRule: qualifiedAccessRule,
         timestamp: new Date(),
       });
     },
 
-    setPermissionFilter(
-      filter: (userIds: string[], permission: string) => string[]
+    setAccessFilter(
+      filter: (userIds: string[], accessRule: string) => string[]
     ): void {
-      permissionFilter = filter;
+      accessFilter = filter;
     },
   };
 }