1.1.0

Author: Elschnagoo

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grandlinex/core",
-  "version": "1.1.0-alpha.0",
+  "version": "1.1.0",
   "description": "Core module",
   "type": "module",
   "exports": {

src/classes/index.ts

@@ -17,6 +17,7 @@ import CoreDBUpdate from './CoreDBUpdate.js';
 import CoreBundleModule from './CoreBundleModule.js';
 import CoreTriggerService from './CoreTriggerService.js';
 import CoreCachedFc from './CoreCachedFc.js';
+import CoreKernelExtension from './CoreKernelExtension.js';
 import CMap from './CoreMap.js';
 import CoreTimeCache, { CachedData } from './CoreTimeCache.js';
 
@@ -44,6 +45,7 @@ export {
   CMap,
   CoreTimeCache,
   CachedData,
+  CoreKernelExtension,
 };
 
 export * from './annotation/index.js';

src/utils/Type.ts

@@ -0,0 +1,25 @@
+export default class Type {
+  static isUUID(str: string): boolean {
+    const uidReg =
+      /^[0-9a-fA-F]{8}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{12}$/;
+    return uidReg.test(str);
+  }
+
+  static isIsoDate(data: string): boolean {
+    return /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{1,3})?(?:Z|[+-]\d{2}:\d{2})?$/.test(
+      data,
+    );
+  }
+
+  static isString(a: unknown): a is string {
+    return typeof a === 'string' && a.length > 0;
+  }
+
+  static isNumber(a: unknown): a is number {
+    return typeof a === 'number';
+  }
+
+  static isBoolean(a: unknown): a is boolean {
+    return typeof a === 'boolean';
+  }
+}

src/utils/XUtil.ts

@@ -1,5 +1,7 @@
 import fs from 'fs';
 import * as Path from 'path';
+import https from 'https';
+import http from 'http';
 import { ColumnProps, getEntityMeta, IEntity } from '../classes/index.js';
 import CoreEntity from '../classes/CoreEntity.js';
 import { Executable, ExecutableOptions } from './Executable.js';
@@ -15,6 +17,42 @@ export type XExecResult = {
   stdout: string;
   stderr: string;
 };
+export const MineTypeMap = new Map<string, string>([
+  ['text/html; charset=utf-8', 'html'],
+  ['text/html', 'html'],
+  ['text/plain', 'txt'],
+  ['video/mp4', 'mp4'],
+  ['video/mpeg', 'mpeg'],
+  ['video/webm', 'webm'],
+  ['audio/webm', 'weba'],
+  ['audio/mpeg', 'mp3'],
+  ['audio/wav', 'wav'],
+  ['audio/aac', 'aac'],
+  ['audio/webm', 'aac'],
+  ['audio/opus', 'opus'],
+  ['image/webp', 'webp'],
+  ['image/png', 'png'],
+  ['image/jpeg', 'jpg'],
+  ['image/gif', 'gif'],
+  ['image/webp', 'webp'],
+  ['image/svg+xml', 'svg'],
+  ['application/pdf', 'pdf'],
+  ['application/zip', 'zip'],
+  ['application/x-rar-compressed', 'rar'],
+  ['application/x-7z-compressed', '7z'],
+  ['application/x-tar', 'tar'],
+  ['application/x-bzip2', 'bz2'],
+  ['application/x-gzip', 'gz'],
+  ['application/json; charset=utf-8', 'json'],
+]);
+
+function selectClient(url: string) {
+  if (url.startsWith('https')) {
+    return https;
+  }
+  return http;
+}
+
 export class XUtil {
   /*
    * TIME
@@ -206,4 +244,49 @@ export class XUtil {
     const exe = new Executable(cmd, options);
     return exe.run(args);
   }
+
+  static downloadFile(
+    url: string,
+    path: string,
+    extMap = MineTypeMap,
+  ): Promise<{
+    name: string;
+    size: number;
+    type: string;
+  } | null> {
+    return new Promise((resolve) => {
+      try {
+        selectClient(url)
+          .get(url, (res) => {
+            const raw = extMap.get(res.headers['content-type'] as string);
+            const ext = raw || 'blob';
+            const fName = `${path}.${ext}`;
+            const file = fs.createWriteStream(fName);
+            // A chunk of data has been received.
+            res.on('data', (chunk) => {
+              file.write(chunk);
+            });
+
+            // The whole response has been received. Print out the result.
+            res.on('end', () => {
+              const cl = res.headers['content-length'];
+              const cli = parseInt(cl as string, 10);
+              file.close();
+              resolve({
+                size: cli,
+                name: Path.basename(fName),
+                type: res.headers['content-type'] || '',
+              });
+            });
+          })
+          .on('error', (err) => {
+            console.error(`Error: ${err.message}`);
+            resolve(null);
+          });
+      } catch (e) {
+        console.error(e);
+        resolve(null);
+      }
+    });
+  }
 }

src/utils/index.ts

@@ -1,3 +1,7 @@
+import Type from './Type.js';
+
 export * from './EntityValidator.js';
 export * from './Executable.js';
 export * from './XUtil.js';
+
+export { Type };