com-angel-authorization 1.0.0 → 1.0.1

package/dist/react/index.d.cts

@@ -116,4 +116,138 @@ interface CanProps {
  */
 declare function Can({ permission, role, mode, combine, children, fallback, }: CanProps): react.JSX.Element;
 
-export { Can, type CanProps, type CheckOptions, type MatchMode, type PermissionChecker, type PermissionCode, type PermissionListener, PermissionProvider, type PermissionProviderProps, type PermissionState, PermissionStore, type RoleCode, type UsePermissionResult, createPermissionStore, useHasPermission, useHasRole, usePermission };
+type PageDirection = 'previous' | 'current' | 'next';
+type ListPaginationParams = {
+    pageToken?: string;
+    pageSize?: string;
+    pageDirection?: PageDirection;
+};
+type ListPaginationResult = {
+    pageToken: string;
+    hasPreviousPage: boolean;
+    hasNextPage: boolean;
+};
+/** 权限点状态：1 启用，0 禁用 */
+type ResourceStatus = 0 | 1;
+type AuthorizationResource = {
+    resourceId: string;
+    type: 'api';
+    name: string;
+    identification: string;
+    status: ResourceStatus;
+    private: boolean;
+    description: string;
+};
+type AuthorizationResourceFormValues = {
+    name: string;
+    identification: string;
+    status: ResourceStatus;
+    private: boolean;
+    description: string;
+};
+type CreateAuthorizationResourceBody = AuthorizationResourceFormValues & {
+    resourceId: string;
+    type: 'api';
+};
+type UpdateAuthorizationResourceBody = Partial<AuthorizationResourceFormValues> & {
+    type?: 'api';
+};
+type FetchAuthorizationResourcesParams = {
+    pagination?: ListPaginationParams;
+};
+type AuthorizationResourceListResult = {
+    records: AuthorizationResource[];
+    pageToken: string;
+    hasPreviousPage: boolean;
+    hasNextPage: boolean;
+};
+declare const RESOURCE_TYPE_API: "api";
+declare const RESOURCE_STATUS_ENABLED: ResourceStatus;
+declare const RESOURCE_STATUS_DISABLED: ResourceStatus;
+declare const RESOURCE_STATUS_OPTIONS: {
+    label: string;
+    value: ResourceStatus;
+}[];
+declare const RESOURCE_PRIVATE_OPTIONS: {
+    label: string;
+    value: boolean;
+}[];
+
+type HttpMethod = 'GET' | 'POST' | 'PATCH' | 'DELETE';
+type ResourceRequestOptions = {
+    method: HttpMethod;
+    url: string;
+    body?: unknown;
+    signal?: AbortSignal;
+};
+/**
+ * 由宿主应用注入的请求函数（可对接 Angel_HGAMS 的 apiGetJson / apiPostJson 等）。
+ */
+type ResourceHttpRequest = <T = unknown>(options: ResourceRequestOptions) => Promise<T>;
+type AuthorizationResourceApi = {
+    list: (params?: FetchAuthorizationResourcesParams, signal?: AbortSignal) => Promise<AuthorizationResourceListResult>;
+    create: (values: AuthorizationResourceFormValues, signal?: AbortSignal) => Promise<unknown>;
+    update: (resourceId: string, values: AuthorizationResourceFormValues, signal?: AbortSignal) => Promise<unknown>;
+    remove: (resourceId: string, signal?: AbortSignal) => Promise<unknown>;
+};
+declare function mapAuthorizationResource(item: unknown): AuthorizationResource | null;
+declare function buildCreateBody(values: AuthorizationResourceFormValues, resourceId?: string): CreateAuthorizationResourceBody;
+declare function buildUpdateBody(values: AuthorizationResourceFormValues): UpdateAuthorizationResourceBody;
+declare function createAuthorizationResourceApi(request: ResourceHttpRequest): AuthorizationResourceApi;
+type CreateDefaultResourceRequestOptions = {
+    /** API 前缀，如 `/api` 或完整域名 */
+    baseUrl?: string;
+    /** 追加请求头（如 Authorization） */
+    getHeaders?: () => Record<string, string> | Promise<Record<string, string>>;
+    credentials?: RequestCredentials;
+};
+/**
+ * 基于 fetch 的默认请求实现，便于快速接入。
+ * 生产环境建议注入宿主应用已有的 request 封装。
+ */
+declare function createDefaultResourceRequest(options?: CreateDefaultResourceRequestOptions): ResourceHttpRequest;
+
+declare function appendQueryParam(parts: string[], key: string, value: string): void;
+declare function extractPagination(payload: unknown): ListPaginationResult;
+declare function extractRecords(payload: unknown): unknown[];
+
+type ResourceManagerProps = {
+    api: AuthorizationResourceApi;
+    title?: string;
+    pageSize?: string;
+    /** 自定义顶部右侧操作区 */
+    toolbarExtra?: ReactNode;
+};
+declare function ResourceManager({ api, title, pageSize: initialPageSize, toolbarExtra, }: ResourceManagerProps): react.JSX.Element;
+
+interface SnowyflakeOptions {
+    epoch?: bigint;
+    workerId?: bigint;
+    processId?: bigint;
+    workerIdBits?: number;
+    processIdBits?: number;
+    sequenceBits?: number;
+}
+/**
+ * snowyflake 2.0.1 仅支持固定 5+5+12 位布局，此处按相同 nextId 算法实现可配置位数版本。
+ */
+declare class ConfigurableSnowflake {
+    readonly epoch: bigint;
+    readonly workerId: bigint;
+    readonly processId: bigint;
+    private readonly sequenceMask;
+    private readonly timestampLeftShift;
+    private readonly workerIdShift;
+    private readonly processIdShift;
+    private sequence;
+    private latestTimestamp;
+    constructor({ epoch, workerId, processId, workerIdBits, processIdBits, sequenceBits, }?: SnowyflakeOptions);
+    nextId(): bigint;
+}
+/** 应用级单例，模块加载时只初始化一次（不受 React StrictMode 重复 mount 影响） */
+declare const snowyflake: ConfigurableSnowflake;
+/** 生成雪花 ID 字符串（reportId、detailId、resourceId 等） */
+declare function getAppClientId(): string;
+declare function getDeviceWorkerId(): string;
+
+export { type AuthorizationResource, type AuthorizationResourceApi, type AuthorizationResourceFormValues, type AuthorizationResourceListResult, Can, type CanProps, type CheckOptions, type CreateAuthorizationResourceBody, type CreateDefaultResourceRequestOptions, type FetchAuthorizationResourcesParams, type HttpMethod, type ListPaginationParams, type ListPaginationResult, type MatchMode, type PageDirection, type PermissionChecker, type PermissionCode, type PermissionListener, PermissionProvider, type PermissionProviderProps, type PermissionState, PermissionStore, RESOURCE_PRIVATE_OPTIONS, RESOURCE_STATUS_DISABLED, RESOURCE_STATUS_ENABLED, RESOURCE_STATUS_OPTIONS, RESOURCE_TYPE_API, type ResourceHttpRequest, ResourceManager, type ResourceManagerProps, type ResourceRequestOptions, type ResourceStatus, type RoleCode, type UpdateAuthorizationResourceBody, type UsePermissionResult, appendQueryParam, buildCreateBody, buildUpdateBody, createAuthorizationResourceApi, createDefaultResourceRequest, createPermissionStore, extractPagination, extractRecords, getAppClientId, getDeviceWorkerId, mapAuthorizationResource, snowyflake, useHasPermission, useHasRole, usePermission };

package/dist/react/index.d.ts

@@ -116,4 +116,138 @@ interface CanProps {
  */
 declare function Can({ permission, role, mode, combine, children, fallback, }: CanProps): react.JSX.Element;
 
-export { Can, type CanProps, type CheckOptions, type MatchMode, type PermissionChecker, type PermissionCode, type PermissionListener, PermissionProvider, type PermissionProviderProps, type PermissionState, PermissionStore, type RoleCode, type UsePermissionResult, createPermissionStore, useHasPermission, useHasRole, usePermission };
+type PageDirection = 'previous' | 'current' | 'next';
+type ListPaginationParams = {
+    pageToken?: string;
+    pageSize?: string;
+    pageDirection?: PageDirection;
+};
+type ListPaginationResult = {
+    pageToken: string;
+    hasPreviousPage: boolean;
+    hasNextPage: boolean;
+};
+/** 权限点状态：1 启用，0 禁用 */
+type ResourceStatus = 0 | 1;
+type AuthorizationResource = {
+    resourceId: string;
+    type: 'api';
+    name: string;
+    identification: string;
+    status: ResourceStatus;
+    private: boolean;
+    description: string;
+};
+type AuthorizationResourceFormValues = {
+    name: string;
+    identification: string;
+    status: ResourceStatus;
+    private: boolean;
+    description: string;
+};
+type CreateAuthorizationResourceBody = AuthorizationResourceFormValues & {
+    resourceId: string;
+    type: 'api';
+};
+type UpdateAuthorizationResourceBody = Partial<AuthorizationResourceFormValues> & {
+    type?: 'api';
+};
+type FetchAuthorizationResourcesParams = {
+    pagination?: ListPaginationParams;
+};
+type AuthorizationResourceListResult = {
+    records: AuthorizationResource[];
+    pageToken: string;
+    hasPreviousPage: boolean;
+    hasNextPage: boolean;
+};
+declare const RESOURCE_TYPE_API: "api";
+declare const RESOURCE_STATUS_ENABLED: ResourceStatus;
+declare const RESOURCE_STATUS_DISABLED: ResourceStatus;
+declare const RESOURCE_STATUS_OPTIONS: {
+    label: string;
+    value: ResourceStatus;
+}[];
+declare const RESOURCE_PRIVATE_OPTIONS: {
+    label: string;
+    value: boolean;
+}[];
+
+type HttpMethod = 'GET' | 'POST' | 'PATCH' | 'DELETE';
+type ResourceRequestOptions = {
+    method: HttpMethod;
+    url: string;
+    body?: unknown;
+    signal?: AbortSignal;
+};
+/**
+ * 由宿主应用注入的请求函数（可对接 Angel_HGAMS 的 apiGetJson / apiPostJson 等）。
+ */
+type ResourceHttpRequest = <T = unknown>(options: ResourceRequestOptions) => Promise<T>;
+type AuthorizationResourceApi = {
+    list: (params?: FetchAuthorizationResourcesParams, signal?: AbortSignal) => Promise<AuthorizationResourceListResult>;
+    create: (values: AuthorizationResourceFormValues, signal?: AbortSignal) => Promise<unknown>;
+    update: (resourceId: string, values: AuthorizationResourceFormValues, signal?: AbortSignal) => Promise<unknown>;
+    remove: (resourceId: string, signal?: AbortSignal) => Promise<unknown>;
+};
+declare function mapAuthorizationResource(item: unknown): AuthorizationResource | null;
+declare function buildCreateBody(values: AuthorizationResourceFormValues, resourceId?: string): CreateAuthorizationResourceBody;
+declare function buildUpdateBody(values: AuthorizationResourceFormValues): UpdateAuthorizationResourceBody;
+declare function createAuthorizationResourceApi(request: ResourceHttpRequest): AuthorizationResourceApi;
+type CreateDefaultResourceRequestOptions = {
+    /** API 前缀，如 `/api` 或完整域名 */
+    baseUrl?: string;
+    /** 追加请求头（如 Authorization） */
+    getHeaders?: () => Record<string, string> | Promise<Record<string, string>>;
+    credentials?: RequestCredentials;
+};
+/**
+ * 基于 fetch 的默认请求实现，便于快速接入。
+ * 生产环境建议注入宿主应用已有的 request 封装。
+ */
+declare function createDefaultResourceRequest(options?: CreateDefaultResourceRequestOptions): ResourceHttpRequest;
+
+declare function appendQueryParam(parts: string[], key: string, value: string): void;
+declare function extractPagination(payload: unknown): ListPaginationResult;
+declare function extractRecords(payload: unknown): unknown[];
+
+type ResourceManagerProps = {
+    api: AuthorizationResourceApi;
+    title?: string;
+    pageSize?: string;
+    /** 自定义顶部右侧操作区 */
+    toolbarExtra?: ReactNode;
+};
+declare function ResourceManager({ api, title, pageSize: initialPageSize, toolbarExtra, }: ResourceManagerProps): react.JSX.Element;
+
+interface SnowyflakeOptions {
+    epoch?: bigint;
+    workerId?: bigint;
+    processId?: bigint;
+    workerIdBits?: number;
+    processIdBits?: number;
+    sequenceBits?: number;
+}
+/**
+ * snowyflake 2.0.1 仅支持固定 5+5+12 位布局，此处按相同 nextId 算法实现可配置位数版本。
+ */
+declare class ConfigurableSnowflake {
+    readonly epoch: bigint;
+    readonly workerId: bigint;
+    readonly processId: bigint;
+    private readonly sequenceMask;
+    private readonly timestampLeftShift;
+    private readonly workerIdShift;
+    private readonly processIdShift;
+    private sequence;
+    private latestTimestamp;
+    constructor({ epoch, workerId, processId, workerIdBits, processIdBits, sequenceBits, }?: SnowyflakeOptions);
+    nextId(): bigint;
+}
+/** 应用级单例，模块加载时只初始化一次（不受 React StrictMode 重复 mount 影响） */
+declare const snowyflake: ConfigurableSnowflake;
+/** 生成雪花 ID 字符串（reportId、detailId、resourceId 等） */
+declare function getAppClientId(): string;
+declare function getDeviceWorkerId(): string;
+
+export { type AuthorizationResource, type AuthorizationResourceApi, type AuthorizationResourceFormValues, type AuthorizationResourceListResult, Can, type CanProps, type CheckOptions, type CreateAuthorizationResourceBody, type CreateDefaultResourceRequestOptions, type FetchAuthorizationResourcesParams, type HttpMethod, type ListPaginationParams, type ListPaginationResult, type MatchMode, type PageDirection, type PermissionChecker, type PermissionCode, type PermissionListener, PermissionProvider, type PermissionProviderProps, type PermissionState, PermissionStore, RESOURCE_PRIVATE_OPTIONS, RESOURCE_STATUS_DISABLED, RESOURCE_STATUS_ENABLED, RESOURCE_STATUS_OPTIONS, RESOURCE_TYPE_API, type ResourceHttpRequest, ResourceManager, type ResourceManagerProps, type ResourceRequestOptions, type ResourceStatus, type RoleCode, type UpdateAuthorizationResourceBody, type UsePermissionResult, appendQueryParam, buildCreateBody, buildUpdateBody, createAuthorizationResourceApi, createDefaultResourceRequest, createPermissionStore, extractPagination, extractRecords, getAppClientId, getDeviceWorkerId, mapAuthorizationResource, snowyflake, useHasPermission, useHasRole, usePermission };