@turinhub/tale-js-sdk 1.3.0 → 2.0.0

package/README.md

@@ -1,4 +1,4 @@
-# @tale/client
+# @turinhub/tale-js-sdk
 
 官方 TypeScript SDK，用于与 Tale 后端服务集成与交互。
 
@@ -11,11 +11,11 @@
 支持 npm、pnpm、yarn 安装：
 
 ```bash
-npm install @tale/client
+npm install @turinhub/tale-js-sdk
 # 或
-pnpm add @tale/client
+pnpm add @turinhub/tale-js-sdk
 # 或
-yarn add @tale/client
+yarn add @turinhub/tale-js-sdk
 ```
 
 ## 快速开始
@@ -24,7 +24,7 @@ yarn add @tale/client
 
 ```ts
 // 具体导出以实际 SDK 为准（后续文档将补充）
-import * as Tale from "@tale/client";
+import * as Tale from "@turinhub/tale-js-sdk";
 
 // 示例：初始化客户端并调用 API（占位示例）
 // const client = Tale.createClient({ baseUrl: 'https://api.tale.example' })
@@ -49,7 +49,7 @@ pnpm test      # 对应 package.json 中的 "test": "jest"
 
 ## TODO
 
-- [ ] 修改 User Group 等分页格式，统一为 PageResponse。
+- [x] 修改 User Group 等分页格式，统一为 PageResponse。
 
 ## 许可证
 

package/dist/acl/index.d.ts

@@ -1,6 +1,7 @@
-import type { AclRecord, CreateAclRecordRequest, UpdateAclRecordRequest, ListAclRecordsRequest, AclBatchCreateResponse, AclTemplate, CreateAclTemplateRequest, UpdateAclTemplateRequest, ListAclTemplatesRequest, AclOptions } from "./types.js";
+import type { AclRecord, CreateAclRecordRequest, UpdateAclRecordRequest, ListAclRecordsRequest, AclBatchCreateResponse, AclBatchFailure, AclTemplate, CreateAclTemplateRequest, UpdateAclTemplateRequest, ListAclTemplatesRequest, AclOptions } from "./types.js";
 import type { PageResponse } from "../common/types.js";
-export type { AclRecord, CreateAclRecordRequest, UpdateAclRecordRequest, ListAclRecordsRequest, AclBatchCreateResponse, AclTemplate, CreateAclTemplateRequest, UpdateAclTemplateRequest, ListAclTemplatesRequest, AclOptions, };
+import type { Attachment } from "../attachment/types.js";
+export type { AclRecord, CreateAclRecordRequest, UpdateAclRecordRequest, ListAclRecordsRequest, AclBatchCreateResponse, AclBatchFailure, AclTemplate, CreateAclTemplateRequest, UpdateAclTemplateRequest, ListAclTemplatesRequest, AclOptions, };
 /**
  * Gets an ACL record by ID.
  *
@@ -13,11 +14,11 @@ export type { AclRecord, CreateAclRecordRequest, UpdateAclRecordRequest, ListAcl
  *
  * @example
  * ```typescript
- * import { getAclRecord } from '@tale/client';
+ * import { getAclRecord } from '@turinhub/tale-js-sdk';
  *
  * try {
- *   const record = await getAclRecord('record_id_here');
- *   console.log('Record effect:', record.effect_type);
+ *   const record = await getAclRecord('recordId_here');
+ *   console.log('Record effect:', record.effectType);
  * } catch (error) {
  *   console.error('Failed to get ACL record:', error.message);
  * }
@@ -35,13 +36,13 @@ export declare function getAclRecord(recordId: string, options?: AclOptions): Pr
  *
  * @example
  * ```typescript
- * import { listAclRecords } from '@tale/client';
+ * import { listAclRecords } from '@turinhub/tale-js-sdk';
  *
  * try {
  *   const result = await listAclRecords({
  *     page: 0,
  *     size: 20,
- *     resource_type: 'document'
+ *     resourceType: 'document'
  *   });
  *   console.log(`Found ${result.total} records`);
  * } catch (error) {
@@ -62,17 +63,17 @@ export declare function listAclRecords(options?: ListAclRecordsRequest & AclOpti
  *
  * @example
  * ```typescript
- * import { createAclRecord } from '@tale/client';
+ * import { createAclRecord } from '@turinhub/tale-js-sdk';
  *
  * try {
  *   const record = await createAclRecord({
- *     subject_type: 'user',
- *     subject_id: 'user123',
- *     resource_type: 'document',
- *     resource_id: 'doc456',
- *     effect_type: 'allow'
+ *     subjectType: 'user',
+ *     subjectId: 'user123',
+ *     resourceType: 'document',
+ *     resourceId: 'doc456',
+ *     effectType: 'allow'
  *   });
- *   console.log('Record created:', record.record_id);
+ *   console.log('Record created:', record.recordId);
  * } catch (error) {
  *   console.error('Failed to create ACL record:', error.message);
  * }
@@ -91,24 +92,24 @@ export declare function createAclRecord(request: CreateAclRecordRequest, options
  *
  * @example
  * ```typescript
- * import { batchCreateAclRecords } from '@tale/client';
+ * import { batchCreateAclRecords } from '@turinhub/tale-js-sdk';
  *
  * try {
  *   const result = await batchCreateAclRecords([
  *     {
- *       subject_type: 'user',
- *       subject_id: 'user1',
- *       resource_type: 'document',
- *       effect_type: 'allow'
+ *       subjectType: 'user',
+ *       subjectId: 'user1',
+ *       resourceType: 'document',
+ *       effectType: 'allow'
  *     },
  *     {
- *       subject_type: 'user',
- *       subject_id: 'user2',
- *       resource_type: 'document',
- *       effect_type: 'deny'
+ *       subjectType: 'user',
+ *       subjectId: 'user2',
+ *       resourceType: 'document',
+ *       effectType: 'deny'
  *     }
  *   ]);
- *   console.log(`Created ${result.success_count}, Failed ${result.failure_count}`);
+ *   console.log(`Created ${result.successCount}, Failed ${result.failureCount}`);
  * } catch (error) {
  *   console.error('Failed to batch create ACL records:', error.message);
  * }
@@ -128,14 +129,14 @@ export declare function batchCreateAclRecords(requests: CreateAclRecordRequest[]
  *
  * @example
  * ```typescript
- * import { updateAclRecord } from '@tale/client';
+ * import { updateAclRecord } from '@turinhub/tale-js-sdk';
  *
  * try {
- *   const record = await updateAclRecord('record_id_here', {
- *     effect_type: 'deny',
+ *   const record = await updateAclRecord('recordId_here', {
+ *     effectType: 'deny',
  *     priority: 100
  *   });
- *   console.log('Record updated:', record.record_id);
+ *   console.log('Record updated:', record.recordId);
  * } catch (error) {
  *   console.error('Failed to update ACL record:', error.message);
  * }
@@ -154,10 +155,10 @@ export declare function updateAclRecord(recordId: string, request: UpdateAclReco
  *
  * @example
  * ```typescript
- * import { deleteAclRecord } from '@tale/client';
+ * import { deleteAclRecord } from '@turinhub/tale-js-sdk';
  *
  * try {
- *   await deleteAclRecord('record_id_here');
+ *   await deleteAclRecord('recordId_here');
  *   console.log('ACL record deleted successfully');
  * } catch (error) {
  *   console.error('Failed to delete ACL record:', error.message);
@@ -177,11 +178,11 @@ export declare function deleteAclRecord(recordId: string, options?: AclOptions):
  *
  * @example
  * ```typescript
- * import { getAclTemplate } from '@tale/client';
+ * import { getAclTemplate } from '@turinhub/tale-js-sdk';
  *
  * try {
- *   const template = await getAclTemplate('template_code_here');
- *   console.log('Template name:', template.template_name);
+ *   const template = await getAclTemplate('templateCode_here');
+ *   console.log('Template name:', template.templateName);
  * } catch (error) {
  *   console.error('Failed to get ACL template:', error.message);
  * }
@@ -199,13 +200,13 @@ export declare function getAclTemplate(templateId: string, options?: AclOptions)
  *
  * @example
  * ```typescript
- * import { listAclTemplates } from '@tale/client';
+ * import { listAclTemplates } from '@turinhub/tale-js-sdk';
  *
  * try {
  *   const result = await listAclTemplates({
  *     page: 0,
  *     size: 20,
- *     resource_type: 'document'
+ *     resourceType: 'document'
  *   });
  *   console.log(`Found ${result.total} templates`);
  * } catch (error) {
@@ -226,17 +227,17 @@ export declare function listAclTemplates(options?: ListAclTemplatesRequest & Acl
  *
  * @example
  * ```typescript
- * import { createAclTemplate } from '@tale/client';
+ * import { createAclTemplate } from '@turinhub/tale-js-sdk';
  *
  * try {
  *   const template = await createAclTemplate({
- *     template_name: 'Document Access',
- *     template_code: 'doc_access',
- *     subject_type: 'user',
- *     resource_type: 'document',
- *     effect_type: 'allow'
+ *     templateName: 'Document Access',
+ *     templateCode: 'doc_access',
+ *     subjectType: 'user',
+ *     resourceType: 'document',
+ *     effectType: 'allow'
  *   });
- *   console.log('Template created:', template.template_id);
+ *   console.log('Template created:', template.templateId);
  * } catch (error) {
  *   console.error('Failed to create ACL template:', error.message);
  * }
@@ -256,14 +257,14 @@ export declare function createAclTemplate(request: CreateAclTemplateRequest, opt
  *
  * @example
  * ```typescript
- * import { updateAclTemplate } from '@tale/client';
+ * import { updateAclTemplate } from '@turinhub/tale-js-sdk';
  *
  * try {
- *   const template = await updateAclTemplate('template_code_here', {
- *     template_name: 'Updated Template Name',
- *     effect_type: 'deny'
+ *   const template = await updateAclTemplate('templateCode_here', {
+ *     templateName: 'Updated Template Name',
+ *     effectType: 'deny'
  *   });
- *   console.log('Template updated:', template.template_id);
+ *   console.log('Template updated:', template.templateId);
  * } catch (error) {
  *   console.error('Failed to update ACL template:', error.message);
  * }
@@ -282,10 +283,10 @@ export declare function updateAclTemplate(templateId: string, request: UpdateAcl
  *
  * @example
  * ```typescript
- * import { deleteAclTemplate } from '@tale/client';
+ * import { deleteAclTemplate } from '@turinhub/tale-js-sdk';
  *
  * try {
- *   await deleteAclTemplate('template_code_here');
+ *   await deleteAclTemplate('templateCode_here');
  *   console.log('ACL template deleted successfully');
  * } catch (error) {
  *   console.error('Failed to delete ACL template:', error.message);
@@ -293,3 +294,15 @@ export declare function updateAclTemplate(templateId: string, request: UpdateAcl
  * ```
  */
 export declare function deleteAclTemplate(templateId: string, options?: AclOptions): Promise<void>;
+/** List attachments for an ACL record */
+export declare function listAclRecordAttachments(recordId: string, options?: AclOptions & {
+    page?: number;
+    size?: number;
+    sort?: string;
+}): Promise<PageResponse<Attachment>>;
+/** Get a single attachment for an ACL record */
+export declare function getAclRecordAttachment(recordId: string, attachmentId: string, options?: AclOptions): Promise<Attachment>;
+/** Upload attachment for an ACL record */
+export declare function uploadAclRecordAttachment(recordId: string, attachmentTypeId: string, file: File | Blob, remark?: string, options?: AclOptions): Promise<Attachment>;
+/** Delete attachment from an ACL record */
+export declare function deleteAclRecordAttachment(recordId: string, attachmentId: string, options?: AclOptions): Promise<void>;