@twinfinity/permission 6.0.1 → 6.0.2

package/src/errors.ts

@@ -1,55 +1,55 @@
-import type { PermissionErrorBody } from './types';
-
-export class PermissionValidationError extends Error {
-    public readonly body: PermissionErrorBody | undefined;
-
-    constructor(message: string, body?: PermissionErrorBody) {
-        super(message);
-        this.name = 'PermissionValidationError';
-        this.body = body;
-    }
-}
-
-export class PermissionError extends Error {
-    public readonly status: number;
-    public readonly statusText: string;
-
-    constructor(message: string, status: number, statusText: string) {
-        super(message);
-        this.name = 'PermissionError';
-        this.status = status;
-        this.statusText = statusText;
-    }
-}
-
-export class PermissionNotFoundError extends Error {
-    public readonly body: PermissionErrorBody | undefined;
-
-    constructor(message: string, body?: PermissionErrorBody) {
-        super(message);
-        this.name = 'PermissionNotFoundError';
-        this.body = body;
-    }
-}
-
-export class PermissionForbiddenError extends Error {
-    public readonly body: PermissionErrorBody | undefined;
-
-    constructor(message: string, body?: PermissionErrorBody) {
-        super(message);
-        this.name = 'PermissionForbiddenError';
-        this.body = body;
-    }
-}
-
-export class PermissionConflictError<T = unknown> extends Error {
-    public readonly data: T | undefined;
-    public readonly body: PermissionErrorBody | undefined;
-
-    constructor(message: string, data: T | undefined, body?: PermissionErrorBody) {
-        super(message);
-        this.name = 'PermissionConflictError';
-        this.data = data;
-        this.body = body;
-    }
-}
+import type { PermissionErrorBody } from './types';
+
+export class PermissionValidationError extends Error {
+    public readonly body: PermissionErrorBody | undefined;
+
+    constructor(message: string, body?: PermissionErrorBody) {
+        super(message);
+        this.name = 'PermissionValidationError';
+        this.body = body;
+    }
+}
+
+export class PermissionError extends Error {
+    public readonly status: number;
+    public readonly statusText: string;
+
+    constructor(message: string, status: number, statusText: string) {
+        super(message);
+        this.name = 'PermissionError';
+        this.status = status;
+        this.statusText = statusText;
+    }
+}
+
+export class PermissionNotFoundError extends Error {
+    public readonly body: PermissionErrorBody | undefined;
+
+    constructor(message: string, body?: PermissionErrorBody) {
+        super(message);
+        this.name = 'PermissionNotFoundError';
+        this.body = body;
+    }
+}
+
+export class PermissionForbiddenError extends Error {
+    public readonly body: PermissionErrorBody | undefined;
+
+    constructor(message: string, body?: PermissionErrorBody) {
+        super(message);
+        this.name = 'PermissionForbiddenError';
+        this.body = body;
+    }
+}
+
+export class PermissionConflictError<T = unknown> extends Error {
+    public readonly data: T | undefined;
+    public readonly body: PermissionErrorBody | undefined;
+
+    constructor(message: string, data: T | undefined, body?: PermissionErrorBody) {
+        super(message);
+        this.name = 'PermissionConflictError';
+        this.data = data;
+        this.body = body;
+    }
+}

package/src/index.ts

@@ -1,3 +1,3 @@
-export { type IPermissionClient, PermissionClient } from './PermissionClient';
-export * from './types';
-export * from './errors';
+export { type IPermissionClient, PermissionClient } from './PermissionClient';
+export * from './types';
+export * from './errors';

package/src/types.ts

@@ -1,87 +1,87 @@
-export interface Pagination {
-    limit: number;
-    maxLimit: number;
-    nextPage: string | null;
-}
-
-export interface PaginatedResponse<T> {
-    data: T[];
-    pagination: Pagination;
-    /**
-     * The caller's effective permissions on the parent resource that governs every item in the
-     * page — populated by endpoints where the authorization subject is shared across all rows
-     * (currently `GET /groups/{id}/members`, where this reflects the caller's mask on the
-     * group's management scope). Absent for endpoints whose items each have their own
-     * authorization subject.
-     */
-    callerPermissions?: PrincipalPermission[];
-}
-
-export interface User {
-    id: string;
-    username: string;
-    email: string;
-    firstName: string | null;
-    lastName: string | null;
-}
-
-/**
- * A user returned from group-membership endpoints. Extends {@link User} with the target user's
- * effective permissions on the containing group's management scope, reflecting the post-mutation
- * state after an add/remove.
- */
-export interface GroupMember extends User {
-    permissions: PrincipalPermission[];
-}
-
-export enum PrincipalType {
-    Unknown = 'Unknown',
-    DomainGroup = 'DomainGroup',
-    Group = 'Group'
-}
-
-/**
- * The permission bits a subject can hold on a group's management scope.
- *
- * - `View` — can see the group and its basic metadata (title, description, display name).
- * - `Edit` — can create and modify groups.
- * - `Delete` — can delete the group.
- * - `ViewMembers` — can list the group's members.
- * - `ManagePermissions` — can update permissions connected to the group (e.g. grant another user Edit on it).
- */
-export type PrincipalPermission = 'View' | 'Edit' | 'Delete' | 'ViewMembers' | 'ManagePermissions';
-
-export interface Group {
-    id: string;
-    ownerSystem: string;
-    principalType: PrincipalType;
-    title: string;
-    displayName: string | null;
-    description: string | null;
-    etag: string;
-    isEditable: boolean;
-    /**
-     * The effective permission bits the relevant subject holds on this group's management scope.
-     * The subject is the caller on most endpoints, and the target user on `GET /users/{id}/groups`.
-     * An empty array means no permissions are granted.
-     */
-    permissions: PrincipalPermission[];
-}
-
-export interface PutGroupRequest {
-    /** Title for the group. Used on create; ignored on update (title is immutable). */
-    title: string;
-    displayName?: string | null;
-    description?: string | null;
-    etag?: string | null;
-}
-
-export interface DeleteGroupRequest {
-    etag: string;
-}
-
-export interface PermissionErrorBody {
-    detail: string;
-    cause: string;
-    item?: { kind: string; id?: string } | null;
-}
+export interface Pagination {
+    limit: number;
+    maxLimit: number;
+    nextPage: string | null;
+}
+
+export interface PaginatedResponse<T> {
+    data: T[];
+    pagination: Pagination;
+    /**
+     * The caller's effective permissions on the parent resource that governs every item in the
+     * page — populated by endpoints where the authorization subject is shared across all rows
+     * (currently `GET /groups/{id}/members`, where this reflects the caller's mask on the
+     * group's management scope). Absent for endpoints whose items each have their own
+     * authorization subject.
+     */
+    callerPermissions?: PrincipalPermission[];
+}
+
+export interface User {
+    id: string;
+    username: string;
+    email: string;
+    firstName: string | null;
+    lastName: string | null;
+}
+
+/**
+ * A user returned from group-membership endpoints. Extends {@link User} with the target user's
+ * effective permissions on the containing group's management scope, reflecting the post-mutation
+ * state after an add/remove.
+ */
+export interface GroupMember extends User {
+    permissions: PrincipalPermission[];
+}
+
+export enum PrincipalType {
+    Unknown = 'Unknown',
+    DomainGroup = 'DomainGroup',
+    Group = 'Group'
+}
+
+/**
+ * The permission bits a subject can hold on a group's management scope.
+ *
+ * - `View` — can see the group and its basic metadata (title, description, display name).
+ * - `Edit` — can create and modify groups.
+ * - `Delete` — can delete the group.
+ * - `ViewMembers` — can list the group's members.
+ * - `ManagePermissions` — can update permissions connected to the group (e.g. grant another user Edit on it).
+ */
+export type PrincipalPermission = 'View' | 'Edit' | 'Delete' | 'ViewMembers' | 'ManagePermissions';
+
+export interface Group {
+    id: string;
+    ownerSystem: string;
+    principalType: PrincipalType;
+    title: string;
+    displayName: string | null;
+    description: string | null;
+    etag: string;
+    isEditable: boolean;
+    /**
+     * The effective permission bits the relevant subject holds on this group's management scope.
+     * The subject is the caller on most endpoints, and the target user on `GET /users/{id}/groups`.
+     * An empty array means no permissions are granted.
+     */
+    permissions: PrincipalPermission[];
+}
+
+export interface PutGroupRequest {
+    /** Title for the group. Used on create; ignored on update (title is immutable). */
+    title: string;
+    displayName?: string | null;
+    description?: string | null;
+    etag?: string | null;
+}
+
+export interface DeleteGroupRequest {
+    etag: string;
+}
+
+export interface PermissionErrorBody {
+    detail: string;
+    cause: string;
+    item?: { kind: string; id?: string } | null;
+}