codatta-frontier-sdk 0.1.4 → 0.1.6

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const d=require("axios");/*! js-cookie v3.0.5 | MIT */function u(r){for(var t=1;t<arguments.length;t++){var e=arguments[t];for(var n in e)r[n]=e[n]}return r}var g={read:function(r){return r[0]==='"'&&(r=r.slice(1,-1)),r.replace(/(%[\dA-F]{2})+/gi,decodeURIComponent)},write:function(r){return encodeURIComponent(r).replace(/%(2[346BF]|3[AC-F]|40|5[BDE]|60|7[BCD])/g,decodeURIComponent)}};function l(r,t){function e(o,i,s){if(!(typeof document>"u")){s=u({},t,s),typeof s.expires=="number"&&(s.expires=new Date(Date.now()+s.expires*864e5)),s.expires&&(s.expires=s.expires.toUTCString()),o=encodeURIComponent(o).replace(/%(2[346B]|5E|60|7C)/g,decodeURIComponent).replace(/[()]/g,escape);var c="";for(var a in s)s[a]&&(c+="; "+a,s[a]!==!0&&(c+="="+s[a].split(";")[0]));return document.cookie=o+"="+r.write(i,o)+c}}function n(o){if(!(typeof document>"u"||arguments.length&&!o)){for(var i=document.cookie?document.cookie.split("; "):[],s={},c=0;c<i.length;c++){var a=i[c].split("="),m=a.slice(1).join("=");try{var p=decodeURIComponent(a[0]);if(s[p]=r.read(m,p),o===p)break}catch{}}return o?s[o]:s}}return Object.create({set:e,get:n,remove:function(o,i){e(o,"",u({},i,{expires:-1}))},withAttributes:function(o){return l(this.converter,u({},this.attributes,o))},withConverter:function(o){return l(u({},this.converter,o),this.attributes)}},{attributes:{value:Object.freeze(t)},converter:{value:Object.freeze(r)}})}var h=l(g,{path:"/"});class v{constructor(){this.request=d.create({timeout:3e4}),this.setupRequestInterceptor(),this.setupResponseInterceptor()}setupRequestInterceptor(){this.request.interceptors.request.use(t=>{var s;const e=navigator.userAgent.toLowerCase(),n=e.includes("codatta")||((s=location.hash)==null?void 0:s.toLowerCase().includes("codatta")),o=h.get("auth")||localStorage.getItem("auth"),i=/android|webos|iphone|ipad|ipod|blackberry|iemobile|opera mini/i.test(e);return o&&(t.headers.token=o),t.headers.channel=n?"codatta-ios-app":"codatta-platform-website",t.headers.device=i?"mobile":"web",t})}setupResponseInterceptor(){this.request.interceptors.response.use(t=>{const e=t.data,n=Object.getOwnPropertyNames(e).includes("code"),o=Object.getOwnPropertyNames(e).includes("success");return n&&(e==null?void 0:e.code)!=="000000"?Promise.reject(new d.AxiosError(e==null?void 0:e.message,e==null?void 0:e.code,t.config,t.request,t)):o&&(e==null?void 0:e.success)!==!0?Promise.reject(new d.AxiosError(e==null?void 0:e.errorMessage,e==null?void 0:e.errorCode,t.config,t.request,t)):t},t=>{if(t.status===401){localStorage.removeItem("uid"),localStorage.removeItem("token"),localStorage.removeItem("auth");const e=new URL(window.location.href),n=e.pathname+e.search;window.location.href=`/account/signin?from=${encodeURIComponent(n)}`}return Promise.reject(t)})}async getTaskDetail(t){return(await this.request.post("/api/v2/frontier/task/detail",{task_id:t})).data}async submitTask(t,e){return(await this.request.post("/api/v2/frontier/task/submit",{task_id:t,data_submission:{data:e,task_id:t}})).data}async getTaskList(t){return(await this.request.post("/api/v2/frontier/task/list",t)).data}async getSubmissionList(t){return(await this.request.post("/api/v2/submission/list",t)).data}async getFrontierInfo(t){return(await this.request.get(`/api/v2/frontier/info?frontier_id=${t}`)).data}async getSubmissionDetail(t){return(await this.request.get("/api/v2/submission/user/detail",{params:{submission_id:t}})).data}async uploadFile(t,e){const n=new FormData;return n.append("file",t),(await this.request.post("/api/file/upload",n,{params:{content_type:t.type},onUploadProgress:e})).data}}var f=(r=>(r.TWITTER="x",r.TELEGRAM="telegram",r.DISCORD="discord",r.WEBSITE="website",r.DOC="doc",r))(f||{});exports.FrontierSDK=v;exports.MediaName=f;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const d=require("axios");/*! js-cookie v3.0.5 | MIT */function u(r){for(var e=1;e<arguments.length;e++){var t=arguments[e];for(var o in t)r[o]=t[o]}return r}var h={read:function(r){return r[0]==='"'&&(r=r.slice(1,-1)),r.replace(/(%[\dA-F]{2})+/gi,decodeURIComponent)},write:function(r){return encodeURIComponent(r).replace(/%(2[346BF]|3[AC-F]|40|5[BDE]|60|7[BCD])/g,decodeURIComponent)}};function l(r,e){function t(s,i,n){if(!(typeof document>"u")){n=u({},e,n),typeof n.expires=="number"&&(n.expires=new Date(Date.now()+n.expires*864e5)),n.expires&&(n.expires=n.expires.toUTCString()),s=encodeURIComponent(s).replace(/%(2[346B]|5E|60|7C)/g,decodeURIComponent).replace(/[()]/g,escape);var a="";for(var c in n)n[c]&&(a+="; "+c,n[c]!==!0&&(a+="="+n[c].split(";")[0]));return document.cookie=s+"="+r.write(i,s)+a}}function o(s){if(!(typeof document>"u"||arguments.length&&!s)){for(var i=document.cookie?document.cookie.split("; "):[],n={},a=0;a<i.length;a++){var c=i[a].split("="),m=c.slice(1).join("=");try{var p=decodeURIComponent(c[0]);if(n[p]=r.read(m,p),s===p)break}catch{}}return s?n[s]:n}}return Object.create({set:t,get:o,remove:function(s,i){t(s,"",u({},i,{expires:-1}))},withAttributes:function(s){return l(this.converter,u({},this.attributes,s))},withConverter:function(s){return l(u({},this.converter,s),this.attributes)}},{attributes:{value:Object.freeze(e)},converter:{value:Object.freeze(r)}})}var g=l(h,{path:"/"});class v{constructor(){this.request=d.create({timeout:3e4}),this.setupRequestInterceptor(),this.setupResponseInterceptor()}setupRequestInterceptor(){this.request.interceptors.request.use(e=>{var n;const t=navigator.userAgent.toLowerCase(),o=t.includes("codatta")||((n=location.hash)==null?void 0:n.toLowerCase().includes("codatta")),s=g.get("auth")||localStorage.getItem("auth"),i=/android|webos|iphone|ipad|ipod|blackberry|iemobile|opera mini/i.test(t);return s&&(e.headers.token=s),e.headers.channel=o?"codatta-ios-app":"codatta-platform-website",e.headers.device=i?"mobile":"web",e})}setupResponseInterceptor(){this.request.interceptors.response.use(e=>{const t=e.data,o=Object.getOwnPropertyNames(t).includes("code"),s=Object.getOwnPropertyNames(t).includes("success");return o&&(t==null?void 0:t.code)!=="000000"?Promise.reject(new d.AxiosError(t==null?void 0:t.message,t==null?void 0:t.code,e.config,e.request,e)):s&&(t==null?void 0:t.success)!==!0?Promise.reject(new d.AxiosError(t==null?void 0:t.errorMessage,t==null?void 0:t.errorCode,e.config,e.request,e)):e},e=>{if(e.status===401){localStorage.removeItem("uid"),localStorage.removeItem("token"),localStorage.removeItem("auth");const t=new URL(window.location.href),o=t.pathname+t.search;window.location.href=`/account/signin?from=${encodeURIComponent(o)}`}return Promise.reject(e)})}async getTaskDetail(e){return(await this.request.post("/api/v2/frontier/task/detail",{task_id:e})).data}async submitTask(e,t){return(await this.request.post("/api/v2/frontier/task/submit",{task_id:e,data_submission:{data:t,task_id:e}})).data}async getTaskList(e){return(await this.request.post("/api/v2/frontier/task/list",e)).data}async getSubmissionList(e){return(await this.request.post("/api/v2/submission/list",e)).data}async getFrontierInfo(e){return(await this.request.get(`/api/v2/frontier/info?frontier_id=${e}`)).data}async getSubmissionDetail(e){return(await this.request.get("/api/v2/submission/user/detail",{params:{submission_id:e}})).data}async uploadFile(e,t){const o=new FormData;return o.append("file",e),(await this.request.post("/api/file/upload",o,{params:{content_type:e.type},onUploadProgress:t})).data}async getSpecTaskInfo(e){return(await this.request.get(`/api/v2/spec/task/info?task_id=${e}`)).data}async getSpecTaskInfos(e){return(await this.request.get(`/api/v2/spec/task/infos?task_ids=${e}`)).data}async submitSpecTask(e,t,o){return(await this.request.post("/api/v2/spec/task/submit",{task_id:e,status:o??2,content:t})).data}async getVerificationCode({account_type:e,email:t,opt:o}){return(await this.request.post("/api/v2/user/get_code",{account_type:e??"email",email:t??"",opt:o??"verify"})).data.data}async checkEmail({email:e,code:t,task_id:o}){return(await this.request.post("/api/v2/frontier/email/check",{email:e,code:t,task_id:o})).data.data}}var f=(r=>(r.TWITTER="x",r.TELEGRAM="telegram",r.DISCORD="discord",r.WEBSITE="website",r.DOC="doc",r))(f||{});exports.FrontierSDK=v;exports.MediaName=f;

package/dist/index.d.ts

@@ -54,24 +54,114 @@ export declare class FrontierSDK {
     constructor();
     private setupRequestInterceptor;
     private setupResponseInterceptor;
+    /**
+     * Fetch the full detail of a frontier task.
+     * @param taskId - Unique task ID.
+     * @returns Task detail including display data, submission state, and reward info.
+     */
     getTaskDetail(taskId: string): Promise<Response_2<TaskDetail>>;
+    /**
+     * Submit user-provided data for a frontier task.
+     * @param taskId - Unique task ID.
+     * @param data - Submission payload. Shape depends on the task template.
+     * @returns Updated task detail after submission.
+     */
     submitTask(taskId: string, data: object): Promise<Response_2<TaskDetail>>;
+    /**
+     * Fetch a paginated list of tasks for a given frontier.
+     * @param params.frontier_id - The frontier to query tasks for.
+     * @param params.page_num - Page number (1-based).
+     * @param params.page_size - Number of tasks per page.
+     * @param params.task_types - Optional comma-separated task type filter (e.g. `'submission,validation'`).
+     * @returns Paginated list of task details.
+     */
     getTaskList(params: {
         frontier_id: string;
         page_num: number;
         page_size: number;
         task_types?: string;
     }): Promise<PaginationResponse<TaskDetail[]>>;
+    /**
+     * Fetch the current user's paginated submission history.
+     * @param data.page_num - Page number (1-based).
+     * @param data.page_size - Number of items per page.
+     * @param data.frontier_id - Optional filter by frontier ID.
+     * @param data.task_ids - Optional comma-separated list of task IDs to filter by.
+     * @returns Paginated list of submission records.
+     */
     getSubmissionList(data: TPagination & {
         frontier_id?: string;
         task_ids?: string;
     }): Promise<PaginationResponse<TaskDetail[]>>;
+    /**
+     * Fetch metadata and configuration for a frontier.
+     * @param frontierId - Unique frontier ID.
+     * @returns Frontier info including name, description, rewards, and media links.
+     */
     getFrontierInfo(frontierId: string): Promise<Response_2<FrontierItemType>>;
+    /**
+     * Fetch the detail of a single submission record.
+     * @param submissionId - Unique submission ID.
+     * @returns Full submission record including status, rating, and rewards.
+     */
     getSubmissionDetail(submissionId: string): Promise<Response_2<SubmissionRecord>>;
+    /**
+     * Upload a file to the Codatta file service.
+     * @param file - The `File` object to upload.
+     * @param onProgress - Optional callback invoked during upload with Axios progress events.
+     * @returns An object containing `file_path` (server-side storage path) and `original_name`.
+     */
     uploadFile(file: File, onProgress?: (event: AxiosProgressEvent) => void): Promise<{
         file_path: string;
         original_name: string;
     }>;
+    /**
+     * Fetch the info of a single spec task.
+     * @param taskId - Unique task ID.
+     * @returns Task info including status (`1` = pending, `2` = completed) and optional content.
+     */
+    getSpecTaskInfo(taskId: string): Promise<Response_2<TaskInfo>>;
+    /**
+     * Fetch info for multiple spec tasks in a single request.
+     * @param taskIds - Comma-separated list of task IDs (e.g. `'id1,id2,id3'`).
+     * @returns Array of task info objects.
+     */
+    getSpecTaskInfos(taskIds: string): Promise<Response_2<TaskInfo[]>>;
+    /**
+     * Submit or update a spec task.
+     * @param taskId - Unique task ID.
+     * @param content - Optional freeform content to attach to the submission.
+     * @param status - Submission status: `1` = reject, `2` = accept (default `2`).
+     * @returns Updated task info after submission.
+     */
+    submitSpecTask(taskId: string, content?: string, status?: 1 | 2): Promise<Response_2<TaskInfo>>;
+    /**
+     * Request a verification code to be sent to the user's account.
+     * @param params.account_type - Account type. Accepted values: `'email'` (default) | `'block_chain'`.
+     * @param params.email - Target email address (e.g. `'xxx@gmail.com'`). Required when `account_type` is `'email'`.
+     * @param params.opt - Operation type: `'verify'` (default) for email verification, `'vivolight'` for vivolight-related operations.
+     * @returns The verification code string (relay it to `checkEmail` to complete verification).
+     */
+    getVerificationCode({ account_type, email, opt }: {
+        account_type?: string;
+        email?: string;
+        opt?: string;
+    }): Promise<string>;
+    /**
+     * Verify a user's email address against a task requirement.
+     * @param params.email - The email address to verify.
+     * @param params.code - The verification code obtained via `getVerificationCode`.
+     * @param params.task_id - The task ID that requires email verification.
+     * @returns `{ flag: true }` if verification passed; `{ flag: false, info: '<reason>' }` otherwise.
+     */
+    checkEmail({ email, code, task_id }: {
+        email: string;
+        code: string;
+        task_id: string;
+    }): Promise<{
+        flag: boolean;
+        info: string;
+    }>;
 }
 
 export declare enum MediaName {
@@ -82,32 +172,65 @@ export declare enum MediaName {
     DOC = "doc"
 }
 
+/**
+ * Standard paginated response wrapper.
+ * @template T - The type of the `data` payload (usually an array).
+ */
 export declare interface PaginationResponse<T> {
+    /** The paginated data payload. */
     data: T;
+    /** Total number of items matching the query. */
     total: number;
+    /** Current page number, 1-based. */
     page_num: number;
+    /** Number of items per page. */
     page_size: number;
 }
 
 export declare type RankingGrade = 'S' | 'A' | 'B' | 'C' | 'D';
 
+/**
+ * Standard API response wrapper.
+ * @template T - The type of the `data` payload.
+ */
 declare interface Response_2<T> {
+    /** The actual response payload. */
     data: T;
+    /** Whether the request succeeded. Always `true` on success; rejection is handled via `errorCode`. */
     success: true;
+    /** Error code returned by the server when `success` is false. */
     errorCode: number;
+    /** Human-readable error message returned by the server when `success` is false. */
     errorMessage: string;
 }
 export { Response_2 as Response }
 
+/**
+ * A historical submission record returned by the submission list / detail endpoints.
+ */
 export declare interface SubmissionRecord {
+    /** Submission timestamp (Unix ms). */
     submission_time: number;
+    /** Display name of the frontier the task belongs to. */
     frontier_name: string;
+    /** Display name of the submitted task. */
     task_name: string;
+    /** Numeric review score. */
     result: number;
+    /** Letter grade derived from the review score (`S` > `A` > `B` > `C` > `D`). */
     rating_name: RankingGrade;
+    /**
+     * Submission review status:
+     * - `'PENDING'`: awaiting review
+     * - `'ADOPT'`: accepted and rewarded
+     * - `'REFUSED'`: rejected by reviewer
+     */
     status: 'ADOPT' | 'PENDING' | 'REFUSED';
+    /** Unique submission ID. */
     submission_id: string;
+    /** Rewards earned for this submission. */
     rewards: SubmissionReward[];
+    /** The original data submitted by the user, if available. */
     data_submission?: {
         data: {
             [key: string]: unknown;
@@ -122,14 +245,25 @@ export declare interface SubmissionReward {
     reward_amount: number;
 }
 
+/**
+ * Full detail of a frontier task, including display data, submission state, and reward info.
+ */
 export declare interface TaskDetail {
+    /** ID of the frontier this task belongs to. */
     frontier_id: string;
+    /** Unique task ID. */
     task_id: string;
+    /** Display name of the task. */
     name: string;
+    /** Task creation timestamp (Unix ms). */
     create_time: number;
+    /** Associated submission ID, if any. */
     submission_id: string;
+    /** Internal task type identifier (e.g. `'submission'`, `'validation'`). */
     task_type: string;
+    /** Human-readable task type name (e.g. `'Contribute'`, `'Review'`). */
     task_type_name: string;
+    /** Template ID used to render this task. */
     template_id: string;
     data_display: {
         gif_resource: string;
@@ -147,23 +281,74 @@ export declare interface TaskDetail {
         [key: string]: unknown;
         lifelog_report?: string;
     };
+    /**
+     * Question group availability:
+     * - `1`: questions available
+     * - `2`: no more questions in this group
+     * - `3`: need to switch question group
+     */
     question_status?: number;
     data_requirements: unknown;
+    /** List of reward configurations for this task. */
     reward_info: readonly TaskRewardInfo[];
     qualification_datas: unknown[];
+    /**
+     * Current task submission status:
+     * - `'PENDING'`: submitted, awaiting review
+     * - `'SUBMITTED'`: confirmed on-chain
+     * - `'REFUSED'`: rejected by reviewer
+     * - `'ADOPT'`: accepted and rewarded
+     */
     status: 'PENDING' | 'SUBMITTED' | 'REFUSED' | 'ADOPT';
+    /** Block explorer URL for the on-chain transaction. */
     txHashUrl: string;
+    /** Quality grading result after review (`S` > `A` > `B` > `C` > `D`). */
     result: RankingGrade;
+    /**
+     * On-chain processing status:
+     * - `0`: not submitted
+     * - `1`: pending
+     * - `2`: processing
+     * - `3`: confirmed
+     * - `4`: failed
+     */
     chain_status: 0 | 1 | 2 | 3 | 4;
     qualification?: string;
+    /** Whether the user meets the qualification requirement: `0` = no, `1` = yes. */
     qualification_flag: 0 | 1;
+    /** User reputation score at submission time. */
     reputation: number;
+    /** Reward points earned for this task. `null` if not yet settled. */
     reward_points: null | number;
+    /**
+     * User reputation check flag:
+     * - `0`: not checked
+     * - `1`: passed
+     * - `2`: failed
+     */
     user_reputation_flag: 0 | 1 | 2;
+    /** Tags associated with this task. */
     tags: string[];
+    /** Reason provided by reviewer when the task is refused. */
     audit_reason?: string;
 }
 
+/**
+ * Basic info for a spec task, used by the `/v2/spec/task/*` endpoints.
+ */
+export declare interface TaskInfo {
+    /** Unique task ID. */
+    task_id: string;
+    /**
+     * Task processing status:
+     * - `1`: pending / to be processed
+     * - `2`: completed / accepted
+     */
+    status: 1 | 2;
+    /** Optional freeform content submitted with the task. */
+    content?: string;
+}
+
 export declare interface TaskRewardInfo {
     reward_icon: string;
     reward_mode: string;
@@ -175,8 +360,13 @@ export declare type TaskType = 'submission' | 'validation';
 
 export declare type TaskTypeName = 'Contribute' | 'Review';
 
+/**
+ * Common pagination parameters used in list API requests.
+ */
 export declare interface TPagination {
+    /** Current page number, 1-based. */
     page_num: number;
+    /** Number of items per page. */
     page_size: number;
 }
 

package/dist/index.mjs

@@ -1,10 +1,10 @@
-import m, { AxiosError as l } from "axios";
+import m, { AxiosError as f } from "axios";
 /*! js-cookie v3.0.5 | MIT */
 function u(r) {
-  for (var t = 1; t < arguments.length; t++) {
-    var e = arguments[t];
-    for (var n in e)
-      r[n] = e[n];
+  for (var e = 1; e < arguments.length; e++) {
+    var t = arguments[e];
+    for (var o in t)
+      r[o] = t[o];
   }
   return r;
 }
@@ -19,36 +19,36 @@ var h = {
     );
   }
 };
-function d(r, t) {
-  function e(s, i, o) {
+function d(r, e) {
+  function t(s, i, n) {
     if (!(typeof document > "u")) {
-      o = u({}, t, o), typeof o.expires == "number" && (o.expires = new Date(Date.now() + o.expires * 864e5)), o.expires && (o.expires = o.expires.toUTCString()), s = encodeURIComponent(s).replace(/%(2[346B]|5E|60|7C)/g, decodeURIComponent).replace(/[()]/g, escape);
-      var c = "";
-      for (var a in o)
-        o[a] && (c += "; " + a, o[a] !== !0 && (c += "=" + o[a].split(";")[0]));
-      return document.cookie = s + "=" + r.write(i, s) + c;
+      n = u({}, e, n), typeof n.expires == "number" && (n.expires = new Date(Date.now() + n.expires * 864e5)), n.expires && (n.expires = n.expires.toUTCString()), s = encodeURIComponent(s).replace(/%(2[346B]|5E|60|7C)/g, decodeURIComponent).replace(/[()]/g, escape);
+      var a = "";
+      for (var c in n)
+        n[c] && (a += "; " + c, n[c] !== !0 && (a += "=" + n[c].split(";")[0]));
+      return document.cookie = s + "=" + r.write(i, s) + a;
     }
   }
-  function n(s) {
+  function o(s) {
     if (!(typeof document > "u" || arguments.length && !s)) {
-      for (var i = document.cookie ? document.cookie.split("; ") : [], o = {}, c = 0; c < i.length; c++) {
-        var a = i[c].split("="), f = a.slice(1).join("=");
+      for (var i = document.cookie ? document.cookie.split("; ") : [], n = {}, a = 0; a < i.length; a++) {
+        var c = i[a].split("="), l = c.slice(1).join("=");
         try {
-          var p = decodeURIComponent(a[0]);
-          if (o[p] = r.read(f, p), s === p)
+          var p = decodeURIComponent(c[0]);
+          if (n[p] = r.read(l, p), s === p)
             break;
         } catch {
         }
       }
-      return s ? o[s] : o;
+      return s ? n[s] : n;
     }
   }
   return Object.create(
     {
-      set: e,
-      get: n,
+      set: t,
+      get: o,
       remove: function(s, i) {
-        e(
+        t(
           s,
           "",
           u({}, i, {
@@ -64,13 +64,13 @@ function d(r, t) {
       }
     },
     {
-      attributes: { value: Object.freeze(t) },
+      attributes: { value: Object.freeze(e) },
       converter: { value: Object.freeze(r) }
     }
   );
 }
 var g = d(h, { path: "/" });
-class I {
+class y {
   constructor() {
     this.request = m.create({
       timeout: 3e4
@@ -78,65 +78,174 @@ class I {
   }
   // ─── Interceptors ──────────────────────────────────────────────────────────
   setupRequestInterceptor() {
-    this.request.interceptors.request.use((t) => {
-      var o;
-      const e = navigator.userAgent.toLowerCase(), n = e.includes("codatta") || ((o = location.hash) == null ? void 0 : o.toLowerCase().includes("codatta")), s = g.get("auth") || localStorage.getItem("auth"), i = /android|webos|iphone|ipad|ipod|blackberry|iemobile|opera mini/i.test(e);
-      return s && (t.headers.token = s), t.headers.channel = n ? "codatta-ios-app" : "codatta-platform-website", t.headers.device = i ? "mobile" : "web", t;
+    this.request.interceptors.request.use((e) => {
+      var n;
+      const t = navigator.userAgent.toLowerCase(), o = t.includes("codatta") || ((n = location.hash) == null ? void 0 : n.toLowerCase().includes("codatta")), s = g.get("auth") || localStorage.getItem("auth"), i = /android|webos|iphone|ipad|ipod|blackberry|iemobile|opera mini/i.test(t);
+      return s && (e.headers.token = s), e.headers.channel = o ? "codatta-ios-app" : "codatta-platform-website", e.headers.device = i ? "mobile" : "web", e;
     });
   }
   setupResponseInterceptor() {
     this.request.interceptors.response.use(
-      (t) => {
-        const e = t.data, n = Object.getOwnPropertyNames(e).includes("code"), s = Object.getOwnPropertyNames(e).includes("success");
-        return n && (e == null ? void 0 : e.code) !== "000000" ? Promise.reject(new l(e == null ? void 0 : e.message, e == null ? void 0 : e.code, t.config, t.request, t)) : s && (e == null ? void 0 : e.success) !== !0 ? Promise.reject(new l(e == null ? void 0 : e.errorMessage, e == null ? void 0 : e.errorCode, t.config, t.request, t)) : t;
+      (e) => {
+        const t = e.data, o = Object.getOwnPropertyNames(t).includes("code"), s = Object.getOwnPropertyNames(t).includes("success");
+        return o && (t == null ? void 0 : t.code) !== "000000" ? Promise.reject(new f(t == null ? void 0 : t.message, t == null ? void 0 : t.code, e.config, e.request, e)) : s && (t == null ? void 0 : t.success) !== !0 ? Promise.reject(new f(t == null ? void 0 : t.errorMessage, t == null ? void 0 : t.errorCode, e.config, e.request, e)) : e;
       },
-      (t) => {
-        if (t.status === 401) {
+      (e) => {
+        if (e.status === 401) {
           localStorage.removeItem("uid"), localStorage.removeItem("token"), localStorage.removeItem("auth");
-          const e = new URL(window.location.href), n = e.pathname + e.search;
-          window.location.href = `/account/signin?from=${encodeURIComponent(n)}`;
+          const t = new URL(window.location.href), o = t.pathname + t.search;
+          window.location.href = `/account/signin?from=${encodeURIComponent(o)}`;
         }
-        return Promise.reject(t);
+        return Promise.reject(e);
       }
     );
   }
   // ─── API Methods ───────────────────────────────────────────────────────────
-  async getTaskDetail(t) {
-    return (await this.request.post("/api/v2/frontier/task/detail", { task_id: t })).data;
+  /**
+   * Fetch the full detail of a frontier task.
+   * @param taskId - Unique task ID.
+   * @returns Task detail including display data, submission state, and reward info.
+   */
+  async getTaskDetail(e) {
+    return (await this.request.post("/api/v2/frontier/task/detail", { task_id: e })).data;
   }
-  async submitTask(t, e) {
+  /**
+   * Submit user-provided data for a frontier task.
+   * @param taskId - Unique task ID.
+   * @param data - Submission payload. Shape depends on the task template.
+   * @returns Updated task detail after submission.
+   */
+  async submitTask(e, t) {
     return (await this.request.post("/api/v2/frontier/task/submit", {
-      task_id: t,
+      task_id: e,
       data_submission: {
-        data: e,
-        task_id: t
+        data: t,
+        task_id: e
       }
     })).data;
   }
-  async getTaskList(t) {
-    return (await this.request.post("/api/v2/frontier/task/list", t)).data;
+  /**
+   * Fetch a paginated list of tasks for a given frontier.
+   * @param params.frontier_id - The frontier to query tasks for.
+   * @param params.page_num - Page number (1-based).
+   * @param params.page_size - Number of tasks per page.
+   * @param params.task_types - Optional comma-separated task type filter (e.g. `'submission,validation'`).
+   * @returns Paginated list of task details.
+   */
+  async getTaskList(e) {
+    return (await this.request.post("/api/v2/frontier/task/list", e)).data;
   }
-  async getSubmissionList(t) {
-    return (await this.request.post("/api/v2/submission/list", t)).data;
+  /**
+   * Fetch the current user's paginated submission history.
+   * @param data.page_num - Page number (1-based).
+   * @param data.page_size - Number of items per page.
+   * @param data.frontier_id - Optional filter by frontier ID.
+   * @param data.task_ids - Optional comma-separated list of task IDs to filter by.
+   * @returns Paginated list of submission records.
+   */
+  async getSubmissionList(e) {
+    return (await this.request.post("/api/v2/submission/list", e)).data;
   }
-  async getFrontierInfo(t) {
-    return (await this.request.get(`/api/v2/frontier/info?frontier_id=${t}`)).data;
+  /**
+   * Fetch metadata and configuration for a frontier.
+   * @param frontierId - Unique frontier ID.
+   * @returns Frontier info including name, description, rewards, and media links.
+   */
+  async getFrontierInfo(e) {
+    return (await this.request.get(`/api/v2/frontier/info?frontier_id=${e}`)).data;
   }
-  async getSubmissionDetail(t) {
+  /**
+   * Fetch the detail of a single submission record.
+   * @param submissionId - Unique submission ID.
+   * @returns Full submission record including status, rating, and rewards.
+   */
+  async getSubmissionDetail(e) {
     return (await this.request.get("/api/v2/submission/user/detail", {
-      params: { submission_id: t }
+      params: { submission_id: e }
     })).data;
   }
-  async uploadFile(t, e) {
-    const n = new FormData();
-    return n.append("file", t), (await this.request.post("/api/file/upload", n, {
-      params: { content_type: t.type },
-      onUploadProgress: e
+  /**
+   * Upload a file to the Codatta file service.
+   * @param file - The `File` object to upload.
+   * @param onProgress - Optional callback invoked during upload with Axios progress events.
+   * @returns An object containing `file_path` (server-side storage path) and `original_name`.
+   */
+  async uploadFile(e, t) {
+    const o = new FormData();
+    return o.append("file", e), (await this.request.post("/api/file/upload", o, {
+      params: { content_type: e.type },
+      onUploadProgress: t
     })).data;
   }
+  /**
+   * Fetch the info of a single spec task.
+   * @param taskId - Unique task ID.
+   * @returns Task info including status (`1` = pending, `2` = completed) and optional content.
+   */
+  async getSpecTaskInfo(e) {
+    return (await this.request.get(`/api/v2/spec/task/info?task_id=${e}`)).data;
+  }
+  /**
+   * Fetch info for multiple spec tasks in a single request.
+   * @param taskIds - Comma-separated list of task IDs (e.g. `'id1,id2,id3'`).
+   * @returns Array of task info objects.
+   */
+  async getSpecTaskInfos(e) {
+    return (await this.request.get(`/api/v2/spec/task/infos?task_ids=${e}`)).data;
+  }
+  /**
+   * Submit or update a spec task.
+   * @param taskId - Unique task ID.
+   * @param content - Optional freeform content to attach to the submission.
+   * @param status - Submission status: `1` = reject, `2` = accept (default `2`).
+   * @returns Updated task info after submission.
+   */
+  async submitSpecTask(e, t, o) {
+    return (await this.request.post("/api/v2/spec/task/submit", {
+      task_id: e,
+      status: o ?? 2,
+      content: t
+    })).data;
+  }
+  /**
+   * Request a verification code to be sent to the user's account.
+   * @param params.account_type - Account type. Accepted values: `'email'` (default) | `'block_chain'`.
+   * @param params.email - Target email address (e.g. `'xxx@gmail.com'`). Required when `account_type` is `'email'`.
+   * @param params.opt - Operation type: `'verify'` (default) for email verification, `'vivolight'` for vivolight-related operations.
+   * @returns The verification code string (relay it to `checkEmail` to complete verification).
+   */
+  async getVerificationCode({
+    account_type: e,
+    email: t,
+    opt: o
+  }) {
+    return (await this.request.post("/api/v2/user/get_code", {
+      account_type: e ?? "email",
+      email: t ?? "",
+      opt: o ?? "verify"
+    })).data.data;
+  }
+  /**
+   * Verify a user's email address against a task requirement.
+   * @param params.email - The email address to verify.
+   * @param params.code - The verification code obtained via `getVerificationCode`.
+   * @param params.task_id - The task ID that requires email verification.
+   * @returns `{ flag: true }` if verification passed; `{ flag: false, info: '<reason>' }` otherwise.
+   */
+  async checkEmail({
+    email: e,
+    code: t,
+    task_id: o
+  }) {
+    return (await this.request.post("/api/v2/frontier/email/check", {
+      email: e,
+      code: t,
+      task_id: o
+    })).data.data;
+  }
 }
-var w = /* @__PURE__ */ ((r) => (r.TWITTER = "x", r.TELEGRAM = "telegram", r.DISCORD = "discord", r.WEBSITE = "website", r.DOC = "doc", r))(w || {});
+var v = /* @__PURE__ */ ((r) => (r.TWITTER = "x", r.TELEGRAM = "telegram", r.DISCORD = "discord", r.WEBSITE = "website", r.DOC = "doc", r))(v || {});
 export {
-  I as FrontierSDK,
-  w as MediaName
+  y as FrontierSDK,
+  v as MediaName
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codatta-frontier-sdk",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Codatta Frontier SDK - API client for Codatta Frontier platform",
   "type": "module",
   "main": "./dist/index.cjs",