@turinhub/tale-js-sdk 1.3.0 → 2.0.0

package/dist/acl/index.js

@@ -31,11 +31,11 @@ function parseApiResponse(json, errorMessage, statusCode) {
  *
  * @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);
  * }
@@ -43,7 +43,7 @@ function parseApiResponse(json, errorMessage, statusCode) {
  */
 export async function getAclRecord(recordId, options) {
     if (!recordId || recordId.trim() === "") {
-        throw new ApiError("record_id is required", 400, "9400");
+        throw new ApiError("recordId is required", 400, "9400");
     }
     const token = options?.appToken ?? (await getAppToken(options));
     const env = globalThis?.process?.env ?? import.meta?.env ?? undefined;
@@ -80,13 +80,13 @@ export async function getAclRecord(recordId, options) {
  *
  * @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) {
@@ -143,31 +143,31 @@ export async function listAclRecords(options) {
  *
  * @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);
  * }
  * ```
  */
 export async function createAclRecord(request, options) {
-    if (!request.subject_type || request.subject_type.trim() === "") {
-        throw new ApiError("subject_type is required", 400, "9400");
+    if (!request.subjectType || request.subjectType.trim() === "") {
+        throw new ApiError("subjectType is required", 400, "9400");
     }
-    if (!request.resource_type || request.resource_type.trim() === "") {
-        throw new ApiError("resource_type is required", 400, "9400");
+    if (!request.resourceType || request.resourceType.trim() === "") {
+        throw new ApiError("resourceType is required", 400, "9400");
     }
-    if (!request.effect_type || request.effect_type.trim() === "") {
-        throw new ApiError("effect_type is required", 400, "9400");
+    if (!request.effectType || request.effectType.trim() === "") {
+        throw new ApiError("effectType is required", 400, "9400");
     }
     const token = options?.appToken ?? (await getAppToken(options));
     const env = globalThis?.process?.env ?? import.meta?.env ?? undefined;
@@ -205,24 +205,24 @@ export async function createAclRecord(request, 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);
  * }
@@ -269,14 +269,14 @@ export async function batchCreateAclRecords(requests, options) {
  *
  * @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);
  * }
@@ -284,7 +284,7 @@ export async function batchCreateAclRecords(requests, options) {
  */
 export async function updateAclRecord(recordId, request, options) {
     if (!recordId || recordId.trim() === "") {
-        throw new ApiError("record_id is required", 400, "9400");
+        throw new ApiError("recordId is required", 400, "9400");
     }
     const token = options?.appToken ?? (await getAppToken(options));
     const env = globalThis?.process?.env ?? import.meta?.env ?? undefined;
@@ -323,10 +323,10 @@ export async function updateAclRecord(recordId, request, options) {
  *
  * @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);
@@ -335,7 +335,7 @@ export async function updateAclRecord(recordId, request, options) {
  */
 export async function deleteAclRecord(recordId, options) {
     if (!recordId || recordId.trim() === "") {
-        throw new ApiError("record_id is required", 400, "9400");
+        throw new ApiError("recordId is required", 400, "9400");
     }
     const token = options?.appToken ?? (await getAppToken(options));
     const env = globalThis?.process?.env ?? import.meta?.env ?? undefined;
@@ -384,11 +384,11 @@ export async function deleteAclRecord(recordId, options) {
  *
  * @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);
  * }
@@ -396,7 +396,7 @@ export async function deleteAclRecord(recordId, options) {
  */
 export async function getAclTemplate(templateId, options) {
     if (!templateId || templateId.trim() === "") {
-        throw new ApiError("template_id is required", 400, "9400");
+        throw new ApiError("templateId is required", 400, "9400");
     }
     const token = options?.appToken ?? (await getAppToken(options));
     const env = globalThis?.process?.env ?? import.meta?.env ?? undefined;
@@ -405,7 +405,7 @@ export async function getAclTemplate(templateId, options) {
         throw new ConfigurationError("Missing required environment variable: TALE_BASE_URL");
     }
     const url = String(base).replace(/\/+$/, "") +
-        `/acl/v1/templates/${encodeURIComponent(templateId)}`;
+        `/acl/v2/templates/${encodeURIComponent(templateId)}`;
     let response;
     try {
         response = await globalThis.fetch(url, {
@@ -433,13 +433,13 @@ export async function getAclTemplate(templateId, options) {
  *
  * @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) {
@@ -496,28 +496,28 @@ export async function listAclTemplates(options) {
  *
  * @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);
  * }
  * ```
  */
 export async function createAclTemplate(request, options) {
-    if (!request.template_name || request.template_name.trim() === "") {
-        throw new ApiError("template_name is required", 400, "9400");
+    if (!request.templateName || request.templateName.trim() === "") {
+        throw new ApiError("templateName is required", 400, "9400");
     }
-    if (!request.template_code || request.template_code.trim() === "") {
-        throw new ApiError("template_code is required", 400, "9400");
+    if (!request.templateCode || request.templateCode.trim() === "") {
+        throw new ApiError("templateCode is required", 400, "9400");
     }
     const token = options?.appToken ?? (await getAppToken(options));
     const env = globalThis?.process?.env ?? import.meta?.env ?? undefined;
@@ -525,7 +525,7 @@ export async function createAclTemplate(request, options) {
     if (!base) {
         throw new ConfigurationError("Missing required environment variable: TALE_BASE_URL");
     }
-    const url = String(base).replace(/\/+$/, "") + "/acl/v1/templates";
+    const url = String(base).replace(/\/+$/, "") + "/acl/v2/templates";
     let response;
     try {
         response = await globalThis.fetch(url, {
@@ -556,14 +556,14 @@ export async function createAclTemplate(request, options) {
  *
  * @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);
  * }
@@ -571,7 +571,7 @@ export async function createAclTemplate(request, options) {
  */
 export async function updateAclTemplate(templateId, request, options) {
     if (!templateId || templateId.trim() === "") {
-        throw new ApiError("template_id is required", 400, "9400");
+        throw new ApiError("templateId is required", 400, "9400");
     }
     const token = options?.appToken ?? (await getAppToken(options));
     const env = globalThis?.process?.env ?? import.meta?.env ?? undefined;
@@ -580,7 +580,7 @@ export async function updateAclTemplate(templateId, request, options) {
         throw new ConfigurationError("Missing required environment variable: TALE_BASE_URL");
     }
     const url = String(base).replace(/\/+$/, "") +
-        `/acl/v1/templates/${encodeURIComponent(templateId)}`;
+        `/acl/v2/templates/${encodeURIComponent(templateId)}`;
     let response;
     try {
         response = await globalThis.fetch(url, {
@@ -610,10 +610,10 @@ export async function updateAclTemplate(templateId, request, options) {
  *
  * @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);
@@ -622,7 +622,7 @@ export async function updateAclTemplate(templateId, request, options) {
  */
 export async function deleteAclTemplate(templateId, options) {
     if (!templateId || templateId.trim() === "") {
-        throw new ApiError("template_id is required", 400, "9400");
+        throw new ApiError("templateId is required", 400, "9400");
     }
     const token = options?.appToken ?? (await getAppToken(options));
     const env = globalThis?.process?.env ?? import.meta?.env ?? undefined;
@@ -631,7 +631,7 @@ export async function deleteAclTemplate(templateId, options) {
         throw new ConfigurationError("Missing required environment variable: TALE_BASE_URL");
     }
     const url = String(base).replace(/\/+$/, "") +
-        `/acl/v1/templates/${encodeURIComponent(templateId)}`;
+        `/acl/v2/templates/${encodeURIComponent(templateId)}`;
     let response;
     try {
         response = await globalThis.fetch(url, {
@@ -651,3 +651,198 @@ export async function deleteAclTemplate(templateId, options) {
         throw new ApiError(errorMsg, response.status, json.code);
     }
 }
+// ==================== ACL Record Attachment Functions ====================
+/** List attachments for an ACL record */
+export async function listAclRecordAttachments(recordId, options) {
+    if (!recordId || recordId.trim() === "") {
+        throw new ApiError("recordId is required", 400, "9400");
+    }
+    const token = options?.appToken ?? (await getAppToken(options));
+    const env = globalThis?.process?.env ?? import.meta?.env ?? undefined;
+    const base = options?.baseUrl ?? env?.TALE_BASE_URL ?? undefined;
+    if (!base) {
+        throw new ConfigurationError("Missing required environment variable: TALE_BASE_URL");
+    }
+    const url = new URL(String(base).replace(/\/+$/, "") +
+        `/acl/v2/records/${encodeURIComponent(recordId)}/attachments`);
+    const { appToken, baseUrl, ...requestParams } = options || {};
+    const queryParams = {
+        page: 0,
+        size: 20,
+        sort: "createdAt,desc",
+        ...requestParams,
+    };
+    Object.entries(queryParams).forEach(([key, value]) => {
+        if (value !== undefined) {
+            url.searchParams.append(key, String(value));
+        }
+    });
+    let response;
+    try {
+        response = await globalThis.fetch(url.toString(), {
+            method: "GET",
+            headers: {
+                "Content-Type": "application/json",
+                "x-t-token": token,
+            },
+        });
+    }
+    catch (error) {
+        throw new NetworkError(`Failed to list ACL record attachments: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+    const json = await response.json();
+    if (typeof json !== "object" || json === null) {
+        throw new ApiError(`Invalid response: Failed to list ACL record attachments - not an object`, response.status);
+    }
+    const res = json;
+    if (res.code !== 200) {
+        const errorMsg = typeof res.msg === "string"
+            ? res.msg
+            : "Failed to list ACL record attachments";
+        throw new ApiError(errorMsg, response.status, res.code);
+    }
+    if (!res.data) {
+        throw new ApiError(`Invalid response: Failed to list ACL record attachments - missing data`, response.status);
+    }
+    return res.data;
+}
+/** Get a single attachment for an ACL record */
+export async function getAclRecordAttachment(recordId, attachmentId, options) {
+    if (!recordId || recordId.trim() === "") {
+        throw new ApiError("recordId is required", 400, "9400");
+    }
+    if (!attachmentId || attachmentId.trim() === "") {
+        throw new ApiError("attachmentId is required", 400, "9400");
+    }
+    const token = options?.appToken ?? (await getAppToken(options));
+    const env = globalThis?.process?.env ?? import.meta?.env ?? undefined;
+    const base = options?.baseUrl ?? env?.TALE_BASE_URL ?? undefined;
+    if (!base) {
+        throw new ConfigurationError("Missing required environment variable: TALE_BASE_URL");
+    }
+    const url = String(base).replace(/\/+$/, "") +
+        `/acl/v2/records/${encodeURIComponent(recordId)}/attachments/${encodeURIComponent(attachmentId)}`;
+    let response;
+    try {
+        response = await globalThis.fetch(url, {
+            method: "GET",
+            headers: {
+                "Content-Type": "application/json",
+                "x-t-token": token,
+            },
+        });
+    }
+    catch (error) {
+        throw new NetworkError(`Failed to get ACL record attachment: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+    const json = await response.json();
+    if (typeof json !== "object" || json === null) {
+        throw new ApiError(`Invalid response: Failed to get ACL record attachment - not an object`, response.status);
+    }
+    const res = json;
+    if (res.code !== 200) {
+        const errorMsg = typeof res.msg === "string"
+            ? res.msg
+            : "Failed to get ACL record attachment";
+        throw new ApiError(errorMsg, response.status, res.code);
+    }
+    if (!res.data) {
+        throw new ApiError(`Invalid response: Failed to get ACL record attachment - missing data`, response.status);
+    }
+    return res.data;
+}
+/** Upload attachment for an ACL record */
+export async function uploadAclRecordAttachment(recordId, attachmentTypeId, file, remark, options) {
+    if (!recordId || recordId.trim() === "") {
+        throw new ApiError("recordId is required", 400, "9400");
+    }
+    if (!attachmentTypeId || attachmentTypeId.trim() === "") {
+        throw new ApiError("attachmentTypeId is required", 400, "9400");
+    }
+    if (!file) {
+        throw new ApiError("file is required", 400, "9400");
+    }
+    const token = options?.appToken ?? (await getAppToken(options));
+    const env = globalThis?.process?.env ?? import.meta?.env ?? undefined;
+    const base = options?.baseUrl ?? env?.TALE_BASE_URL ?? undefined;
+    if (!base) {
+        throw new ConfigurationError("Missing required environment variable: TALE_BASE_URL");
+    }
+    const url = String(base).replace(/\/+$/, "") +
+        `/acl/v2/records/${encodeURIComponent(recordId)}/attachments/${encodeURIComponent(attachmentTypeId)}`;
+    const formData = new FormData();
+    if (typeof File !== "undefined" && file instanceof File) {
+        formData.append("file", file, file.name);
+    }
+    else {
+        formData.append("file", file);
+    }
+    if (remark) {
+        formData.append("remark", remark);
+    }
+    let response;
+    try {
+        response = await globalThis.fetch(url, {
+            method: "POST",
+            headers: {
+                "x-t-token": token,
+            },
+            body: formData,
+        });
+    }
+    catch (error) {
+        throw new NetworkError(`Failed to upload ACL record attachment: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+    const json = await response.json();
+    if (typeof json !== "object" || json === null) {
+        throw new ApiError(`Invalid response: Failed to upload ACL record attachment - not an object`, response.status);
+    }
+    const res = json;
+    if (res.code !== 200) {
+        const errorMsg = typeof res.msg === "string"
+            ? res.msg
+            : "Failed to upload ACL record attachment";
+        throw new ApiError(errorMsg, response.status, res.code);
+    }
+    if (!res.data) {
+        throw new ApiError(`Invalid response: Failed to upload ACL record attachment - missing data`, response.status);
+    }
+    return res.data;
+}
+/** Delete attachment from an ACL record */
+export async function deleteAclRecordAttachment(recordId, attachmentId, options) {
+    if (!recordId || recordId.trim() === "") {
+        throw new ApiError("recordId is required", 400, "9400");
+    }
+    if (!attachmentId || attachmentId.trim() === "") {
+        throw new ApiError("attachmentId is required", 400, "9400");
+    }
+    const token = options?.appToken ?? (await getAppToken(options));
+    const env = globalThis?.process?.env ?? import.meta?.env ?? undefined;
+    const base = options?.baseUrl ?? env?.TALE_BASE_URL ?? undefined;
+    if (!base) {
+        throw new ConfigurationError("Missing required environment variable: TALE_BASE_URL");
+    }
+    const url = String(base).replace(/\/+$/, "") +
+        `/acl/v2/records/${encodeURIComponent(recordId)}/attachments/${encodeURIComponent(attachmentId)}`;
+    let response;
+    try {
+        response = await globalThis.fetch(url, {
+            method: "DELETE",
+            headers: {
+                "Content-Type": "application/json",
+                "x-t-token": token,
+            },
+        });
+    }
+    catch (error) {
+        throw new NetworkError(`Failed to delete ACL record attachment: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+    const json = (await response.json());
+    if (json.code !== 200) {
+        const errorMsg = typeof json.msg === "string"
+            ? json.msg
+            : "Failed to delete ACL record attachment";
+        throw new ApiError(errorMsg, response.status, json.code);
+    }
+}