@vtecx/vtecxnext 2.1.2 → 2.2.0

package/dist/vtecxnext.d.ts

@@ -5,10 +5,26 @@ import type { Readable } from 'node:stream';
  * Hello world.
  */
 export declare const hello: () => void;
-type StatusMessage = {
+export type StatusMessage = {
     status: number;
     message: string;
 };
+export type AdduserInfo = {
+    username?: string;
+    pswd?: string;
+    nickname?: string;
+    emailSubject?: string;
+    emailText?: string;
+    emailHtml?: string;
+};
+export type ChangepassByAdminInfo = {
+    uid: string;
+    pswd: string;
+};
+export type CreateGroupadminInfo = {
+    group: string;
+    uids: string[];
+};
 export declare class VtecxNext {
     /** Request */
     readonly req: NextRequest;
@@ -47,6 +63,12 @@ export declare class VtecxNext {
      * @returns null、undefined、空文字の場合true
      */
     isBlank: (val: any) => boolean;
+    /**
+     * undefined、nullを空文字に変換
+     * @param val 文字列
+     * @returns 変換した文字列
+     */
+    null2blank: (val: string | undefined | null) => string;
     /**
      * X-Requested-With header check.
      * If not specified, set status 417 to the response.
@@ -416,7 +438,7 @@ export declare class VtecxNext {
      * @param tablenames key:entity's prop name, value:BigQuery table name
      * @return registed entries
      */
-    postBDBQ: (feed: any, uri?: string, tablenames?: any) => Promise<boolean>;
+    postBDBQ: (feed: any, uri?: string, tablenames?: any) => Promise<any>;
     /**
      * put data to bdb and post bigquery
      * @param feed entries (JSON)
@@ -538,13 +560,30 @@ export declare class VtecxNext {
      * @return feed
      */
     getMessageQueue: (channel: string) => Promise<any>;
+    /**
+     * add group
+     * (not yet joined)
+     * @param group group
+     * @param selfid hierarchical name under my group alias
+     * @return feed
+     */
+    addGroup: (group: string, selfid?: string) => Promise<any>;
+    /**
+     * add group by admin
+     * (not yet joined)
+     * @param uids uid list
+     * @param group group
+     * @param selfid hierarchical name under my group alias
+     * @return feed
+     */
+    addGroupByAdmin: (uids: string[], group: string, selfid?: string) => Promise<any>;
     /**
      * join to the group
      * @param group group
      * @param selfid hierarchical name under my group alias
      * @return feed
      */
-    joinGroup: (group: string, selfid: string) => Promise<any>;
+    joinGroup: (group: string, selfid?: string) => Promise<any>;
     /**
      * leave from the group
      * @param group group
@@ -577,43 +616,58 @@ export declare class VtecxNext {
     isAdmin: () => Promise<boolean>;
     /**
      * add user
-     * @param feed entry (JSON)
+     * @param adduserInfo adduser infomation
      * @param reCaptchaToken reCAPTCHA token
      * @return message feed
      */
-    adduser: (feed: any, reCaptchaToken: string) => Promise<any>;
+    adduser: (adduserInfo: AdduserInfo, reCaptchaToken: string) => Promise<any>;
+    /**
+     * convert adduser info to argument entry
+     * @param adduserInfo adduser info
+     * @param isNoPswd パスワードを付加しない場合true(passresetの場合true)
+     * @returns entry
+     */
+    private convertAdduserInfoToEntry;
     /**
      * add user by user admin
      * @param feed entries (JSON)
-     * @param reCaptchaToken reCAPTCHA token
      * @return message feed
      */
-    adduserByAdmin: (feed: any) => Promise<any>;
+    adduserByAdmin: (adduserInfos: AdduserInfo[]) => Promise<any>;
+    /**
+     * add user by group admin
+     * @param feed entries (JSON)
+     * @param groupname group name
+     * @return message feed
+     */
+    adduserByGroupadmin: (adduserInfos: AdduserInfo[], groupname: string) => Promise<any>;
     /**
      * Send email for password reset
-     * @param feed entry (JSON)
+     * @param adduserInfo mailaddress
      * @param reCaptchaToken reCAPTCHA token
      * @return message feed
      */
-    passreset: (feed: any, reCaptchaToken?: string) => Promise<any>;
+    passreset: (adduserInfo: AdduserInfo, reCaptchaToken?: string) => Promise<any>;
     /**
      * change password
-     * @param feed entry (JSON)
+     * @param newpswd new password
+     * @param oldpswd old password
+     * @param passresetToken password reset token
      * @return message feed
      */
-    changepass: (feed: any) => Promise<any>;
+    changepass: (newpswd: string, oldpswd?: string, passresetToken?: string) => Promise<any>;
     /**
      * change password by user admin
-     * @param feed entry (JSON)
+     * @param changepassByAdminInfos password change information (uid, password)
      * @return message feed
      */
-    changepassByAdmin: (feed: any) => Promise<any>;
+    changepassByAdmin: (changepassByAdminInfos: ChangepassByAdminInfo[]) => Promise<any>;
     /**
      * change login user's account
-     * @param feed entries (JSON)
+     * @param adduserInfo change user info
      * @return message feed
      */
-    changeaccount: (feed: any) => Promise<any>;
+    changeaccount: (adduserInfo: AdduserInfo) => Promise<any>;
     /**
      * verify to change login user's account
      * @param verifyCode verify code
@@ -634,10 +688,11 @@ export declare class VtecxNext {
     revokeuser: (account: string) => Promise<any>;
     /**
      * revoke users
-     * @param feed entries (JSON)
+     * @param accounts account list
+     * @param uids uid list
      * @return message feed
      */
-    revokeusers: (feed: any) => Promise<any>;
+    revokeusers: (accounts?: string[], uids?: string[]) => Promise<any>;
     /**
      * activate user
      * @param account account
@@ -646,10 +701,11 @@ export declare class VtecxNext {
     activateuser: (account: string) => Promise<any>;
     /**
      * activate users
-     * @param feed entries (JSON)
+     * @param accounts account list
+     * @param uids uid list
      * @return message feed
      */
-    activateusers: (feed: any) => Promise<any>;
+    activateusers: (accounts?: string[], uids?: string[]) => Promise<any>;
     /**
      * cancel user.
      * @param account account
@@ -664,10 +720,11 @@ export declare class VtecxNext {
     deleteuser: (account: string) => Promise<any>;
     /**
      * revoke users
-     * @param feed entries (JSON)
+     * @param accounts account list
+     * @param uids uid list
      * @return message feed
      */
-    deleteusers: (feed: any) => Promise<any>;
+    deleteusers: (accounts?: string[], uids?: string[]) => Promise<any>;
     /**
      * add acl
      * @param feed entries
@@ -813,6 +870,12 @@ export declare class VtecxNext {
      * @return message feed
      */
     mergeOAuthUserLine: (rxid: string) => Promise<any>;
+    /**
+     * create group admin
+     * @param CreateGroupadminInfo group name and uid list
+     * @return message feed
+     */
+    createGroupadmin: (createGroupadminInfos: CreateGroupadminInfo[]) => Promise<any>;
     /**
      * vte.cxへリクエスト
      * @param method メソッド
@@ -894,4 +957,3 @@ export declare class VtecxNextError extends Error {
 export declare class FetchError extends VtecxNextError {
     constructor(message: string);
 }
-export {};

package/dist/vtecxnext.js

@@ -109,6 +109,17 @@ class VtecxNext {
     isBlank = (val) => {
         return isBlank(val);
     };
+    /**
+     * undefined、nullを空文字に変換
+     * @param val 文字列
+     * @returns 変換した文字列
+     */
+    null2blank = (val) => {
+        if (val == undefined || val == null) {
+            return '';
+        }
+        return val;
+    };
     /**
      * X-Requested-With header check.
      * If not specified, set status 417 to the response.
@@ -2148,6 +2159,77 @@ class VtecxNext {
         // 戻り値
         return await getJson(response);
     };
+    /**
+     * add group
+     * (not yet joined)
+     * @param group group
+     * @param selfid hierarchical name under my group alias
+     * @return feed
+     */
+    addGroup = async (group, selfid) => {
+        //console.log(`[vtecxnext addGroup] start. group=${group} selfid=${selfid} uids=${uids}`)
+        // 入力チェック
+        checkUri(group, 'group key');
+        //checkNotNull(selfid, 'selfid (hierarchical name under my group alias)')
+        // vte.cxへリクエスト
+        const method = 'POST';
+        const url = `${SERVLETPATH_PROVIDER}${group}?_addgroup${selfid ? '&_selfid=' + selfid : ''}`;
+        let response;
+        try {
+            response = await this.requestVtecx(method, url);
+        }
+        catch (e) {
+            throw newFetchError(e, true);
+        }
+        //console.log(`[vtecxnext addGroup] response. status=${response.status}`)
+        // vte.cxからのset-cookieを転記
+        this.setCookie(response);
+        // レスポンスのエラーチェック
+        await checkVtecxResponse(response);
+        // 戻り値
+        return await getJson(response);
+    };
+    /**
+     * add group by admin
+     * (not yet joined)
+     * @param uids uid list
+     * @param group group
+     * @param selfid hierarchical name under my group alias
+     * @return feed
+     */
+    addGroupByAdmin = async (uids, group, selfid) => {
+        //console.log(`[vtecxnext addGroupByAdmin] start. group=${group} selfid=${selfid} uids=${uids}`)
+        // 入力チェック
+        checkUri(group, 'group key');
+        //checkNotNull(selfid, 'selfid (hierarchical name under my group alias)')
+        // vte.cxへリクエスト
+        const method = 'POST';
+        const url = `${SERVLETPATH_PROVIDER}${group}?_addgroupByAdmin${selfid ? '&_selfid=' + selfid : ''}`;
+        let value;
+        if (uids) {
+            const feed = [];
+            for (const uid of uids) {
+                const entry = { 'link': [{ '___rel': 'self', '___href': `/_user/${uid}` }] };
+                feed.push(entry);
+            }
+            value = JSON.stringify(feed);
+        }
+        checkNotNull(value, 'uid');
+        let response;
+        try {
+            response = await this.requestVtecx(method, url, value);
+        }
+        catch (e) {
+            throw newFetchError(e, true);
+        }
+        //console.log(`[vtecxnext addGroupByAdmin] response. status=${response.status}`)
+        // vte.cxからのset-cookieを転記
+        this.setCookie(response);
+        // レスポンスのエラーチェック
+        await checkVtecxResponse(response);
+        // 戻り値
+        return await getJson(response);
+    };
     /**
      * join to the group
      * @param group group
@@ -2158,10 +2240,10 @@ class VtecxNext {
         //console.log(`[vtecxnext joinGroup] start. group=${group} selfid=${selfid}`)
         // 入力チェック
         checkUri(group);
-        checkNotNull(selfid, 'selfid (hierarchical name under my group alias)');
+        //checkNotNull(selfid, 'selfid (hierarchical name under my group alias)')
         // vte.cxへリクエスト
         const method = 'PUT';
-        const url = `${SERVLETPATH_PROVIDER}${group}?_joingroup&_selfid=${selfid}`;
+        const url = `${SERVLETPATH_PROVIDER}${group}?_joingroup${selfid ? '&_selfid=' + selfid : ''}`;
         let response;
         try {
             response = await this.requestVtecx(method, url);
@@ -2294,14 +2376,18 @@ class VtecxNext {
     };
     /**
      * add user
-     * @param feed entry (JSON)
+     * @param adduserInfo adduser infomation
      * @param reCaptchaToken reCAPTCHA token
      * @return message feed
      */
-    adduser = async (feed, reCaptchaToken) => {
+    adduser = async (adduserInfo, reCaptchaToken) => {
         //console.log(`[vtecxnext adduser] start. feed=${feed}`)
         // 入力チェック
-        checkNotNull(feed, 'Feed');
+        checkNotNull(adduserInfo, 'username');
+        checkNotNull(adduserInfo.username, 'username');
+        checkNotNull(adduserInfo.pswd, 'pswd');
+        const entry = this.convertAdduserInfoToEntry(adduserInfo);
+        const feed = [entry];
         // vte.cxへリクエスト
         const method = 'POST';
         const param = reCaptchaToken ? `&g-recaptcha-token=${reCaptchaToken}` : '';
@@ -2320,16 +2406,38 @@ class VtecxNext {
         await checkVtecxResponse(response);
         return await getJson(response);
     };
+    /**
+     * convert adduser info to argument entry
+     * @param adduserInfo adduser info
+     * @param isNoPswd パスワードを付加しない場合true(passresetの場合true)
+     * @returns entry
+     */
+    convertAdduserInfoToEntry = (adduserInfo, isNoPswd) => {
+        return {
+            'contributor': [{
+                    'uri': `urn:vte.cx:auth:${this.null2blank(adduserInfo.username)}${isNoPswd ? '' : ',' + this.null2blank(adduserInfo.pswd)}`,
+                    'name': adduserInfo.nickname,
+                }],
+            'title': adduserInfo.emailSubject,
+            'summary': adduserInfo.emailText,
+            'content': { '______text': adduserInfo.emailHtml }
+        };
+    };
     /**
      * add user by user admin
      * @param feed entries (JSON)
-     * @param reCaptchaToken reCAPTCHA token
      * @return message feed
      */
-    adduserByAdmin = async (feed) => {
+    //adduserByAdmin = async (feed:any): Promise<any> => {
+    adduserByAdmin = async (adduserInfos) => {
         //console.log(`[vtecxnext adduserByAdmin] start. feed=${feed}`)
         // 入力チェック
-        checkNotNull(feed, 'Feed');
+        checkNotNull(adduserInfos, 'username');
+        const feed = [];
+        for (const adduserInfo of adduserInfos) {
+            const entry = this.convertAdduserInfoToEntry(adduserInfo);
+            feed.push(entry);
+        }
         // vte.cxへリクエスト
         const method = 'POST';
         const url = `${SERVLETPATH_DATA}/?_adduserByAdmin`;
@@ -2347,16 +2455,51 @@ class VtecxNext {
         await checkVtecxResponse(response);
         return await getJson(response);
     };
+    /**
+     * add user by group admin
+     * @param feed entries (JSON)
+     * @param groupname group name
+     * @return message feed
+     */
+    adduserByGroupadmin = async (adduserInfos, groupname) => {
+        //console.log(`[vtecxnext adduserByGroupadmin] start. feed=${feed}`)
+        // 入力チェック
+        checkNotNull(adduserInfos, 'username');
+        checkNotNull(groupname, 'group name');
+        const feed = [];
+        for (const adduserInfo of adduserInfos) {
+            const entry = this.convertAdduserInfoToEntry(adduserInfo);
+            feed.push(entry);
+        }
+        // vte.cxへリクエスト
+        const method = 'POST';
+        const url = `${SERVLETPATH_DATA}/?_adduserByGroupadmin=${groupname}`;
+        let response;
+        try {
+            response = await this.requestVtecx(method, url, JSON.stringify(feed));
+        }
+        catch (e) {
+            throw newFetchError(e, true);
+        }
+        //console.log(`[vtecxnext adduserByGroupadmin] response. status=${response.status}`)
+        // vte.cxからのset-cookieを転記
+        this.setCookie(response);
+        // レスポンスのエラーチェック
+        await checkVtecxResponse(response);
+        return await getJson(response);
+    };
     /**
      * Send email for password reset
-     * @param feed entry (JSON)
+     * @param adduserInfo mailaddress
      * @param reCaptchaToken reCAPTCHA token
      * @return message feed
      */
-    passreset = async (feed, reCaptchaToken) => {
+    passreset = async (adduserInfo, reCaptchaToken) => {
         //console.log(`[vtecxnext passreset] start. feed=${feed}`)
         // 入力チェック
-        checkNotNull(feed, 'Feed');
+        checkNotNull(adduserInfo, 'email address');
+        const entry = this.convertAdduserInfoToEntry(adduserInfo, true);
+        const feed = [entry];
         // vte.cxへリクエスト
         const method = 'POST';
         const param = reCaptchaToken ? `&g-recaptcha-token=${reCaptchaToken}` : '';
@@ -2377,13 +2520,27 @@ class VtecxNext {
     };
     /**
      * change password
-     * @param feed entry (JSON)
+     * @param newpswd new password
+     * @param oldpswd old password
+     * @param passresetToken password reset token
      * @return message feed
      */
-    changepass = async (feed) => {
+    changepass = async (newpswd, oldpswd, passresetToken) => {
         //console.log(`[vtecxnext changepass] start. feed=${feed}`)
         // 入力チェック
-        checkNotNull(feed, 'Feed');
+        checkNotNull(newpswd, 'new password');
+        const contributors = [];
+        const newPswdContributor = { 'uri': `urn:vte.cx:auth:,${newpswd}` };
+        contributors.push(newPswdContributor);
+        if (oldpswd) {
+            const oldPswdContributor = { 'uri': `urn:vte.cx:oldphash:${oldpswd}` };
+            contributors.push(oldPswdContributor);
+        }
+        if (passresetToken) {
+            const passresetTokenContributor = { 'uri': `urn:vte.cx:passreset_token:${passresetToken}` };
+            contributors.push(passresetTokenContributor);
+        }
+        const feed = [{ 'contributor': contributors }];
         // vte.cxへリクエスト
         const method = 'PUT';
         const url = `${SERVLETPATH_DATA}/?_changephash`;
@@ -2403,13 +2560,28 @@ class VtecxNext {
     };
     /**
      * change password by user admin
-     * @param feed entry (JSON)
+     * @param changepassByAdminInfos password change information (uid, password)
      * @return message feed
      */
-    changepassByAdmin = async (feed) => {
+    changepassByAdmin = async (changepassByAdminInfos) => {
         //console.log(`[vtecxnext changepassByAdmin] start. feed=${feed}`)
         // 入力チェック
-        checkNotNull(feed, 'Feed');
+        checkNotNull(changepassByAdminInfos, 'password change information');
+        const feed = [];
+        for (const changepassByAdminInfo of changepassByAdminInfos) {
+            // 入力チェック
+            checkNotNull(changepassByAdminInfo.uid, 'password change information');
+            checkNotNull(changepassByAdminInfo.pswd, 'password change information');
+            const entry = {
+                'contributor': [
+                    { 'uri': `urn:vte.cx:auth:,${changepassByAdminInfo.pswd}` }
+                ],
+                'link': [
+                    { '___rel': 'self', '___href': `/_user/${changepassByAdminInfo.uid}/auth` }
+                ]
+            };
+            feed.push(entry);
+        }
         // vte.cxへリクエスト
         const method = 'PUT';
         const url = `${SERVLETPATH_DATA}/?_changephashByAdmin`;
@@ -2429,13 +2601,15 @@ class VtecxNext {
     };
     /**
      * change login user's account
-     * @param feed entries (JSON)
+     * @param adduserInfo change user info
      * @return message feed
      */
-    changeaccount = async (feed) => {
+    changeaccount = async (adduserInfo) => {
         //console.log(`[vtecxnext changeaccount] start. feed=${feed}`)
         // 入力チェック
-        checkNotNull(feed, 'Feed');
+        checkNotNull(adduserInfo, 'user info');
+        const entry = this.convertAdduserInfoToEntry(adduserInfo);
+        const feed = [entry];
         // vte.cxへリクエスト
         const method = 'PUT';
         const url = `${SERVLETPATH_DATA}/?_changeaccount`;
@@ -2534,13 +2708,29 @@ class VtecxNext {
     };
     /**
      * revoke users
-     * @param feed entries (JSON)
+     * @param accounts account list
+     * @param uids uid list
      * @return message feed
      */
-    revokeusers = async (feed) => {
+    revokeusers = async (accounts, uids) => {
         //console.log(`[vtecxnext revokeusers] start. feed=${feed}`)
         // 入力チェック
-        checkNotNull(feed, 'Feed');
+        if (isBlank(accounts) && isBlank(uids)) {
+            throw new VtecxNextError(400, `account or uid is required.`);
+        }
+        const feed = [];
+        if (accounts) {
+            for (const account of accounts) {
+                const entry = { 'title': account };
+                feed.push(entry);
+            }
+        }
+        if (uids) {
+            for (const uid of uids) {
+                const entry = { 'link': [{ '___rel': 'self', '___href': `/_user/${uid}` }] };
+                feed.push(entry);
+            }
+        }
         // vte.cxへリクエスト
         const method = 'PUT';
         const url = `${SERVLETPATH_DATA}/?_revokeuser`;
@@ -2587,13 +2777,29 @@ class VtecxNext {
     };
     /**
      * activate users
-     * @param feed entries (JSON)
+     * @param accounts account list
+     * @param uids uid list
      * @return message feed
      */
-    activateusers = async (feed) => {
+    activateusers = async (accounts, uids) => {
         //console.log(`[vtecxnext activateusers] start. feed=${feed}`)
         // 入力チェック
-        checkNotNull(feed, 'Feed');
+        if (isBlank(accounts) && isBlank(uids)) {
+            throw new VtecxNextError(400, `account or uid is required.`);
+        }
+        const feed = [];
+        if (accounts) {
+            for (const account of accounts) {
+                const entry = { 'title': account };
+                feed.push(entry);
+            }
+        }
+        if (uids) {
+            for (const uid of uids) {
+                const entry = { 'link': [{ '___rel': 'self', '___href': `/_user/${uid}` }] };
+                feed.push(entry);
+            }
+        }
         // vte.cxへリクエスト
         const method = 'PUT';
         const url = `${SERVLETPATH_DATA}/?_activateuser`;
@@ -2665,13 +2871,29 @@ class VtecxNext {
     };
     /**
      * revoke users
-     * @param feed entries (JSON)
+     * @param accounts account list
+     * @param uids uid list
      * @return message feed
      */
-    deleteusers = async (feed) => {
+    deleteusers = async (accounts, uids) => {
         //console.log(`[vtecxnext deleteusers] start. feed=${feed}`)
         // 入力チェック
-        checkNotNull(feed, 'Feed');
+        if (isBlank(accounts) && isBlank(uids)) {
+            throw new VtecxNextError(400, `account or uid is required.`);
+        }
+        const feed = [];
+        if (accounts) {
+            for (const account of accounts) {
+                const entry = { 'title': account };
+                feed.push(entry);
+            }
+        }
+        if (uids) {
+            for (const uid of uids) {
+                const entry = { 'link': [{ '___rel': 'self', '___href': `/_user/${uid}` }] };
+                feed.push(entry);
+            }
+        }
         // vte.cxへリクエスト
         const method = 'DELETE';
         const url = `${SERVLETPATH_DATA}/?_deleteuser`;
@@ -3244,6 +3466,45 @@ class VtecxNext {
         //console.log(`[vtecxnext mergeOAuthUserLine] start. feed=${feed}`)
         return this.mergeOAuthUser('line', rxid);
     };
+    /**
+     * create group admin
+     * @param CreateGroupadminInfo group name and uid list
+     * @return message feed
+     */
+    createGroupadmin = async (createGroupadminInfos) => {
+        //console.log(`[vtecxnext createGroupadmin] start. feed=${feed}`)
+        // 入力チェック
+        checkNotNull(createGroupadminInfos, 'group name');
+        const feed = [];
+        for (const createGroupadminInfo of createGroupadminInfos) {
+            checkNotNull(createGroupadminInfo.group, 'group name');
+            checkContainSlash(createGroupadminInfo.group, 'group name');
+            checkNotNull(createGroupadminInfo.uids, 'uid');
+            const links = [{ '___rel': 'self', '___href': `/_group/${createGroupadminInfo.group}` }];
+            for (const uid of createGroupadminInfo.uids) {
+                const link = { '___rel': 'via', '___title': uid };
+                links.push(link);
+            }
+            const entry = { 'link': links };
+            feed.push(entry);
+        }
+        // vte.cxへリクエスト
+        const method = 'POST';
+        const url = `${SERVLETPATH_DATA}/?_creategroupadmin`;
+        let response;
+        try {
+            response = await this.requestVtecx(method, url, JSON.stringify(feed));
+        }
+        catch (e) {
+            throw newFetchError(e, true);
+        }
+        //console.log(`[vtecxnext createGroupadmin] response. status=${response.status}`)
+        // vte.cxからのset-cookieを転記
+        this.setCookie(response);
+        // レスポンスのエラーチェック
+        await checkVtecxResponse(response);
+        return await getJson(response);
+    };
     //----------------------
     /**
      * vte.cxへリクエスト
@@ -3689,6 +3950,7 @@ const buffer = async (readable) => {
 };
 /**
  * null、undefined、空文字の判定
+ * 配列で空の場合もtrueを返す。
  * @param val チェック値
  * @returns null、undefined、空文字の場合true
  */
@@ -3696,6 +3958,9 @@ const isBlank = (val) => {
     if (val === null || val === undefined || val === '') {
         return true;
     }
+    if (Array.isArray(val) && val.length === 0) {
+        return true;
+    }
     return false;
 };
 /**
@@ -3734,6 +3999,17 @@ const checkNotNull = (val, name) => {
         throw new VtecxNextError(400, `${name ?? 'Key'} is required.`);
     }
 };
+/**
+ * 文字列にスラッシュが含まれている場合エラー
+ * エラーの場合 VtecxNextError をスローする。
+ * @param val チェック文字列
+ * @param name エラーの場合の項目名称
+ */
+const checkContainSlash = (val, name) => {
+    if (val.indexOf('/') > -1) {
+        throw new VtecxNextError(400, `${name} cannot contain a slash : ${val}`);
+    }
+};
 /**
  * キーチェック。
  * 入力チェックと、先頭が/で始まっているかどうかチェックする。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vtecx/vtecxnext",
-  "version": "2.1.2",
+  "version": "2.2.0",
   "description": "vte.cx Next.js api",
   "main": "dist/index.js",
   "files": [