apeframework 0.0.0-dev.9 → 0.1.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2023 Matthieu Symoens
+Copyright (c) 2025 Matthieu Symoens
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -4,10 +4,56 @@
 
 NPM package: [apeframework](https://www.npmjs.com/package/apeframework).
 
-GitHub repository: [ApeFramework/apeframework](https://github.com/ApeFramework/apeframework).
+GitHub repository: [MattSyms/apeframework](https://github.com/MattSyms/apeframework).
 
 ## Installation
 
 ```
 yarn add apeframework
 ```
+
+## Development
+
+Install dependencies:
+
+```
+yarn
+```
+
+Update dependencies:
+
+```
+yarn update
+```
+
+Compile:
+
+```
+yarn compile
+```
+
+Lint:
+
+```
+yarn lint
+```
+
+## Release:
+
+Tag stable release:
+
+```
+git tag v<major>.<minor>.<patch>
+```
+
+Tag dev release:
+
+```
+git tag v0.0.0-dev.<number>
+```
+
+Push tags:
+
+```
+git push --tags
+```

package/{cipher → dist/cipher}/Algorithm.js

@@ -1,9 +1,7 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Algorithm = void 0;
 var Algorithm;
 (function (Algorithm) {
     Algorithm["AES128"] = "aes-128-cbc";
     Algorithm["AES192"] = "aes-192-cbc";
     Algorithm["AES256"] = "aes-256-cbc";
-})(Algorithm || (exports.Algorithm = Algorithm = {}));
+})(Algorithm || (Algorithm = {}));
+export { Algorithm, };

package/{cipher → dist/cipher}/Cipher.d.ts

@@ -1,4 +1,4 @@
-import type { Algorithm } from './Algorithm';
+import type { Algorithm } from './Algorithm.js';
 declare class Cipher {
     private readonly algorithm;
     private readonly secret;

package/dist/cipher/Cipher.js

@@ -0,0 +1,32 @@
+import { createCipheriv, createDecipheriv, randomBytes } from 'node:crypto';
+import { DecryptError } from './errors/DecryptError.js';
+import { validateSecretLength } from './validateSecretLength.js';
+class Cipher {
+    algorithm;
+    secret;
+    constructor(params) {
+        validateSecretLength(params.algorithm, params.secret);
+        this.algorithm = params.algorithm;
+        this.secret = Buffer.from(params.secret, 'utf8');
+    }
+    encrypt(string) {
+        const iv = randomBytes(16);
+        const cipher = createCipheriv(this.algorithm, this.secret, iv);
+        return iv.toString('hex')
+            + cipher.update(string, 'utf8', 'hex')
+            + cipher.final('hex');
+    }
+    decrypt(string) {
+        const buffer = Buffer.from(string, 'hex');
+        const iv = buffer.subarray(0, 16);
+        const decipher = createDecipheriv(this.algorithm, this.secret, iv);
+        try {
+            return decipher.update(buffer.subarray(16), undefined, 'utf8')
+                + decipher.final('utf8');
+        }
+        catch (error) {
+            throw new DecryptError(error.message);
+        }
+    }
+}
+export { Cipher, };

package/{cipher → dist/cipher}/errors/DecryptError.d.ts

@@ -1,4 +1,4 @@
-import { BaseError } from '../../error/BaseError';
+import { BaseError } from '../../error/BaseError.js';
 declare class DecryptError extends BaseError {
     constructor(message: string);
 }

package/dist/cipher/errors/DecryptError.js

@@ -0,0 +1,7 @@
+import { BaseError } from '../../error/BaseError.js';
+class DecryptError extends BaseError {
+    constructor(message) {
+        super(`failed decrypting string: ${message}`);
+    }
+}
+export { DecryptError, };

package/{cipher → dist/cipher}/errors/SecretLengthError.d.ts

@@ -1,4 +1,4 @@
-import { BaseError } from '../../error/BaseError';
+import { BaseError } from '../../error/BaseError.js';
 declare class SecretLengthError extends BaseError {
     constructor();
 }

package/dist/cipher/errors/SecretLengthError.js

@@ -0,0 +1,7 @@
+import { BaseError } from '../../error/BaseError.js';
+class SecretLengthError extends BaseError {
+    constructor() {
+        super('invalid secret length');
+    }
+}
+export { SecretLengthError, };

package/{cipher → dist/cipher}/validateSecretLength.d.ts

@@ -1,3 +1,3 @@
-import { Algorithm } from './Algorithm';
+import { Algorithm } from './Algorithm.js';
 declare const validateSecretLength: (algorithm: Algorithm, secret: string) => void;
 export { validateSecretLength, };

package/dist/cipher/validateSecretLength.js

@@ -0,0 +1,13 @@
+import { Algorithm } from './Algorithm.js';
+import { SecretLengthError } from './errors/SecretLengthError.js';
+const secretLength = {
+    [Algorithm.AES128]: 16,
+    [Algorithm.AES192]: 24,
+    [Algorithm.AES256]: 32,
+};
+const validateSecretLength = (algorithm, secret) => {
+    if (Buffer.from(secret).length !== secretLength[algorithm]) {
+        throw new SecretLengthError();
+    }
+};
+export { validateSecretLength, };

package/{cli → dist/cli}/Args.d.ts

@@ -1,5 +1,5 @@
 interface Args {
     positional: string[];
-    optional: Record<string, boolean | string>;
+    optional: Record<string, boolean | string | undefined>;
 }
 export { type Args, };

package/dist/cli/Args.js

@@ -0,0 +1 @@
+export {};

package/{cli → dist/cli}/Command.d.ts

@@ -1,3 +1,3 @@
-import type { Args } from './Args';
+import type { Args } from './Args.js';
 type Command = (args: Args) => Promise<void>;
 export { type Command, };

package/dist/cli/Command.js

@@ -0,0 +1 @@
+export {};

package/{cli → dist/cli}/getArgs.d.ts

@@ -1,3 +1,3 @@
-import type { Args } from './Args';
+import type { Args } from './Args.js';
 declare const getArgs: () => Args;
 export { getArgs, };

package/dist/cli/getArgs.js

@@ -0,0 +1,5 @@
+import { parseArgs } from './parseArgs.js';
+const getArgs = () => {
+    return parseArgs(process.argv.slice(2));
+};
+export { getArgs, };

package/{cli → dist/cli}/parseArgs.d.ts

@@ -1,3 +1,3 @@
-import type { Args } from './Args';
+import type { Args } from './Args.js';
 declare const parseArgs: (args: string[]) => Args;
 export { parseArgs, };

package/{cli → dist/cli}/parseArgs.js

@@ -1,12 +1,6 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseArgs = void 0;
-const yargs_parser_1 = __importDefault(require("yargs-parser"));
+import yargsParser from 'yargs-parser';
 const parseArgs = (args) => {
-    const parsed = (0, yargs_parser_1.default)(args, {
+    const parsed = yargsParser(args, {
         configuration: {
             'boolean-negation': false,
             'camel-case-expansion': true,
@@ -28,4 +22,4 @@ const parseArgs = (args) => {
         optional,
     };
 };
-exports.parseArgs = parseArgs;
+export { parseArgs, };

package/dist/cli/utils/exit.js

@@ -0,0 +1,4 @@
+const exit = (code) => {
+    process.exit(code);
+};
+export { exit, };

package/dist/cli/utils/formatList.js

@@ -0,0 +1,7 @@
+import { EOL } from 'node:os';
+const formatList = (list) => {
+    return list
+        .map((item) => { return `  ${item}`; })
+        .join(EOL);
+};
+export { formatList, };

package/{cli → dist/cli}/utils/formatTable.js

@@ -1,7 +1,4 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.formatTable = void 0;
-const os_1 = require("os");
+import { EOL } from 'node:os';
 const formatTable = (table) => {
     const colLength = [];
     table.forEach((row) => {
@@ -17,6 +14,6 @@ const formatTable = (table) => {
             .map((col, i) => { return col.padEnd(colLength[i], ' '); })
             .join('  ');
     })
-        .join(os_1.EOL);
+        .join(EOL);
 };
-exports.formatTable = formatTable;
+export { formatTable, };

package/dist/cli/utils/formatText.js

@@ -0,0 +1,5 @@
+import { EOL } from 'node:os';
+const formatText = (text) => {
+    return text.join(EOL);
+};
+export { formatText, };

package/dist/cli/utils/print.js

@@ -0,0 +1,4 @@
+const print = (s) => {
+    process.stdout.write(s);
+};
+export { print, };

package/dist/cli/utils/printLn.js

@@ -0,0 +1,5 @@
+import { EOL } from 'node:os';
+const printLn = (s) => {
+    process.stdout.write(`${s}${EOL}`);
+};
+export { printLn, };

package/dist/config/Config.d.ts

@@ -0,0 +1,2 @@
+type Config = Record<string, any>;
+export { type Config, };

package/dist/config/Config.js

@@ -0,0 +1 @@
+export {};

package/{config → dist/config}/Properties.d.ts

@@ -1,4 +1,4 @@
-import type { Parser } from '../parser/Parser';
+import type { Parser } from '../parser/Parser.js';
 type Properties<Type> = {
     [Property in keyof Type]: {
         parser: Parser<Type[Property]>;

package/dist/config/Properties.js

@@ -0,0 +1 @@
+export {};

package/{config → dist/config}/errors/FileReadError.d.ts

@@ -1,4 +1,4 @@
-import { BaseError } from '../../error/BaseError';
+import { BaseError } from '../../error/BaseError.js';
 declare class FileReadError extends BaseError {
     constructor(path: string, message: string);
 }

package/dist/config/errors/FileReadError.js

@@ -0,0 +1,7 @@
+import { BaseError } from '../../error/BaseError.js';
+class FileReadError extends BaseError {
+    constructor(path, message) {
+        super(`failed reading file "${path}": ${message}`);
+    }
+}
+export { FileReadError, };

package/{config → dist/config}/errors/PropertyNameError.d.ts

@@ -1,4 +1,4 @@
-import { BaseError } from '../../error/BaseError';
+import { BaseError } from '../../error/BaseError.js';
 declare class PropertyNameError extends BaseError {
     constructor(name: string);
 }

package/dist/config/errors/PropertyNameError.js

@@ -0,0 +1,7 @@
+import { BaseError } from '../../error/BaseError.js';
+class PropertyNameError extends BaseError {
+    constructor(name) {
+        super(`invalid property name "${name}"`);
+    }
+}
+export { PropertyNameError, };

package/{config → dist/config}/errors/PropertyParseError.d.ts

@@ -1,4 +1,4 @@
-import { BaseError } from '../../error/BaseError';
+import { BaseError } from '../../error/BaseError.js';
 declare class PropertyParseError extends BaseError {
     constructor(name: string, source: string, message: string);
 }

package/dist/config/errors/PropertyParseError.js

@@ -0,0 +1,7 @@
+import { BaseError } from '../../error/BaseError.js';
+class PropertyParseError extends BaseError {
+    constructor(name, source, message) {
+        super(`failed parsing property "${name}" from ${source}: ${message}`);
+    }
+}
+export { PropertyParseError, };

package/{config → dist/config}/getConfig.d.ts

@@ -1,7 +1,7 @@
-import type { Config } from './Config';
-import type { Properties } from './Properties';
-import type { Args } from '../cli/Args';
-import type { Env } from '../env/Env';
+import type { Config } from './Config.js';
+import type { Properties } from './Properties.js';
+import type { Args } from '../cli/Args.js';
+import type { Env } from '../env/Env.js';
 declare const getConfig: <Type extends Config>(params: {
     properties: Properties<Type>;
     file?: {

package/dist/config/getConfig.js

@@ -0,0 +1,18 @@
+import { getPropertyEnvVar } from './getPropertyEnvVar.js';
+import { parseProperty } from './parseProperty.js';
+import { readFile } from './readFile.js';
+import { validatePropertyName } from './validatePropertyName.js';
+const getConfig = (params) => {
+    const file = params.file
+        ? readFile(params.file.path, params.file.required)
+        : {};
+    const env = params.env ?? {};
+    const args = params.args ?? { positional: [], optional: {} };
+    const config = {};
+    for (const name in params.properties) {
+        validatePropertyName(name);
+        config[name] = parseProperty(name, params.properties[name].parser, params.properties[name].default, file[name], env[getPropertyEnvVar(name)], args.optional[name]);
+    }
+    return config;
+};
+export { getConfig, };

package/{config → dist/config}/getPropertyEnvVar.js

@@ -1,6 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getPropertyEnvVar = void 0;
 const capitalLetterRegex = /[A-Z]/gu;
 const capitalLetterReplacer = (letter) => {
     return `_${letter}`;
@@ -10,4 +7,4 @@ const getPropertyEnvVar = (name) => {
         .replace(capitalLetterRegex, capitalLetterReplacer)
         .toUpperCase();
 };
-exports.getPropertyEnvVar = getPropertyEnvVar;
+export { getPropertyEnvVar, };

package/{config → dist/config}/parseProperty.d.ts

@@ -1,3 +1,3 @@
-import type { Parser } from '../parser/Parser';
+import type { Parser } from '../parser/Parser.js';
 declare const parseProperty: <Type>(name: string, parser: Parser<Type>, defaultValue: any, fileValue: any, envValue: any, argsValue: any) => Type;
 export { parseProperty, };

package/{config → dist/config}/parseProperty.js

@@ -1,7 +1,4 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseProperty = void 0;
-const PropertyParseError_1 = require("./errors/PropertyParseError");
+import { PropertyParseError } from './errors/PropertyParseError.js';
 const parseProperty = (name, parser, defaultValue, fileValue, envValue, argsValue) => {
     const sources = [
         {
@@ -31,7 +28,7 @@ const parseProperty = (name, parser, defaultValue, fileValue, envValue, argsValu
         return parser(source.value);
     }
     catch (error) {
-        throw new PropertyParseError_1.PropertyParseError(name, source.name, error.message);
+        throw new PropertyParseError(name, source.name, error.message);
     }
 };
-exports.parseProperty = parseProperty;
+export { parseProperty, };

package/dist/config/readFile.js

@@ -0,0 +1,25 @@
+import fs from 'fs-extra';
+import { FileReadError } from './errors/FileReadError.js';
+const readFile = (path, required = false) => {
+    let json = {};
+    let fileExists;
+    try {
+        fileExists = fs.existsSync(path);
+        if (fileExists) {
+            json = fs.readJsonSync(path);
+        }
+    }
+    catch (error) {
+        throw new FileReadError(path, error.message);
+    }
+    if (required && !fileExists) {
+        throw new FileReadError(path, 'missing file');
+    }
+    if (typeof json !== 'object'
+        || Array.isArray(json)
+        || json === null) {
+        throw new FileReadError(path, 'invalid content');
+    }
+    return json;
+};
+export { readFile, };

package/dist/config/validatePropertyName.js

@@ -0,0 +1,8 @@
+import { PropertyNameError } from './errors/PropertyNameError.js';
+const propertyNameRegex = /^[a-z](?:[0-9A-Za-z])*$/u;
+const validatePropertyName = (name) => {
+    if (!propertyNameRegex.test(name)) {
+        throw new PropertyNameError(name);
+    }
+};
+export { validatePropertyName, };

package/dist/env/Env.js

@@ -0,0 +1 @@
+export {};

package/{env → dist/env}/errors/FileReadError.d.ts

@@ -1,4 +1,4 @@
-import { BaseError } from '../../error/BaseError';
+import { BaseError } from '../../error/BaseError.js';
 declare class FileReadError extends BaseError {
     constructor(path: string, message: string);
 }

package/dist/env/errors/FileReadError.js

@@ -0,0 +1,7 @@
+import { BaseError } from '../../error/BaseError.js';
+class FileReadError extends BaseError {
+    constructor(path, message) {
+        super(`failed reading file "${path}": ${message}`);
+    }
+}
+export { FileReadError, };

package/{env → dist/env}/getEnv.d.ts

@@ -1,4 +1,4 @@
-import type { Env } from './Env';
+import type { Env } from './Env.js';
 declare const getEnv: (params?: {
     file?: {
         path: string;

package/dist/env/getEnv.js

@@ -0,0 +1,12 @@
+import { readFile } from './readFile.js';
+const getEnv = (params) => {
+    let file = {};
+    if (params?.file) {
+        file = readFile(params.file.path, params.file.required);
+    }
+    return {
+        ...file,
+        ...process.env,
+    };
+};
+export { getEnv, };

package/{env → dist/env}/readFile.d.ts

@@ -1,3 +1,3 @@
-import type { Env } from './Env';
+import type { Env } from './Env.js';
 declare const readFile: (path: string, required?: boolean) => Env;
 export { readFile, };

package/dist/env/readFile.js

@@ -0,0 +1,18 @@
+import dotenv from 'dotenv';
+import fs from 'fs-extra';
+import { FileReadError } from './errors/FileReadError.js';
+const readFile = (path, required = false) => {
+    try {
+        if (fs.existsSync(path)) {
+            return dotenv.parse(fs.readFileSync(path));
+        }
+    }
+    catch (error) {
+        throw new FileReadError(path, error.message);
+    }
+    if (required) {
+        throw new FileReadError(path, 'missing file');
+    }
+    return {};
+};
+export { readFile, };

package/{error → dist/error}/BaseError.js

@@ -1,6 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BaseError = void 0;
 class BaseError extends Error {
     constructor(message) {
         super(message);
@@ -9,4 +6,4 @@ class BaseError extends Error {
         Object.setPrototypeOf(this, new.target.prototype);
     }
 }
-exports.BaseError = BaseError;
+export { BaseError, };

package/dist/jwt/Algorithm.js

@@ -0,0 +1,7 @@
+var Algorithm;
+(function (Algorithm) {
+    Algorithm["HS256"] = "HS256";
+    Algorithm["HS384"] = "HS384";
+    Algorithm["HS512"] = "HS512";
+})(Algorithm || (Algorithm = {}));
+export { Algorithm, };

package/{jwt → dist/jwt}/Jwt.d.ts

@@ -1,5 +1,5 @@
-import type { Algorithm } from './Algorithm';
-import type { Payload } from './Payload';
+import type { Algorithm } from './Algorithm.js';
+import type { Payload } from './Payload.js';
 declare class Jwt {
     private readonly algorithm;
     private readonly secret;

package/{jwt → dist/jwt}/Jwt.js

@@ -1,18 +1,15 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Jwt = void 0;
-const jose_1 = require("jose");
-const validateSecretLength_1 = require("./validateSecretLength");
+import { jwtVerify, SignJWT } from 'jose';
+import { validateSecretLength } from './validateSecretLength.js';
 class Jwt {
     algorithm;
     secret;
     constructor(params) {
-        (0, validateSecretLength_1.validateSecretLength)(params.algorithm, params.secret);
+        validateSecretLength(params.algorithm, params.secret);
         this.algorithm = params.algorithm;
         this.secret = new TextEncoder().encode(params.secret);
     }
     async createToken(payload) {
-        return new jose_1.SignJWT(payload)
+        return new SignJWT(payload)
             .setProtectedHeader({
             typ: 'JWT',
             alg: this.algorithm,
@@ -21,7 +18,7 @@ class Jwt {
     }
     async verifyToken(token, timestamp) {
         try {
-            const { payload } = await (0, jose_1.jwtVerify)(token, this.secret, {
+            const { payload } = await jwtVerify(token, this.secret, {
                 typ: 'JWT',
                 currentDate: new Date(timestamp * 1000),
             });
@@ -32,4 +29,4 @@ class Jwt {
         }
     }
 }
-exports.Jwt = Jwt;
+export { Jwt, };

package/dist/jwt/Payload.js

@@ -0,0 +1 @@
+export {};

package/{jwt → dist/jwt}/errors/SecretLengthError.d.ts

@@ -1,4 +1,4 @@
-import { BaseError } from '../../error/BaseError';
+import { BaseError } from '../../error/BaseError.js';
 declare class SecretLengthError extends BaseError {
     constructor();
 }

package/dist/jwt/errors/SecretLengthError.js

@@ -0,0 +1,7 @@
+import { BaseError } from '../../error/BaseError.js';
+class SecretLengthError extends BaseError {
+    constructor() {
+        super('invalid secret length');
+    }
+}
+export { SecretLengthError, };

package/{jwt → dist/jwt}/validateSecretLength.d.ts

@@ -1,3 +1,3 @@
-import { Algorithm } from './Algorithm';
+import { Algorithm } from './Algorithm.js';
 declare const validateSecretLength: (algorithm: Algorithm, secret: string) => void;
 export { validateSecretLength, };

package/dist/jwt/validateSecretLength.js

@@ -0,0 +1,13 @@
+import { Algorithm } from './Algorithm.js';
+import { SecretLengthError } from './errors/SecretLengthError.js';
+const minSecretLength = {
+    [Algorithm.HS256]: 32,
+    [Algorithm.HS384]: 48,
+    [Algorithm.HS512]: 64,
+};
+const validateSecretLength = (algorithm, secret) => {
+    if (Buffer.from(secret).length < minSecretLength[algorithm]) {
+        throw new SecretLengthError();
+    }
+};
+export { validateSecretLength, };