From 3ead4d37ad3df8b67e841acde730d890f34a931f Mon Sep 17 00:00:00 2001
From: sharevb <sharevb@gmail.com>
Date: Wed, 3 Apr 2024 22:34:00 +0200
Subject: [PATCH 1/4] feat(Chmod Calculator): octal input and special flags

Handle input of octal rights values and special flags
Fix #670 and #527
---
 .../chmod-calculator.service.test.ts          | 216 +++++++++++++++++-
 .../chmod-calculator.service.ts               |  47 +++-
 .../chmod-calculator.types.ts                 |   7 +
 .../chmod-calculator/chmod-calculator.vue     |  54 ++++-
 4 files changed, 314 insertions(+), 10 deletions(-)

diff --git a/src/tools/chmod-calculator/chmod-calculator.service.test.ts b/src/tools/chmod-calculator/chmod-calculator.service.test.ts
index 426c4a56c..5264734c5 100644
--- a/src/tools/chmod-calculator/chmod-calculator.service.test.ts
+++ b/src/tools/chmod-calculator/chmod-calculator.service.test.ts
@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import { computeChmodOctalRepresentation, computeChmodSymbolicRepresentation } from './chmod-calculator.service';
+import { computeChmodOctalRepresentation, computeChmodSymbolicRepresentation, computePermissionsFromChmodOctalRepresentation } from './chmod-calculator.service';
 
 describe('chmod-calculator', () => {
   describe('computeChmodOctalRepresentation', () => {
@@ -10,6 +10,7 @@ describe('chmod-calculator', () => {
             owner: { read: true, write: true, execute: true },
             group: { read: true, write: true, execute: true },
             public: { read: true, write: true, execute: true },
+            flags: { setuid: false, setgid: false, stickybit: false },
           },
         }),
       ).to.eql('777');
@@ -20,6 +21,7 @@ describe('chmod-calculator', () => {
             owner: { read: false, write: false, execute: false },
             group: { read: false, write: false, execute: false },
             public: { read: false, write: false, execute: false },
+            flags: { setuid: false, setgid: false, stickybit: false },
           },
         }),
       ).to.eql('000');
@@ -30,6 +32,7 @@ describe('chmod-calculator', () => {
             owner: { read: false, write: true, execute: false },
             group: { read: false, write: true, execute: true },
             public: { read: true, write: false, execute: true },
+            flags: { setuid: false, setgid: false, stickybit: false },
           },
         }),
       ).to.eql('235');
@@ -40,6 +43,7 @@ describe('chmod-calculator', () => {
             owner: { read: true, write: false, execute: false },
             group: { read: false, write: true, execute: false },
             public: { read: false, write: false, execute: true },
+            flags: { setuid: false, setgid: false, stickybit: false },
           },
         }),
       ).to.eql('421');
@@ -50,6 +54,7 @@ describe('chmod-calculator', () => {
             owner: { read: false, write: false, execute: true },
             group: { read: false, write: true, execute: false },
             public: { read: true, write: false, execute: false },
+            flags: { setuid: false, setgid: false, stickybit: false },
           },
         }),
       ).to.eql('124');
@@ -60,11 +65,57 @@ describe('chmod-calculator', () => {
             owner: { read: false, write: true, execute: false },
             group: { read: false, write: true, execute: false },
             public: { read: false, write: true, execute: false },
+            flags: { setuid: false, setgid: false, stickybit: false },
           },
         }),
       ).to.eql('222');
-    });
 
+      expect(
+        computeChmodOctalRepresentation({
+          permissions: {
+            owner: { read: false, write: true, execute: false },
+            group: { read: false, write: true, execute: false },
+            public: { read: false, write: true, execute: false },
+            flags: { setuid: true, setgid: true, stickybit: true },
+          },
+        }),
+      ).to.eql('7222');
+
+      expect(
+        computeChmodOctalRepresentation({
+          permissions: {
+            owner: { read: false, write: true, execute: false },
+            group: { read: false, write: true, execute: false },
+            public: { read: false, write: true, execute: false },
+            flags: { setuid: true, setgid: false, stickybit: false },
+          },
+        }),
+      ).to.eql('4222');
+
+      expect(
+        computeChmodOctalRepresentation({
+          permissions: {
+            owner: { read: false, write: true, execute: false },
+            group: { read: false, write: true, execute: false },
+            public: { read: false, write: true, execute: false },
+            flags: { setuid: false, setgid: true, stickybit: false },
+          },
+        }),
+      ).to.eql('2222');
+
+      expect(
+        computeChmodOctalRepresentation({
+          permissions: {
+            owner: { read: false, write: true, execute: false },
+            group: { read: false, write: true, execute: false },
+            public: { read: false, write: true, execute: false },
+            flags: { setuid: false, setgid: false, stickybit: true },
+          },
+        }),
+      ).to.eql('1222');
+    });
+  });
+  describe('computeChmodSymbolicRepresentation', () => {
     it('get the symbolic representation from permissions', () => {
       expect(
         computeChmodSymbolicRepresentation({
@@ -72,6 +123,7 @@ describe('chmod-calculator', () => {
             owner: { read: true, write: true, execute: true },
             group: { read: true, write: true, execute: true },
             public: { read: true, write: true, execute: true },
+            flags: { setuid: false, setgid: false, stickybit: false },
           },
         }),
       ).to.eql('rwxrwxrwx');
@@ -82,6 +134,7 @@ describe('chmod-calculator', () => {
             owner: { read: false, write: false, execute: false },
             group: { read: false, write: false, execute: false },
             public: { read: false, write: false, execute: false },
+            flags: { setuid: false, setgid: false, stickybit: false },
           },
         }),
       ).to.eql('---------');
@@ -92,6 +145,7 @@ describe('chmod-calculator', () => {
             owner: { read: false, write: true, execute: false },
             group: { read: false, write: true, execute: true },
             public: { read: true, write: false, execute: true },
+            flags: { setuid: false, setgid: false, stickybit: false },
           },
         }),
       ).to.eql('-w--wxr-x');
@@ -102,6 +156,7 @@ describe('chmod-calculator', () => {
             owner: { read: true, write: false, execute: false },
             group: { read: false, write: true, execute: false },
             public: { read: false, write: false, execute: true },
+            flags: { setuid: false, setgid: false, stickybit: false },
           },
         }),
       ).to.eql('r---w---x');
@@ -112,6 +167,7 @@ describe('chmod-calculator', () => {
             owner: { read: false, write: false, execute: true },
             group: { read: false, write: true, execute: false },
             public: { read: true, write: false, execute: false },
+            flags: { setuid: false, setgid: false, stickybit: false },
           },
         }),
       ).to.eql('--x-w-r--');
@@ -122,9 +178,165 @@ describe('chmod-calculator', () => {
             owner: { read: false, write: true, execute: false },
             group: { read: false, write: true, execute: false },
             public: { read: false, write: true, execute: false },
+            flags: { setuid: false, setgid: false, stickybit: false },
           },
         }),
       ).to.eql('-w--w--w-');
+
+      expect(
+        computeChmodSymbolicRepresentation({
+          permissions: {
+            owner: { read: false, write: false, execute: true },
+            group: { read: false, write: true, execute: false },
+            public: { read: true, write: false, execute: false },
+            flags: { setuid: false, setgid: false, stickybit: true },
+          },
+        }),
+      ).to.eql('--x-w-r-t');
+
+      expect(
+        computeChmodSymbolicRepresentation({
+          permissions: {
+            owner: { read: false, write: false, execute: true },
+            group: { read: false, write: true, execute: false },
+            public: { read: true, write: false, execute: false },
+            flags: { setuid: false, setgid: true, stickybit: true },
+          },
+        }),
+      ).to.eql('--x-wsr-t');
+
+      expect(
+        computeChmodSymbolicRepresentation({
+          permissions: {
+            owner: { read: false, write: false, execute: true },
+            group: { read: false, write: true, execute: false },
+            public: { read: true, write: false, execute: false },
+            flags: { setuid: true, setgid: true, stickybit: true },
+          },
+        }),
+      ).to.eql('--s-wsr-t');
+
+      expect(
+        computeChmodSymbolicRepresentation({
+          permissions: {
+            owner: { read: true, write: false, execute: true },
+            group: { read: true, write: true, execute: false },
+            public: { read: true, write: false, execute: false },
+            flags: { setuid: false, setgid: false, stickybit: false },
+          },
+        }),
+      ).to.eql('r-xrw-r--');
+
+      expect(
+        computeChmodSymbolicRepresentation({
+          permissions: {
+            owner: { read: true, write: true, execute: true },
+            group: { read: true, write: true, execute: true },
+            public: { read: true, write: true, execute: true },
+            flags: { setuid: true, setgid: true, stickybit: true },
+          },
+        }),
+      ).to.eql('rwsrwsrwt');
+    });
+  });
+  describe('computePermissionsFromChmodOctalRepresentation', () => {
+    it('throws on invalid octal values', () => {
+      expect(() => computePermissionsFromChmodOctalRepresentation('12')).to.throw();
+      expect(() => computePermissionsFromChmodOctalRepresentation('12345')).to.throw();
+      expect(() => computePermissionsFromChmodOctalRepresentation('999')).to.throw();
+      expect(() => computePermissionsFromChmodOctalRepresentation('9999')).to.throw();
+    });
+
+    it('get permissions from octal representation', () => {
+      expect(
+        computePermissionsFromChmodOctalRepresentation('777'),
+      ).to.eql({
+        owner: { read: true, write: true, execute: true },
+        group: { read: true, write: true, execute: true },
+        public: { read: true, write: true, execute: true },
+        flags: { setuid: false, setgid: false, stickybit: false },
+      });
+
+      expect(
+        computePermissionsFromChmodOctalRepresentation('000'),
+      ).to.eql({
+        owner: { read: false, write: false, execute: false },
+        group: { read: false, write: false, execute: false },
+        public: { read: false, write: false, execute: false },
+        flags: { setuid: false, setgid: false, stickybit: false },
+      });
+
+      expect(
+        computePermissionsFromChmodOctalRepresentation('235'),
+      ).to.eql({
+        owner: { read: false, write: true, execute: false },
+        group: { read: false, write: true, execute: true },
+        public: { read: true, write: false, execute: true },
+        flags: { setuid: false, setgid: false, stickybit: false },
+      });
+
+      expect(
+        computePermissionsFromChmodOctalRepresentation('421'),
+      ).to.eql({
+        owner: { read: true, write: false, execute: false },
+        group: { read: false, write: true, execute: false },
+        public: { read: false, write: false, execute: true },
+        flags: { setuid: false, setgid: false, stickybit: false },
+      });
+
+      expect(
+        computePermissionsFromChmodOctalRepresentation('124'),
+      ).to.eql({
+        owner: { read: false, write: false, execute: true },
+        group: { read: false, write: true, execute: false },
+        public: { read: true, write: false, execute: false },
+        flags: { setuid: false, setgid: false, stickybit: false },
+      });
+
+      expect(
+        computePermissionsFromChmodOctalRepresentation('222'),
+      ).to.eql({
+        owner: { read: false, write: true, execute: false },
+        group: { read: false, write: true, execute: false },
+        public: { read: false, write: true, execute: false },
+        flags: { setuid: false, setgid: false, stickybit: false },
+      });
+
+      expect(
+        computePermissionsFromChmodOctalRepresentation('7222'),
+      ).to.eql({
+        owner: { read: false, write: true, execute: false },
+        group: { read: false, write: true, execute: false },
+        public: { read: false, write: true, execute: false },
+        flags: { setuid: true, setgid: true, stickybit: true },
+      });
+
+      expect(
+        computePermissionsFromChmodOctalRepresentation('4222'),
+      ).to.eql({
+        owner: { read: false, write: true, execute: false },
+        group: { read: false, write: true, execute: false },
+        public: { read: false, write: true, execute: false },
+        flags: { setuid: true, setgid: false, stickybit: false },
+      });
+
+      expect(
+        computePermissionsFromChmodOctalRepresentation('2222'),
+      ).to.eql({
+        owner: { read: false, write: true, execute: false },
+        group: { read: false, write: true, execute: false },
+        public: { read: false, write: true, execute: false },
+        flags: { setuid: false, setgid: true, stickybit: false },
+      });
+
+      expect(
+        computePermissionsFromChmodOctalRepresentation('1222'),
+      ).to.eql({
+        owner: { read: false, write: true, execute: false },
+        group: { read: false, write: true, execute: false },
+        public: { read: false, write: true, execute: false },
+        flags: { setuid: false, setgid: false, stickybit: true },
+      });
     });
   });
 });
diff --git a/src/tools/chmod-calculator/chmod-calculator.service.ts b/src/tools/chmod-calculator/chmod-calculator.service.ts
index e00467179..511745f9f 100644
--- a/src/tools/chmod-calculator/chmod-calculator.service.ts
+++ b/src/tools/chmod-calculator/chmod-calculator.service.ts
@@ -1,15 +1,21 @@
 import _ from 'lodash';
-import type { GroupPermissions, Permissions } from './chmod-calculator.types';
+import type { GroupPermissions, Permissions, SpecialPermissions } from './chmod-calculator.types';
 
-export { computeChmodOctalRepresentation, computeChmodSymbolicRepresentation };
+export { computeChmodOctalRepresentation, computeChmodSymbolicRepresentation, computePermissionsFromChmodOctalRepresentation };
 
 function computeChmodOctalRepresentation({ permissions }: { permissions: Permissions }): string {
   const permissionValue = { read: 4, write: 2, execute: 1 };
+  const specialPermissionValue = { setuid: 4, setgid: 2, stickybit: 1 };
 
   const getGroupPermissionValue = (permission: GroupPermissions) =>
     _.reduce(permission, (acc, isPermSet, key) => acc + (isPermSet ? _.get(permissionValue, key, 0) : 0), 0);
+  const getSpecialPermissionValue = (permission: SpecialPermissions) => {
+    const octalValue = _.reduce(permission, (acc, isPermSet, key) => acc + (isPermSet ? _.get(specialPermissionValue, key, 0) : 0), 0);
+    return octalValue > 0 ? octalValue.toString() : '';
+  };
 
   return [
+    getSpecialPermissionValue(permissions.flags || { setuid: false, setgid: false, stickybit: false }),
     getGroupPermissionValue(permissions.owner),
     getGroupPermissionValue(permissions.group),
     getGroupPermissionValue(permissions.public),
@@ -18,13 +24,40 @@ function computeChmodOctalRepresentation({ permissions }: { permissions: Permiss
 
 function computeChmodSymbolicRepresentation({ permissions }: { permissions: Permissions }): string {
   const permissionValue = { read: 'r', write: 'w', execute: 'x' };
+  const specialFlagPermission = 'execute';
 
-  const getGroupPermissionValue = (permission: GroupPermissions) =>
-    _.reduce(permission, (acc, isPermSet, key) => acc + (isPermSet ? _.get(permissionValue, key, '') : '-'), '');
+  const getGroupPermissionValue = (permission: GroupPermissions, specialFlag: null | 's' | 't') =>
+    _.reduce(permission, (acc, isPermSet, key) => acc + ((key === specialFlagPermission ? specialFlag : undefined)
+    || (isPermSet ? _.get(permissionValue, key, '') : '-')), '');
 
   return [
-    getGroupPermissionValue(permissions.owner),
-    getGroupPermissionValue(permissions.group),
-    getGroupPermissionValue(permissions.public),
+    getGroupPermissionValue(permissions.owner, permissions.flags?.setuid ? 's' : null),
+    getGroupPermissionValue(permissions.group, permissions.flags?.setgid ? 's' : null),
+    getGroupPermissionValue(permissions.public, permissions.flags?.stickybit ? 't' : null),
   ].join('');
 }
+
+function computePermissionsFromChmodOctalRepresentation(octalPermissions: string): Permissions {
+  const permissionValue = { read: 4, write: 2, execute: 1 };
+  const specialPermissionValue = { setuid: 4, setgid: 2, stickybit: 1 };
+
+  if (!octalPermissions || !octalPermissions.match(/^[0-7]{3,4}$/)) {
+    throw new Error(`Invalid octal permissions (must be 3 or 4 octal digits): ${octalPermissions}`);
+  }
+  const fullOctalPermissions = octalPermissions.length === 3 ? `0${octalPermissions}` : octalPermissions;
+
+  const hasSet = (position: number, flagValue: number) => (Number(fullOctalPermissions[position]) & flagValue) === flagValue;
+  function computePermissionObject<T>(permissionSet: object, position: number): T {
+    return _.reduce(permissionSet, (acc, flag, key) => ({ ...acc, [key]: hasSet(position, flag) }), {}) as T;
+  }
+  const flagsPosition = 0;
+  const ownerPosition = 1;
+  const groupPosition = 2;
+  const publicPosition = 3;
+  return {
+    owner: computePermissionObject(permissionValue, ownerPosition),
+    group: computePermissionObject(permissionValue, groupPosition),
+    public: computePermissionObject(permissionValue, publicPosition),
+    flags: computePermissionObject(specialPermissionValue, flagsPosition),
+  };
+}
diff --git a/src/tools/chmod-calculator/chmod-calculator.types.ts b/src/tools/chmod-calculator/chmod-calculator.types.ts
index d3dc915f9..30a7ad010 100644
--- a/src/tools/chmod-calculator/chmod-calculator.types.ts
+++ b/src/tools/chmod-calculator/chmod-calculator.types.ts
@@ -1,10 +1,17 @@
 export type Scope = 'read' | 'write' | 'execute';
 export type Group = 'owner' | 'group' | 'public';
+export type SpecialFlags = 'setuid' | 'setgid' | 'stickybit';
 
 export type GroupPermissions = {
   [k in Scope]: boolean;
 };
 
+export type SpecialPermissions = {
+  [k in SpecialFlags]: boolean;
+};
+
 export type Permissions = {
   [k in Group]: GroupPermissions;
+} & {
+  flags: SpecialPermissions
 };
diff --git a/src/tools/chmod-calculator/chmod-calculator.vue b/src/tools/chmod-calculator/chmod-calculator.vue
index ba6f4498e..93f9f3ae4 100644
--- a/src/tools/chmod-calculator/chmod-calculator.vue
+++ b/src/tools/chmod-calculator/chmod-calculator.vue
@@ -2,9 +2,10 @@
 import { useThemeVars } from 'naive-ui';
 
 import InputCopyable from '../../components/InputCopyable.vue';
-import { computeChmodOctalRepresentation, computeChmodSymbolicRepresentation } from './chmod-calculator.service';
+import { computeChmodOctalRepresentation, computeChmodSymbolicRepresentation, computePermissionsFromChmodOctalRepresentation } from './chmod-calculator.service';
 
 import type { Group, Scope } from './chmod-calculator.types';
+import { useValidation } from '@/composable/validation';
 
 const themeVars = useThemeVars();
 
@@ -19,14 +20,51 @@ const permissions = ref({
   owner: { read: false, write: false, execute: false },
   group: { read: false, write: false, execute: false },
   public: { read: false, write: false, execute: false },
+  flags: { setuid: false, setgid: false, stickybit: false },
 });
 
+const permissionsInput = ref('000');
+const permissionsInputValidation = useValidation({
+  source: permissionsInput,
+  rules: [
+    {
+      message: 'Invalid octal permission string',
+      validator: (value) => {
+        try {
+          computePermissionsFromChmodOctalRepresentation(value.trim());
+          return true;
+        }
+        catch {
+          return false;
+        }
+      },
+    },
+  ],
+});
+watch(
+  permissionsInput,
+  (newPermissions) => {
+    if (!permissionsInputValidation.isValid) {
+      return;
+    }
+    permissions.value = computePermissionsFromChmodOctalRepresentation(newPermissions.trim());
+  },
+);
+
 const octal = computed(() => computeChmodOctalRepresentation({ permissions: permissions.value }));
 const symbolic = computed(() => computeChmodSymbolicRepresentation({ permissions: permissions.value }));
 </script>
 
 <template>
   <div>
+    <c-input-text
+      v-model:value="permissionsInput"
+      placeholder="Put your octal permissions here..."
+      label="Copy your octal permissions"
+      :validation="permissionsInputValidation"
+      mb-2
+    />
+    <n-divider />
     <n-table :bordered="false" :bottom-bordered="false" single-column class="permission-table">
       <thead>
         <tr>
@@ -52,6 +90,20 @@ const symbolic = computed(() => computeChmodSymbolicRepresentation({ permissions
             <n-checkbox v-model:checked="permissions[group][scope]" size="large" />
           </td>
         </tr>
+        <tr>
+          <td class="line-header">
+            Flags
+          </td>
+          <td class="text-center">
+            <n-checkbox v-model:checked="permissions.flags.setuid" size="large" />
+          </td>
+          <td class="text-center">
+            <n-checkbox v-model:checked="permissions.flags.setgid" size="large" />
+          </td>
+          <td class="text-center">
+            <n-checkbox v-model:checked="permissions.flags.stickybit" size="large" />
+          </td>
+        </tr>
       </tbody>
     </n-table>
 

From ee04bfed87eeef36e2aa19a8886ac9a72c903def Mon Sep 17 00:00:00 2001
From: ShareVB <sharevb@gmail.com>
Date: Sat, 6 Apr 2024 11:56:09 +0200
Subject: [PATCH 2/4] chore(github workflows): ci and e2e tests: try updating
 to node 20

---
 .github/workflows/ci.yml        | 2 +-
 .github/workflows/e2e-tests.yml | 2 +-
 playwright.config.ts            | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index d5c672083..4dd9ffb7c 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -15,7 +15,7 @@ jobs:
       - run: corepack enable
       - uses: actions/setup-node@v3
         with:
-          node-version: 16
+          node-version: 20
           cache: 'pnpm'
 
       - name: Install dependencies
diff --git a/.github/workflows/e2e-tests.yml b/.github/workflows/e2e-tests.yml
index b5b040968..13b787ef4 100644
--- a/.github/workflows/e2e-tests.yml
+++ b/.github/workflows/e2e-tests.yml
@@ -18,7 +18,7 @@ jobs:
 
       - uses: actions/setup-node@v3
         with:
-          node-version: 16
+          node-version: 20
           cache: 'pnpm'
 
       - name: Get Playwright version
diff --git a/playwright.config.ts b/playwright.config.ts
index 3caa06121..5257c526d 100644
--- a/playwright.config.ts
+++ b/playwright.config.ts
@@ -9,7 +9,7 @@ const useWebServer = process.env.NO_WEB_SERVER !== 'true';
  */
 export default defineConfig({
   testDir: './src',
-  testMatch: /.*\.e2e\.(spec\.)?ts/,
+  testMatch: /\.e2e\.(spec\.)?ts$/,
   /* Run tests in files in parallel */
   fullyParallel: true,
   /* Fail the build on CI if you accidentally left test.only in the source code. */
@@ -57,7 +57,7 @@ export default defineConfig({
     && {
       webServer: {
         command: 'npm run preview',
-        url: 'http://127.0.0.1:5050',
+        url: 'http://localhost:5050',
         reuseExistingServer: !isCI,
       },
     }

From 3d63fde28398e2b3da1816e7018b4e8d4509c652 Mon Sep 17 00:00:00 2001
From: ShareVB <sharevb@gmail.com>
Date: Mon, 6 May 2024 00:14:13 +0200
Subject: [PATCH 3/4] feat(Chmod Calculator): implement symbol form input

Fix #418 and #522
---
 components.d.ts                               |   3 +
 .../chmod-calculator.service.test.ts          | 117 +++++++++++++++++-
 .../chmod-calculator.service.ts               |  27 +++-
 .../chmod-calculator/chmod-calculator.vue     |  56 +++++++--
 src/tools/chmod-calculator/index.ts           |   5 +-
 5 files changed, 195 insertions(+), 13 deletions(-)

diff --git a/components.d.ts b/components.d.ts
index e31119b36..39fe7154c 100644
--- a/components.d.ts
+++ b/components.d.ts
@@ -127,6 +127,7 @@ declare module '@vue/runtime-core' {
     MetaTagGenerator: typeof import('./src/tools/meta-tag-generator/meta-tag-generator.vue')['default']
     MimeTypes: typeof import('./src/tools/mime-types/mime-types.vue')['default']
     NavbarButtons: typeof import('./src/components/NavbarButtons.vue')['default']
+    NCheckbox: typeof import('naive-ui')['NCheckbox']
     NCode: typeof import('naive-ui')['NCode']
     NCollapseTransition: typeof import('naive-ui')['NCollapseTransition']
     NConfigProvider: typeof import('naive-ui')['NConfigProvider']
@@ -145,6 +146,7 @@ declare module '@vue/runtime-core' {
     NMenu: typeof import('naive-ui')['NMenu']
     NScrollbar: typeof import('naive-ui')['NScrollbar']
     NSpin: typeof import('naive-ui')['NSpin']
+    NTable: typeof import('naive-ui')['NTable']
     NumeronymGenerator: typeof import('./src/tools/numeronym-generator/numeronym-generator.vue')['default']
     OtpCodeGeneratorAndValidator: typeof import('./src/tools/otp-code-generator-and-validator/otp-code-generator-and-validator.vue')['default']
     PasswordStrengthAnalyser: typeof import('./src/tools/password-strength-analyser/password-strength-analyser.vue')['default']
@@ -159,6 +161,7 @@ declare module '@vue/runtime-core' {
     RouterLink: typeof import('vue-router')['RouterLink']
     RouterView: typeof import('vue-router')['RouterView']
     RsaKeyPairGenerator: typeof import('./src/tools/rsa-key-pair-generator/rsa-key-pair-generator.vue')['default']
+    SafelinkDecoder: typeof import('./src/tools/safelink-decoder/safelink-decoder.vue')['default']
     SlugifyString: typeof import('./src/tools/slugify-string/slugify-string.vue')['default']
     SpanCopyable: typeof import('./src/components/SpanCopyable.vue')['default']
     SqlPrettify: typeof import('./src/tools/sql-prettify/sql-prettify.vue')['default']
diff --git a/src/tools/chmod-calculator/chmod-calculator.service.test.ts b/src/tools/chmod-calculator/chmod-calculator.service.test.ts
index 5264734c5..a7f94ca8b 100644
--- a/src/tools/chmod-calculator/chmod-calculator.service.test.ts
+++ b/src/tools/chmod-calculator/chmod-calculator.service.test.ts
@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import { computeChmodOctalRepresentation, computeChmodSymbolicRepresentation, computePermissionsFromChmodOctalRepresentation } from './chmod-calculator.service';
+import { computeChmodOctalRepresentation, computeChmodSymbolicRepresentation, computePermissionsFromChmodOctalRepresentation, computePermissionsFromChmodSymbolicRepresentation } from './chmod-calculator.service';
 
 describe('chmod-calculator', () => {
   describe('computeChmodOctalRepresentation', () => {
@@ -339,4 +339,119 @@ describe('chmod-calculator', () => {
       });
     });
   });
+  describe('computePermissionsFromChmodSymbolicRepresentation', () => {
+    it('throws on invalid symbolic values', () => {
+      expect(() => computePermissionsFromChmodSymbolicRepresentation('rr---')).to.throw();
+      expect(() => computePermissionsFromChmodSymbolicRepresentation('rwxrwx--w')).to.throw();
+    });
+
+    it('get permissions from symbolic representation', () => {
+      expect(
+        computePermissionsFromChmodSymbolicRepresentation('dr-xr-xr-x'),
+      ).to.eql({
+        owner: { read: true, write: false, execute: true },
+        group: { read: true, write: false, execute: true },
+        public: { read: true, write: false, execute: true },
+        flags: { setuid: false, setgid: false, stickybit: false },
+      });
+      expect(
+        computePermissionsFromChmodSymbolicRepresentation('-rw-r--r--'),
+      ).to.eql({
+        owner: { read: true, write: true, execute: false },
+        group: { read: true, write: false, execute: false },
+        public: { read: true, write: false, execute: false },
+        flags: { setuid: false, setgid: false, stickybit: false },
+      });
+
+      expect(
+        computePermissionsFromChmodSymbolicRepresentation('rwxrwxrwx'),
+      ).to.eql({
+        owner: { read: true, write: true, execute: true },
+        group: { read: true, write: true, execute: true },
+        public: { read: true, write: true, execute: true },
+        flags: { setuid: false, setgid: false, stickybit: false },
+      });
+
+      expect(
+        computePermissionsFromChmodSymbolicRepresentation('---------'),
+      ).to.eql({
+        owner: { read: false, write: false, execute: false },
+        group: { read: false, write: false, execute: false },
+        public: { read: false, write: false, execute: false },
+        flags: { setuid: false, setgid: false, stickybit: false },
+      });
+
+      expect(
+        computePermissionsFromChmodSymbolicRepresentation('r---wxr-x'),
+      ).to.eql({
+        owner: { read: true, write: false, execute: false },
+        group: { read: false, write: true, execute: true },
+        public: { read: true, write: false, execute: true },
+        flags: { setuid: false, setgid: false, stickybit: false },
+      });
+
+      expect(
+        computePermissionsFromChmodSymbolicRepresentation('r---w---x'),
+      ).to.eql({
+        owner: { read: true, write: false, execute: false },
+        group: { read: false, write: true, execute: false },
+        public: { read: false, write: false, execute: true },
+        flags: { setuid: false, setgid: false, stickybit: false },
+      });
+
+      expect(
+        computePermissionsFromChmodSymbolicRepresentation('--x-w-r--'),
+      ).to.eql({
+        owner: { read: false, write: false, execute: true },
+        group: { read: false, write: true, execute: false },
+        public: { read: true, write: false, execute: false },
+        flags: { setuid: false, setgid: false, stickybit: false },
+      });
+
+      expect(
+        computePermissionsFromChmodSymbolicRepresentation('-w--w--w-'),
+      ).to.eql({
+        owner: { read: false, write: true, execute: false },
+        group: { read: false, write: true, execute: false },
+        public: { read: false, write: true, execute: false },
+        flags: { setuid: false, setgid: false, stickybit: false },
+      });
+
+      expect(
+        computePermissionsFromChmodSymbolicRepresentation('-ws-ws-wt'),
+      ).to.eql({
+        owner: { read: false, write: true, execute: true },
+        group: { read: false, write: true, execute: true },
+        public: { read: false, write: true, execute: true },
+        flags: { setuid: true, setgid: true, stickybit: true },
+      });
+
+      expect(
+        computePermissionsFromChmodSymbolicRepresentation('-ws-w--w-'),
+      ).to.eql({
+        owner: { read: false, write: true, execute: true },
+        group: { read: false, write: true, execute: false },
+        public: { read: false, write: true, execute: false },
+        flags: { setuid: true, setgid: false, stickybit: false },
+      });
+
+      expect(
+        computePermissionsFromChmodSymbolicRepresentation('-w--ws-w-'),
+      ).to.eql({
+        owner: { read: false, write: true, execute: false },
+        group: { read: false, write: true, execute: true },
+        public: { read: false, write: true, execute: false },
+        flags: { setuid: false, setgid: true, stickybit: false },
+      });
+
+      expect(
+        computePermissionsFromChmodSymbolicRepresentation('-w--w--wt'),
+      ).to.eql({
+        owner: { read: false, write: true, execute: false },
+        group: { read: false, write: true, execute: false },
+        public: { read: false, write: true, execute: true },
+        flags: { setuid: false, setgid: false, stickybit: true },
+      });
+    });
+  });
 });
diff --git a/src/tools/chmod-calculator/chmod-calculator.service.ts b/src/tools/chmod-calculator/chmod-calculator.service.ts
index 511745f9f..9a1ced4cd 100644
--- a/src/tools/chmod-calculator/chmod-calculator.service.ts
+++ b/src/tools/chmod-calculator/chmod-calculator.service.ts
@@ -1,7 +1,7 @@
 import _ from 'lodash';
 import type { GroupPermissions, Permissions, SpecialPermissions } from './chmod-calculator.types';
 
-export { computeChmodOctalRepresentation, computeChmodSymbolicRepresentation, computePermissionsFromChmodOctalRepresentation };
+export { computeChmodOctalRepresentation, computeChmodSymbolicRepresentation, computePermissionsFromChmodOctalRepresentation, computePermissionsFromChmodSymbolicRepresentation };
 
 function computeChmodOctalRepresentation({ permissions }: { permissions: Permissions }): string {
   const permissionValue = { read: 4, write: 2, execute: 1 };
@@ -61,3 +61,28 @@ function computePermissionsFromChmodOctalRepresentation(octalPermissions: string
     flags: computePermissionObject(specialPermissionValue, flagsPosition),
   };
 }
+
+function computePermissionsFromChmodSymbolicRepresentation(symbolicPermissions: string): Permissions {
+  const formatRegex = /^[-dlbcsp]?([r-])([w-])([xs-])([r-])([w-])([xs-])([r-])([w-])([xt-])$/;
+  if (!symbolicPermissions || !symbolicPermissions.match(formatRegex)) {
+    throw new Error(`Invalid string permissions (must be in form 'rwxrwxrwx'): ${symbolicPermissions}`);
+  }
+
+  const [_, rOwner, wOwner, xOwner, rGroup, wGroup, xGroup, rAll, wAll, xAll] = formatRegex.exec(symbolicPermissions) || [];
+  const getOctal = (flag: string, flagLetter: string, flagValue: number) => flag === flagLetter ? flagValue : 0;
+  const owner = getOctal(rOwner, 'r', 4)
+  + getOctal(wOwner, 'w', 2)
+  + getOctal(xOwner, 'x', 1) + getOctal(xOwner, 's', 1);
+  const groups = getOctal(rGroup, 'r', 4)
+  + getOctal(wGroup, 'w', 2)
+  + getOctal(xGroup, 'x', 1) + getOctal(xGroup, 's', 1);
+  const all = getOctal(rAll, 'r', 4)
+  + getOctal(wAll, 'w', 2)
+  + getOctal(xAll, 'x', 1) + getOctal(xAll, 't', 1);
+  const flags = getOctal(xOwner, 's', 4)
+    + getOctal(xGroup, 's', 2)
+    + getOctal(xAll, 't', 1);
+  const octalString = `${(flags > 0 ? flags : '')}${owner}${groups}${all}`;
+
+  return computePermissionsFromChmodOctalRepresentation(octalString);
+}
diff --git a/src/tools/chmod-calculator/chmod-calculator.vue b/src/tools/chmod-calculator/chmod-calculator.vue
index 93f9f3ae4..ed7ec9cbf 100644
--- a/src/tools/chmod-calculator/chmod-calculator.vue
+++ b/src/tools/chmod-calculator/chmod-calculator.vue
@@ -2,7 +2,7 @@
 import { useThemeVars } from 'naive-ui';
 
 import InputCopyable from '../../components/InputCopyable.vue';
-import { computeChmodOctalRepresentation, computeChmodSymbolicRepresentation, computePermissionsFromChmodOctalRepresentation } from './chmod-calculator.service';
+import { computeChmodOctalRepresentation, computeChmodSymbolicRepresentation, computePermissionsFromChmodOctalRepresentation, computePermissionsFromChmodSymbolicRepresentation } from './chmod-calculator.service';
 
 import type { Group, Scope } from './chmod-calculator.types';
 import { useValidation } from '@/composable/validation';
@@ -23,9 +23,9 @@ const permissions = ref({
   flags: { setuid: false, setgid: false, stickybit: false },
 });
 
-const permissionsInput = ref('000');
-const permissionsInputValidation = useValidation({
-  source: permissionsInput,
+const octalPermissionsInput = ref('000');
+const octalPermissionsInputValidation = useValidation({
+  source: octalPermissionsInput,
   rules: [
     {
       message: 'Invalid octal permission string',
@@ -42,15 +42,43 @@ const permissionsInputValidation = useValidation({
   ],
 });
 watch(
-  permissionsInput,
+  octalPermissionsInput,
   (newPermissions) => {
-    if (!permissionsInputValidation.isValid) {
+    if (!octalPermissionsInputValidation.isValid) {
       return;
     }
     permissions.value = computePermissionsFromChmodOctalRepresentation(newPermissions.trim());
   },
 );
 
+const symbolicPermissionsInput = ref('---------');
+const symbolicPermissionsInputValidation = useValidation({
+  source: symbolicPermissionsInput,
+  rules: [
+    {
+      message: 'Invalid symbolic permission string',
+      validator: (value) => {
+        try {
+          computePermissionsFromChmodSymbolicRepresentation(value.trim());
+          return true;
+        }
+        catch {
+          return false;
+        }
+      },
+    },
+  ],
+});
+watch(
+  symbolicPermissionsInput,
+  (newPermissions) => {
+    if (!symbolicPermissionsInputValidation.isValid) {
+      return;
+    }
+    permissions.value = computePermissionsFromChmodSymbolicRepresentation(newPermissions.trim());
+  },
+);
+
 const octal = computed(() => computeChmodOctalRepresentation({ permissions: permissions.value }));
 const symbolic = computed(() => computeChmodSymbolicRepresentation({ permissions: permissions.value }));
 </script>
@@ -58,13 +86,25 @@ const symbolic = computed(() => computeChmodSymbolicRepresentation({ permissions
 <template>
   <div>
     <c-input-text
-      v-model:value="permissionsInput"
+      v-model:value="octalPermissionsInput"
       placeholder="Put your octal permissions here..."
       label="Copy your octal permissions"
-      :validation="permissionsInputValidation"
+      :validation="octalPermissionsInputValidation"
+      mb-2
+    />
+
+    <n-divider />
+
+    <c-input-text
+      v-model:value="symbolicPermissionsInput"
+      placeholder="Put your symbolic permissions here..."
+      label="Copy your symbolic permissions"
+      :validation="symbolicPermissionsInputValidation"
       mb-2
     />
+
     <n-divider />
+
     <n-table :bordered="false" :bottom-bordered="false" single-column class="permission-table">
       <thead>
         <tr>
diff --git a/src/tools/chmod-calculator/index.ts b/src/tools/chmod-calculator/index.ts
index e6b39df80..7d299e425 100644
--- a/src/tools/chmod-calculator/index.ts
+++ b/src/tools/chmod-calculator/index.ts
@@ -1,11 +1,10 @@
 import { FileInvoice } from '@vicons/tabler';
 import { defineTool } from '../tool';
-import { translate } from '@/plugins/i18n.plugin';
 
 export const tool = defineTool({
-  name: translate('tools.chmod-calculator.title'),
+  name: 'Chmod calculator',
   path: '/chmod-calculator',
-  description: translate('tools.chmod-calculator.description'),
+  description: 'Compute your chmod permissions and commands with this online chmod calculator.',
   keywords: [
     'chmod',
     'calculator',

From 703988880ea519e0f5653311b9fc2e83f2de71ee Mon Sep 17 00:00:00 2001
From: ShareVB <sharevb@gmail.com>
Date: Sun, 25 Aug 2024 22:19:33 +0200
Subject: [PATCH 4/4] feat: add umask computation

Fix #719
---
 .../chmod-calculator.service.test.ts          | 104 +++++++++++++++++-
 .../chmod-calculator.service.ts               |  29 ++++-
 .../chmod-calculator/chmod-calculator.vue     |   8 +-
 src/tools/chmod-calculator/index.ts           |   1 +
 4 files changed, 139 insertions(+), 3 deletions(-)

diff --git a/src/tools/chmod-calculator/chmod-calculator.service.test.ts b/src/tools/chmod-calculator/chmod-calculator.service.test.ts
index a7f94ca8b..1a994de8a 100644
--- a/src/tools/chmod-calculator/chmod-calculator.service.test.ts
+++ b/src/tools/chmod-calculator/chmod-calculator.service.test.ts
@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import { computeChmodOctalRepresentation, computeChmodSymbolicRepresentation, computePermissionsFromChmodOctalRepresentation, computePermissionsFromChmodSymbolicRepresentation } from './chmod-calculator.service';
+import { computeChmodOctalRepresentation, computeChmodSymbolicRepresentation, computePermissionsFromChmodOctalRepresentation, computePermissionsFromChmodSymbolicRepresentation, computeUmaskRepresentation } from './chmod-calculator.service';
 
 describe('chmod-calculator', () => {
   describe('computeChmodOctalRepresentation', () => {
@@ -454,4 +454,106 @@ describe('chmod-calculator', () => {
       });
     });
   });
+
+  describe('computeUmaskRepresentation', () => {
+    it('get the umask from permissions', () => {
+      expect(
+        computeUmaskRepresentation({
+          permissions: {
+            owner: { read: true, write: true, execute: true },
+            group: { read: true, write: true, execute: true },
+            public: { read: true, write: true, execute: true },
+            flags: { setuid: false, setgid: false, stickybit: false },
+          },
+        }),
+      ).to.deep.eq({
+        octal: '000',
+        symbolic: 'umask u=rwx,g=rwx,o=rwx',
+      });
+
+      expect(
+        computeUmaskRepresentation({
+          permissions: {
+            owner: { read: false, write: false, execute: false },
+            group: { read: false, write: false, execute: false },
+            public: { read: false, write: false, execute: false },
+            flags: { setuid: false, setgid: false, stickybit: false },
+          },
+        }),
+      ).to.deep.eq({
+        octal: '777',
+        symbolic: 'umask u=,g=,o=',
+      });
+
+      expect(
+        computeUmaskRepresentation({
+          permissions: {
+            owner: { read: false, write: true, execute: false },
+            group: { read: false, write: true, execute: true },
+            public: { read: true, write: false, execute: true },
+            flags: { setuid: false, setgid: false, stickybit: false },
+          },
+        }),
+      ).to.deep.eq({
+        octal: '542',
+        symbolic: 'umask u=w,g=wx,o=rx',
+      });
+
+      expect(
+        computeUmaskRepresentation({
+          permissions: {
+            owner: { read: true, write: false, execute: false },
+            group: { read: false, write: true, execute: false },
+            public: { read: false, write: false, execute: true },
+            flags: { setuid: false, setgid: false, stickybit: false },
+          },
+        }),
+      ).to.deep.eq({
+        octal: '356',
+        symbolic: 'umask u=r,g=w,o=x',
+      });
+
+      expect(
+        computeUmaskRepresentation({
+          permissions: {
+            owner: { read: false, write: false, execute: true },
+            group: { read: false, write: true, execute: false },
+            public: { read: true, write: false, execute: false },
+            flags: { setuid: false, setgid: false, stickybit: false },
+          },
+        }),
+      ).to.deep.eq({
+        octal: '653',
+        symbolic: 'umask u=x,g=w,o=r',
+      });
+
+      expect(
+        computeUmaskRepresentation({
+          permissions: {
+            owner: { read: false, write: true, execute: false },
+            group: { read: false, write: true, execute: false },
+            public: { read: false, write: true, execute: false },
+            flags: { setuid: false, setgid: false, stickybit: false },
+          },
+        }),
+      ).to.deep.eq({
+        octal: '555',
+        symbolic: 'umask u=w,g=w,o=w',
+      });
+
+      expect(
+        computeUmaskRepresentation({
+          permissions: {
+            owner: { read: false, write: false, execute: true },
+            group: { read: false, write: true, execute: false },
+            public: { read: true, write: false, execute: false },
+            flags: { setuid: true, setgid: true, stickybit: true },
+          },
+        }),
+      ).to.deep.eq({
+        octal: '653',
+        symbolic: 'umask u=x,g=w,o=r',
+      });
+    });
+  });
 });
diff --git a/src/tools/chmod-calculator/chmod-calculator.service.ts b/src/tools/chmod-calculator/chmod-calculator.service.ts
index 9a1ced4cd..e8a069f6e 100644
--- a/src/tools/chmod-calculator/chmod-calculator.service.ts
+++ b/src/tools/chmod-calculator/chmod-calculator.service.ts
@@ -1,7 +1,7 @@
 import _ from 'lodash';
 import type { GroupPermissions, Permissions, SpecialPermissions } from './chmod-calculator.types';
 
-export { computeChmodOctalRepresentation, computeChmodSymbolicRepresentation, computePermissionsFromChmodOctalRepresentation, computePermissionsFromChmodSymbolicRepresentation };
+export { computeUmaskRepresentation, computeChmodOctalRepresentation, computeChmodSymbolicRepresentation, computePermissionsFromChmodOctalRepresentation, computePermissionsFromChmodSymbolicRepresentation };
 
 function computeChmodOctalRepresentation({ permissions }: { permissions: Permissions }): string {
   const permissionValue = { read: 4, write: 2, execute: 1 };
@@ -86,3 +86,30 @@ function computePermissionsFromChmodSymbolicRepresentation(symbolicPermissions:
 
   return computePermissionsFromChmodOctalRepresentation(octalString);
 }
+
+function computeUmaskRepresentation({ permissions }: { permissions: Permissions }): {
+  octal: string
+  symbolic: string
+} {
+  const permissionValue = { read: 'r', write: 'w', execute: 'x' };
+  const getGroupPermissionValue = (permission: GroupPermissions) =>
+    _.reduce(permission, (acc, isPermSet, key) => acc + ((isPermSet ? _.get(permissionValue, key, '') : '')), '');
+
+  const symbolic = `umask u=${getGroupPermissionValue(permissions.owner)},g=${getGroupPermissionValue(permissions.group)},o=${getGroupPermissionValue(permissions.public)}`;
+  const octal = (0o777 - Number.parseInt(
+    computeChmodOctalRepresentation({
+      permissions:
+      {
+        owner: permissions.owner,
+        group: permissions.group,
+        public: permissions.public,
+        flags: { setuid: false, setgid: false, stickybit: false },
+      },
+    }), 8))
+    .toString(8)
+    .padStart(3, '0');
+
+  return {
+    symbolic, octal,
+  };
+}
diff --git a/src/tools/chmod-calculator/chmod-calculator.vue b/src/tools/chmod-calculator/chmod-calculator.vue
index ed7ec9cbf..502f84917 100644
--- a/src/tools/chmod-calculator/chmod-calculator.vue
+++ b/src/tools/chmod-calculator/chmod-calculator.vue
@@ -2,7 +2,7 @@
 import { useThemeVars } from 'naive-ui';
 
 import InputCopyable from '../../components/InputCopyable.vue';
-import { computeChmodOctalRepresentation, computeChmodSymbolicRepresentation, computePermissionsFromChmodOctalRepresentation, computePermissionsFromChmodSymbolicRepresentation } from './chmod-calculator.service';
+import { computeChmodOctalRepresentation, computeChmodSymbolicRepresentation, computePermissionsFromChmodOctalRepresentation, computePermissionsFromChmodSymbolicRepresentation, computeUmaskRepresentation } from './chmod-calculator.service';
 
 import type { Group, Scope } from './chmod-calculator.types';
 import { useValidation } from '@/composable/validation';
@@ -81,6 +81,7 @@ watch(
 
 const octal = computed(() => computeChmodOctalRepresentation({ permissions: permissions.value }));
 const symbolic = computed(() => computeChmodSymbolicRepresentation({ permissions: permissions.value }));
+const umask = computed(() => computeUmaskRepresentation({ permissions: permissions.value }));
 </script>
 
 <template>
@@ -155,6 +156,11 @@ const symbolic = computed(() => computeChmodSymbolicRepresentation({ permissions
     </div>
 
     <InputCopyable :value="`chmod ${octal} path`" readonly />
+
+    <c-card title="Umask">
+      <InputCopyable :value="umask.octal" readonly />
+      <InputCopyable :value="umask.symbolic" readonly />
+    </c-card>
   </div>
 </template>
 
diff --git a/src/tools/chmod-calculator/index.ts b/src/tools/chmod-calculator/index.ts
index 7d299e425..73e7d709d 100644
--- a/src/tools/chmod-calculator/index.ts
+++ b/src/tools/chmod-calculator/index.ts
@@ -16,6 +16,7 @@ export const tool = defineTool({
     'recursive',
     'generator',
     'octal',
+    'umask',
   ],
   component: () => import('./chmod-calculator.vue'),
   icon: FileInvoice,