@axiljs/config 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +28 -0
- package/dist/env.d.ts +27 -0
- package/dist/env.d.ts.map +1 -0
- package/dist/env.js +94 -0
- package/dist/env.js.map +1 -0
- package/dist/index.d.ts +7 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +11 -0
- package/dist/index.js.map +1 -0
- package/dist/schema.d.ts +46 -0
- package/dist/schema.d.ts.map +1 -0
- package/dist/schema.js +115 -0
- package/dist/schema.js.map +1 -0
- package/package.json +42 -0
package/README.md
ADDED
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
# @axiljs/config
|
|
2
|
+
|
|
3
|
+
Environment loading and typed configuration validation for AxilJS.
|
|
4
|
+
|
|
5
|
+
Part of the [AxilJS](https://github.com/SyntaxilitY/AxilJS) ecosystem.
|
|
6
|
+
|
|
7
|
+
## Install
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
npm install @axiljs/config
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
## Usage
|
|
14
|
+
|
|
15
|
+
```typescript
|
|
16
|
+
import { loadEnv, defineConfig } from '@axiljs/config'
|
|
17
|
+
|
|
18
|
+
loadEnv()
|
|
19
|
+
|
|
20
|
+
const config = defineConfig({
|
|
21
|
+
PORT: { type: 'number', default: 3000 },
|
|
22
|
+
DATABASE_URL: { type: 'string', required: true },
|
|
23
|
+
DEBUG: { type: 'boolean', default: false },
|
|
24
|
+
NODE_ENV: { type: 'string', enum: ['development', 'production', 'test'] }
|
|
25
|
+
})
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
Full docs: [github.com/SyntaxilitY/AxilJS](https://github.com/SyntaxilitY/AxilJS)
|
package/dist/env.d.ts
ADDED
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Environment variable loader.
|
|
3
|
+
* Reads .env files and populates process.env.
|
|
4
|
+
* No external dependencies - pure Node.js.
|
|
5
|
+
*
|
|
6
|
+
* Supports:
|
|
7
|
+
* KEY=value
|
|
8
|
+
* KEY="value with spaces"
|
|
9
|
+
* KEY='value with spaces'
|
|
10
|
+
* # comments
|
|
11
|
+
* multiline values (quoted)
|
|
12
|
+
*/
|
|
13
|
+
export interface EnvLoadOptions {
|
|
14
|
+
path?: string;
|
|
15
|
+
override?: boolean;
|
|
16
|
+
files?: string[];
|
|
17
|
+
}
|
|
18
|
+
/**
|
|
19
|
+
* Load environment variables from .env file(s) into process.env.
|
|
20
|
+
*
|
|
21
|
+
* Usage:
|
|
22
|
+
* loadEnv()
|
|
23
|
+
* loadEnv({ path: '/custom/path/.env' })
|
|
24
|
+
* loadEnv({ files: ['.env', '.env.local'] })
|
|
25
|
+
*/
|
|
26
|
+
export declare function loadEnv(options?: EnvLoadOptions): void;
|
|
27
|
+
//# sourceMappingURL=env.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,MAAM,WAAW,cAAc;IAE7B,IAAI,CAAC,EAAE,MAAM,CAAC;IAId,QAAQ,CAAC,EAAE,OAAO,CAAC;IAInB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,OAAO,GAAE,cAAmB,GAAG,IAAI,CAgC1D"}
|
package/dist/env.js
ADDED
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/**
|
|
3
|
+
* Environment variable loader.
|
|
4
|
+
* Reads .env files and populates process.env.
|
|
5
|
+
* No external dependencies - pure Node.js.
|
|
6
|
+
*
|
|
7
|
+
* Supports:
|
|
8
|
+
* KEY=value
|
|
9
|
+
* KEY="value with spaces"
|
|
10
|
+
* KEY='value with spaces'
|
|
11
|
+
* # comments
|
|
12
|
+
* multiline values (quoted)
|
|
13
|
+
*/
|
|
14
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
15
|
+
exports.loadEnv = loadEnv;
|
|
16
|
+
const fs_1 = require("fs");
|
|
17
|
+
const path_1 = require("path");
|
|
18
|
+
/**
|
|
19
|
+
* Load environment variables from .env file(s) into process.env.
|
|
20
|
+
*
|
|
21
|
+
* Usage:
|
|
22
|
+
* loadEnv()
|
|
23
|
+
* loadEnv({ path: '/custom/path/.env' })
|
|
24
|
+
* loadEnv({ files: ['.env', '.env.local'] })
|
|
25
|
+
*/
|
|
26
|
+
function loadEnv(options = {}) {
|
|
27
|
+
const cwd = process.cwd();
|
|
28
|
+
const override = options.override ?? false;
|
|
29
|
+
// Determine which files to load
|
|
30
|
+
const files = options.files
|
|
31
|
+
? options.files.map(f => (0, path_1.join)(cwd, f))
|
|
32
|
+
: [options.path || (0, path_1.join)(cwd, '.env')];
|
|
33
|
+
for (const filePath of files) {
|
|
34
|
+
if (!(0, fs_1.existsSync)(filePath)) {
|
|
35
|
+
// File doesn't exist - silently skip
|
|
36
|
+
continue;
|
|
37
|
+
}
|
|
38
|
+
try {
|
|
39
|
+
const content = (0, fs_1.readFileSync)(filePath, 'utf-8');
|
|
40
|
+
const parsed = parseEnvFile(content);
|
|
41
|
+
// Populate process.env
|
|
42
|
+
for (const [key, value] of Object.entries(parsed)) {
|
|
43
|
+
if (override || !(key in process.env)) {
|
|
44
|
+
process.env[key] = value;
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
catch (error) {
|
|
49
|
+
console.warn(`[@axiljsJS Config] Warning: Could not load env file ${filePath}:`, error.message);
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
/**
|
|
54
|
+
* Parse the content of a .env file into key-value pairs.
|
|
55
|
+
* Handles comments, quoted values, and whitespace.
|
|
56
|
+
*/
|
|
57
|
+
function parseEnvFile(content) {
|
|
58
|
+
const result = {};
|
|
59
|
+
const lines = content.split('\n');
|
|
60
|
+
for (let i = 0; i < lines.length; i++) {
|
|
61
|
+
const line = lines[i].trim();
|
|
62
|
+
// Skip empty lines and comments
|
|
63
|
+
if (!line || line.startsWith('#'))
|
|
64
|
+
continue;
|
|
65
|
+
// Find the first = sign
|
|
66
|
+
const eqIndex = line.indexOf('=');
|
|
67
|
+
if (eqIndex === -1)
|
|
68
|
+
continue;
|
|
69
|
+
const key = line.slice(0, eqIndex).trim();
|
|
70
|
+
let value = line.slice(eqIndex + 1).trim();
|
|
71
|
+
if (!key)
|
|
72
|
+
continue;
|
|
73
|
+
// Handle quoted values - strip surrounding quotes
|
|
74
|
+
if ((value.startsWith('"') && value.endsWith('"')) ||
|
|
75
|
+
(value.startsWith("'") && value.endsWith("'"))) {
|
|
76
|
+
value = value.slice(1, -1);
|
|
77
|
+
// Handle escape sequences in double-quoted strings
|
|
78
|
+
if (value.includes('\\n')) {
|
|
79
|
+
value = value.replace(/\\n/g, '\n');
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
// Remove inline comments (value=something # comment)
|
|
83
|
+
// Only for unquoted values
|
|
84
|
+
else {
|
|
85
|
+
const commentIndex = value.indexOf(' #');
|
|
86
|
+
if (commentIndex !== -1) {
|
|
87
|
+
value = value.slice(0, commentIndex).trim();
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
result[key] = value;
|
|
91
|
+
}
|
|
92
|
+
return result;
|
|
93
|
+
}
|
|
94
|
+
//# sourceMappingURL=env.js.map
|
package/dist/env.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"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"}
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,YAAY,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAE5C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}
|
package/dist/index.js
ADDED
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/**
|
|
3
|
+
* @axiljs/config - Public API
|
|
4
|
+
*/
|
|
5
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
|
+
exports.defineConfig = exports.loadEnv = void 0;
|
|
7
|
+
var env_1 = require("./env");
|
|
8
|
+
Object.defineProperty(exports, "loadEnv", { enumerable: true, get: function () { return env_1.loadEnv; } });
|
|
9
|
+
var schema_1 = require("./schema");
|
|
10
|
+
Object.defineProperty(exports, "defineConfig", { enumerable: true, get: function () { return schema_1.defineConfig; } });
|
|
11
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,6BAAgC;AAAvB,8FAAA,OAAO,OAAA;AAGhB,mCAAwC;AAA/B,sGAAA,YAAY,OAAA"}
|
package/dist/schema.d.ts
ADDED
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Configuration schema and validation.
|
|
3
|
+
* Define what env vars your app needs - get type-safe config back.
|
|
4
|
+
*
|
|
5
|
+
* Usage:
|
|
6
|
+
* const config = defineConfig({
|
|
7
|
+
* PORT: { type: 'number', default: 3000 },
|
|
8
|
+
* DATABASE_URL: { type: 'string', required: true },
|
|
9
|
+
* DEBUG: { type: 'boolean', default: false }
|
|
10
|
+
* })
|
|
11
|
+
*
|
|
12
|
+
* config.PORT // number
|
|
13
|
+
* config.DATABASE_URL // string
|
|
14
|
+
* config.DEBUG // boolean
|
|
15
|
+
*/
|
|
16
|
+
type FieldType = 'string' | 'number' | 'boolean' | 'json';
|
|
17
|
+
type TypeMap = {
|
|
18
|
+
string: string;
|
|
19
|
+
number: number;
|
|
20
|
+
boolean: boolean;
|
|
21
|
+
json: unknown;
|
|
22
|
+
};
|
|
23
|
+
interface FieldDef<T extends FieldType> {
|
|
24
|
+
type: T;
|
|
25
|
+
required?: boolean;
|
|
26
|
+
default?: TypeMap[T];
|
|
27
|
+
description?: string;
|
|
28
|
+
enum?: TypeMap[T][];
|
|
29
|
+
min?: number;
|
|
30
|
+
max?: number;
|
|
31
|
+
}
|
|
32
|
+
type Schema = Record<string, FieldDef<FieldType>>;
|
|
33
|
+
type InferConfig<S extends Schema> = {
|
|
34
|
+
[K in keyof S]: S[K] extends FieldDef<infer T> ? S[K]['required'] extends true ? TypeMap[T] : S[K]['default'] extends TypeMap[T] ? TypeMap[T] : TypeMap[T] | undefined : never;
|
|
35
|
+
};
|
|
36
|
+
/**
|
|
37
|
+
* Define and validate application configuration from environment variables.
|
|
38
|
+
* Throws ValidationError on startup if required vars are missing.
|
|
39
|
+
*
|
|
40
|
+
* @param schema Configuration schema definition
|
|
41
|
+
* @param source Environment source (default: process.env)
|
|
42
|
+
* @returns Parsed and typed configuration object
|
|
43
|
+
*/
|
|
44
|
+
export declare function defineConfig<S extends Schema>(schema: S, source?: Record<string, string | undefined>): InferConfig<S>;
|
|
45
|
+
export {};
|
|
46
|
+
//# sourceMappingURL=schema.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAOH,KAAK,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAG1D,KAAK,OAAO,GAAG;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;CACf,CAAC;AAIF,UAAU,QAAQ,CAAC,CAAC,SAAS,SAAS;IAEpC,IAAI,EAAE,CAAC,CAAC;IAGR,QAAQ,CAAC,EAAE,OAAO,CAAC;IAGnB,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAGrB,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAGpB,GAAG,CAAC,EAAE,MAAM,CAAC;IAGb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAKD,KAAK,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;AAGlD,KAAK,WAAW,CAAC,CAAC,SAAS,MAAM,IAAI;KAClC,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,QAAQ,CAAC,MAAM,CAAC,CAAC,GAC1C,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,IAAI,GAC3B,OAAO,CAAC,CAAC,CAAC,GACV,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,OAAO,CAAC,CAAC,CAAC,GAClC,OAAO,CAAC,CAAC,CAAC,GACV,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,GACxB,KAAK;CACV,CAAC;AAIF;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAC3C,MAAM,EAAE,CAAC,EACT,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GACvD,WAAW,CAAC,CAAC,CAAC,CAmEhB"}
|
package/dist/schema.js
ADDED
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/**
|
|
3
|
+
* Configuration schema and validation.
|
|
4
|
+
* Define what env vars your app needs - get type-safe config back.
|
|
5
|
+
*
|
|
6
|
+
* Usage:
|
|
7
|
+
* const config = defineConfig({
|
|
8
|
+
* PORT: { type: 'number', default: 3000 },
|
|
9
|
+
* DATABASE_URL: { type: 'string', required: true },
|
|
10
|
+
* DEBUG: { type: 'boolean', default: false }
|
|
11
|
+
* })
|
|
12
|
+
*
|
|
13
|
+
* config.PORT // number
|
|
14
|
+
* config.DATABASE_URL // string
|
|
15
|
+
* config.DEBUG // boolean
|
|
16
|
+
*/
|
|
17
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
18
|
+
exports.defineConfig = defineConfig;
|
|
19
|
+
const common_1 = require("@axiljs/common");
|
|
20
|
+
// ─── defineConfig ─────────────────────────────────────────────────────────────
|
|
21
|
+
/**
|
|
22
|
+
* Define and validate application configuration from environment variables.
|
|
23
|
+
* Throws ValidationError on startup if required vars are missing.
|
|
24
|
+
*
|
|
25
|
+
* @param schema Configuration schema definition
|
|
26
|
+
* @param source Environment source (default: process.env)
|
|
27
|
+
* @returns Parsed and typed configuration object
|
|
28
|
+
*/
|
|
29
|
+
function defineConfig(schema, source = process.env) {
|
|
30
|
+
const config = {};
|
|
31
|
+
const errors = [];
|
|
32
|
+
for (const [key, field] of Object.entries(schema)) {
|
|
33
|
+
const rawValue = source[key];
|
|
34
|
+
// Check if value is missing
|
|
35
|
+
if (rawValue === undefined || rawValue === '') {
|
|
36
|
+
if (field.required && field.default === undefined) {
|
|
37
|
+
// Required and no default - validation error
|
|
38
|
+
const desc = field.description ? ` (${field.description})` : '';
|
|
39
|
+
errors.push(`Missing required environment variable: ${key}${desc}`);
|
|
40
|
+
continue;
|
|
41
|
+
}
|
|
42
|
+
// Use default value
|
|
43
|
+
config[key] = field.default;
|
|
44
|
+
continue;
|
|
45
|
+
}
|
|
46
|
+
// Parse the string value into the correct type
|
|
47
|
+
try {
|
|
48
|
+
const parsed = parseValue(rawValue, field.type, key);
|
|
49
|
+
// Run enum validation
|
|
50
|
+
if (field.enum && !field.enum.includes(parsed)) {
|
|
51
|
+
errors.push(`Invalid value for ${key}: '${rawValue}'. ` +
|
|
52
|
+
`Allowed values: ${field.enum.join(', ')}`);
|
|
53
|
+
continue;
|
|
54
|
+
}
|
|
55
|
+
// Run numeric range validation
|
|
56
|
+
if (field.type === 'number') {
|
|
57
|
+
const num = parsed;
|
|
58
|
+
if (field.min !== undefined && num < field.min) {
|
|
59
|
+
errors.push(`${key} must be >= ${field.min}, got ${num}`);
|
|
60
|
+
continue;
|
|
61
|
+
}
|
|
62
|
+
if (field.max !== undefined && num > field.max) {
|
|
63
|
+
errors.push(`${key} must be <= ${field.max}, got ${num}`);
|
|
64
|
+
continue;
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
config[key] = parsed;
|
|
68
|
+
}
|
|
69
|
+
catch (parseError) {
|
|
70
|
+
errors.push(parseError.message);
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
// If any validation errors, throw them all at once
|
|
74
|
+
if (errors.length > 0) {
|
|
75
|
+
throw new common_1.ValidationError('Configuration validation failed:\n' +
|
|
76
|
+
errors.map(e => ` - ${e}`).join('\n'), errors);
|
|
77
|
+
}
|
|
78
|
+
return config;
|
|
79
|
+
}
|
|
80
|
+
/**
|
|
81
|
+
* Parse a string value into the specified type.
|
|
82
|
+
*/
|
|
83
|
+
function parseValue(raw, type, key) {
|
|
84
|
+
switch (type) {
|
|
85
|
+
case 'string':
|
|
86
|
+
return raw;
|
|
87
|
+
case 'number': {
|
|
88
|
+
const num = Number(raw);
|
|
89
|
+
if (isNaN(num)) {
|
|
90
|
+
throw new Error(`Invalid value for ${key}: '${raw}' is not a valid number`);
|
|
91
|
+
}
|
|
92
|
+
return num;
|
|
93
|
+
}
|
|
94
|
+
case 'boolean': {
|
|
95
|
+
const lower = raw.toLowerCase();
|
|
96
|
+
if (['true', '1', 'yes', 'on'].includes(lower))
|
|
97
|
+
return true;
|
|
98
|
+
if (['false', '0', 'no', 'off'].includes(lower))
|
|
99
|
+
return false;
|
|
100
|
+
throw new Error(`Invalid value for ${key}: '${raw}' is not a valid boolean. ` +
|
|
101
|
+
`Use true/false, 1/0, yes/no, on/off`);
|
|
102
|
+
}
|
|
103
|
+
case 'json': {
|
|
104
|
+
try {
|
|
105
|
+
return JSON.parse(raw);
|
|
106
|
+
}
|
|
107
|
+
catch {
|
|
108
|
+
throw new Error(`Invalid value for ${key}: '${raw}' is not valid JSON`);
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
default:
|
|
112
|
+
return raw;
|
|
113
|
+
}
|
|
114
|
+
}
|
|
115
|
+
//# sourceMappingURL=schema.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"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"}
|
package/package.json
ADDED
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@axiljs/config",
|
|
3
|
+
"version": "0.1.0",
|
|
4
|
+
"description": "AxilJS environment loading and typed configuration validation",
|
|
5
|
+
"main": "dist/index.js",
|
|
6
|
+
"types": "dist/index.d.ts",
|
|
7
|
+
"scripts": {
|
|
8
|
+
"build": "tsc",
|
|
9
|
+
"dev": "tsc --watch"
|
|
10
|
+
},
|
|
11
|
+
"dependencies": {
|
|
12
|
+
"@axiljs/common": "0.1.0"
|
|
13
|
+
},
|
|
14
|
+
"devDependencies": {
|
|
15
|
+
"typescript": "^5.4.0",
|
|
16
|
+
"@types/node": "^20.0.0"
|
|
17
|
+
},
|
|
18
|
+
"publishConfig": {
|
|
19
|
+
"access": "public"
|
|
20
|
+
},
|
|
21
|
+
"repository": {
|
|
22
|
+
"type": "git",
|
|
23
|
+
"url": "git+https://github.com/SyntaxilitY/AxilJS.git"
|
|
24
|
+
},
|
|
25
|
+
"homepage": "https://github.com/SyntaxilitY/AxilJS#readme",
|
|
26
|
+
"bugs": {
|
|
27
|
+
"url": "https://github.com/SyntaxilitY/AxilJS/issues"
|
|
28
|
+
},
|
|
29
|
+
"author": "Tariq Mehmood <tariq@syntaxility.dev>",
|
|
30
|
+
"license": "MIT",
|
|
31
|
+
"keywords": [
|
|
32
|
+
"axiljs",
|
|
33
|
+
"backend",
|
|
34
|
+
"javascript",
|
|
35
|
+
"typescript",
|
|
36
|
+
"nodejs"
|
|
37
|
+
],
|
|
38
|
+
"files": [
|
|
39
|
+
"dist",
|
|
40
|
+
"README.md"
|
|
41
|
+
]
|
|
42
|
+
}
|