@naturalcycles/backend-lib 4.18.8 → 4.19.0

package/cfg/tsconfig.json

@@ -8,13 +8,27 @@
     // Target/module
     "target": "es2022",
     "lib": ["esnext"], // add "dom" if needed
-    "module": "commonjs",
-    "moduleResolution": "node",
+    // module `nodenext` is a modern mode that auto-detects cjs/esm
+    // it also defaults `esModuleInterop` and `allowSyntheticDefaultImports` to true
+    "module": "nodenext",
+    "moduleResolution": "nodenext",
     "moduleDetection": "force",
+    // specifying these explicitly for better IDE compatibility (but they're on by default with module=nodenext)
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    // Faster compilation in general
+    // Support for external compilers (e.g esbuild)
+    // Speedup in Jest by using "isolatedModules" in 'ts-jest' config
+    "isolatedModules": true,
 
     // Emit
     "sourceMap": false,
     "declaration": false,
+    // Otherwise since es2022 it defaults to true
+    // and starts to produce different/unexpected behavior
+    // https://angular.schule/blog/2022-11-use-define-for-class-fields
+    "useDefineForClassFields": false,
+    "importHelpers": true,
 
     // Strictness
     "strict": true,
@@ -25,19 +39,10 @@
     "noImplicitOverride": true,
     "noUncheckedIndexedAccess": true,
     "noPropertyAccessFromIndexSignature": true,
-    // Otherwise since es2022 it defaults to true
-    // and starts to produce different/unexpected behavior
-    // https://angular.schule/blog/2022-11-use-define-for-class-fields
-    "useDefineForClassFields": false,
 
     // Enabled should be faster, but will catch less errors
     // "skipLibCheck": true,
 
-    // Faster compilation in general
-    // Support for external compilers (e.g esbuild)
-    // Speedup in Jest by using "isolatedModules" in 'ts-jest' config
-    "isolatedModules": true,
-
     // Disabled because of https://github.com/Microsoft/TypeScript/issues/29172
     // Need to be specified in the project tsconfig
     // "outDir": "dist",
@@ -54,7 +59,6 @@
     // Other
     "pretty": true,
     "newLine": "lf",
-    "importHelpers": true,
     "experimentalDecorators": true
   }
   // Need to be specified in the project tsconfig

package/dist/admin/adminMiddleware.js

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getLoginHtmlRedirect = exports.loginHtml = exports.requireAdminPermissions = exports.createAdminMiddleware = void 0;
-const fs = require("node:fs");
+const tslib_1 = require("tslib");
+const node_fs_1 = tslib_1.__importDefault(require("node:fs"));
 const js_lib_1 = require("@naturalcycles/js-lib");
-const ejs = require("ejs");
+const ejs_1 = tslib_1.__importDefault(require("ejs"));
 function createAdminMiddleware(adminService, cfgDefaults = {}) {
     return (reqPermissions, cfg) => requireAdminPermissions(adminService, reqPermissions, {
         ...cfgDefaults,
@@ -52,8 +53,8 @@ function loginHtml(firebaseServiceCfg) {
 exports.loginHtml = loginHtml;
 const getLoginHtml = (0, js_lib_1._memoFn)((cfg) => {
     console.log(`reading login.html`);
-    const tmpl = fs.readFileSync(`${__dirname}/login.html`, 'utf8');
-    return ejs.render(tmpl, cfg);
+    const tmpl = node_fs_1.default.readFileSync(`${__dirname}/login.html`, 'utf8');
+    return ejs_1.default.render(tmpl, cfg);
 });
 function getLoginHtmlRedirect(href) {
     return `

package/dist/admin/base.admin.service.d.ts

@@ -1,4 +1,4 @@
-import type * as FirebaseAdmin from 'firebase-admin';
+import type FirebaseAdmin from 'firebase-admin';
 import { BackendRequest, BackendRequestHandler } from '../server/server.model';
 export interface AdminServiceCfg {
     /**

package/dist/admin/firebase.shared.service.d.ts

@@ -1,5 +1,5 @@
 import type { AppOptions, ServiceAccount } from 'firebase-admin';
-import type * as FirebaseAdmin from 'firebase-admin';
+import type FirebaseAdmin from 'firebase-admin';
 export interface FirebaseSharedServiceCfg {
     /**
      * If undefined - will try to use credential.applicationDefault()

package/dist/bin/deploy-gae.js

@@ -1,13 +1,14 @@
 #!/usr/bin/env node
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
 const nodejs_lib_1 = require("@naturalcycles/nodejs-lib");
-const yargs = require("yargs");
+const yargs_1 = tslib_1.__importDefault(require("yargs"));
 const deployGae_1 = require("../deploy/deployGae");
 const deployHealthCheck_1 = require("../deploy/deployHealthCheck");
 const deployPrepare_1 = require("../deploy/deployPrepare");
 (0, nodejs_lib_1.runScript)(async () => {
-    const opt = yargs.options({
+    const opt = yargs_1.default.options({
         ...deployPrepare_1.deployPrepareYargsOptions,
         ...deployHealthCheck_1.deployHealthCheckYargsOptions,
     }).argv;

package/dist/bin/deploy-health-check.js

@@ -9,11 +9,12 @@ yarn deploy-health-check --url https://service-dot-yourproject.appspot.com
 
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
 const nodejs_lib_1 = require("@naturalcycles/nodejs-lib");
-const yargs = require("yargs");
+const yargs_1 = tslib_1.__importDefault(require("yargs"));
 const deployHealthCheck_1 = require("../deploy/deployHealthCheck");
 (0, nodejs_lib_1.runScript)(async () => {
-    const { url, ...opt } = yargs.options({
+    const { url, ...opt } = yargs_1.default.options({
         ...deployHealthCheck_1.deployHealthCheckYargsOptions,
         url: {
             type: 'string',

package/dist/bin/deploy-prepare.js

@@ -6,11 +6,12 @@ yarn deploy-prepare
 
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
 const nodejs_lib_1 = require("@naturalcycles/nodejs-lib");
-const yargs = require("yargs");
+const yargs_1 = tslib_1.__importDefault(require("yargs"));
 const deployPrepare_1 = require("../deploy/deployPrepare");
 (0, nodejs_lib_1.runScript)(async () => {
-    const opt = yargs.options(deployPrepare_1.deployPrepareYargsOptions).argv;
+    const opt = yargs_1.default.options(deployPrepare_1.deployPrepareYargsOptions).argv;
     await (0, deployPrepare_1.deployPrepare)(opt);
 });
 // deploy strategy

package/dist/deploy/backend.cfg.util.js

@@ -1,8 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getBackendCfg = void 0;
+const tslib_1 = require("tslib");
 const nodejs_lib_1 = require("@naturalcycles/nodejs-lib");
-const yaml = require("js-yaml");
+const js_yaml_1 = tslib_1.__importDefault(require("js-yaml"));
 const paths_cnst_1 = require("../paths.cnst");
 const backendCfgSchema = nodejs_lib_1.AjvSchema.readJsonSync(`${paths_cnst_1.resourcesDir}/backendCfg.schema.json`, {
     objectName: 'backend.cfg.yaml',
@@ -12,7 +13,7 @@ function getBackendCfg(projectDir = '.') {
     (0, nodejs_lib_1.requireFileToExist)(backendCfgYamlPath);
     const backendCfg = {
         serviceWithBranchName: true,
-        ...yaml.load((0, nodejs_lib_1._readFileSync)(backendCfgYamlPath)),
+        ...js_yaml_1.default.load((0, nodejs_lib_1._readFileSync)(backendCfgYamlPath)),
     };
     backendCfgSchema.validate(backendCfg);
     return backendCfg;

package/dist/deploy/deploy.util.js

@@ -1,10 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.validateGAEServiceName = exports.createAppYaml = exports.createAndSaveAppYaml = exports.createDeployInfo = exports.createAndSaveDeployInfo = void 0;
-const fs = require("node:fs");
+const tslib_1 = require("tslib");
+const node_fs_1 = tslib_1.__importDefault(require("node:fs"));
 const js_lib_1 = require("@naturalcycles/js-lib");
 const nodejs_lib_1 = require("@naturalcycles/nodejs-lib");
-const yaml = require("js-yaml");
+const js_yaml_1 = tslib_1.__importDefault(require("js-yaml"));
 const APP_YAML_DEFAULT = () => ({
     runtime: 'nodejs18',
     service: 'default',
@@ -26,7 +27,7 @@ const APP_YAML_DEFAULT = () => ({
 async function createAndSaveDeployInfo(backendCfg, targetDir) {
     const deployInfo = await createDeployInfo(backendCfg);
     const deployInfoPath = `${targetDir}/deployInfo.json`;
-    fs.writeFileSync(deployInfoPath, JSON.stringify(deployInfo, null, 2));
+    node_fs_1.default.writeFileSync(deployInfoPath, JSON.stringify(deployInfo, null, 2));
     console.log(`saved ${(0, nodejs_lib_1.dimGrey)(deployInfoPath)}`);
     return deployInfo;
 }
@@ -73,7 +74,7 @@ exports.createDeployInfo = createDeployInfo;
 function createAndSaveAppYaml(backendCfg, deployInfo, projectDir, targetDir, appYamlPassEnv = '') {
     const appYaml = createAppYaml(backendCfg, deployInfo, projectDir, appYamlPassEnv);
     const appYamlPath = `${targetDir}/app.yaml`;
-    fs.writeFileSync(appYamlPath, yaml.dump(appYaml));
+    node_fs_1.default.writeFileSync(appYamlPath, js_yaml_1.default.dump(appYaml));
     console.log(`saved ${(0, nodejs_lib_1.dimGrey)(appYamlPath)}`);
     return appYaml;
 }
@@ -89,14 +90,14 @@ function createAppYaml(backendCfg, deployInfo, projectDir, appYamlPassEnv = '')
     const appYaml = APP_YAML_DEFAULT();
     // Check existing app.yaml
     const appYamlPath = `${projectDir}/app.yaml`;
-    if (fs.existsSync(appYamlPath)) {
+    if (node_fs_1.default.existsSync(appYamlPath)) {
         console.log(`merging-in ${(0, nodejs_lib_1.dimGrey)(appYamlPath)}`);
-        (0, js_lib_1._merge)(appYaml, yaml.load(fs.readFileSync(appYamlPath, 'utf8')));
+        (0, js_lib_1._merge)(appYaml, js_yaml_1.default.load(node_fs_1.default.readFileSync(appYamlPath, 'utf8')));
     }
     const appEnvYamlPath = `${projectDir}/app.${APP_ENV}.yaml`;
-    if (fs.existsSync(appEnvYamlPath)) {
+    if (node_fs_1.default.existsSync(appEnvYamlPath)) {
         console.log(`merging-in ${(0, nodejs_lib_1.dimGrey)(appEnvYamlPath)}`);
-        (0, js_lib_1._merge)(appYaml, yaml.load(fs.readFileSync(appEnvYamlPath, 'utf8')));
+        (0, js_lib_1._merge)(appYaml, js_yaml_1.default.load(node_fs_1.default.readFileSync(appEnvYamlPath, 'utf8')));
     }
     // appYamlPassEnv
     require('dotenv').config(); // ensure .env is read

package/dist/paths.cnst.js

@@ -1,8 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.testDir = exports.srcDir = exports.resourcesDir = exports.projectDir = void 0;
-const path = require("node:path");
-exports.projectDir = path.join(__dirname, '/..');
+const tslib_1 = require("tslib");
+const node_path_1 = tslib_1.__importDefault(require("node:path"));
+exports.projectDir = node_path_1.default.join(__dirname, '/..');
 exports.resourcesDir = `${exports.projectDir}/resources`;
 exports.srcDir = `${exports.projectDir}/src`;
 exports.testDir = `${exports.srcDir}/test`;

package/dist/server/deployInfo.util.js

@@ -1,12 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getDeployInfo = void 0;
-const fs = require("node:fs");
+const tslib_1 = require("tslib");
+const node_fs_1 = tslib_1.__importDefault(require("node:fs"));
 const js_lib_1 = require("@naturalcycles/js-lib");
 exports.getDeployInfo = (0, js_lib_1._memoFn)((projectDir) => {
     const deployInfoPath = `${projectDir}/deployInfo.json`;
     try {
-        return JSON.parse(fs.readFileSync(deployInfoPath, 'utf8'));
+        return JSON.parse(node_fs_1.default.readFileSync(deployInfoPath, 'utf8'));
     }
     catch {
         // console.error(`cannot read ${deployInfoPath}, returning empty version`)

package/dist/server/getDefaultRouter.js

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getDefaultRouter = void 0;
-const express_promise_router_1 = require("express-promise-router");
+const tslib_1 = require("tslib");
+const express_promise_router_1 = tslib_1.__importDefault(require("express-promise-router"));
 /**
  * Convenience method.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturalcycles/backend-lib",
-  "version": "4.18.8",
+  "version": "4.19.0",
   "scripts": {
     "prepare": "husky install",
     "serve": "APP_ENV=dev nodemon",

package/src/admin/adminMiddleware.ts

@@ -1,6 +1,6 @@
-import * as fs from 'node:fs'
+import fs from 'node:fs'
 import { _memoFn, AppError } from '@naturalcycles/js-lib'
-import * as ejs from 'ejs'
+import ejs from 'ejs'
 import { BackendRequestHandler } from '../server/server.model'
 import { BaseAdminService } from './base.admin.service'
 import { FirebaseSharedServiceCfg } from './firebase.shared.service'

package/src/admin/base.admin.service.ts

@@ -1,6 +1,6 @@
 import { _assert, AppError } from '@naturalcycles/js-lib'
 import { dimGrey, green, red } from '@naturalcycles/nodejs-lib'
-import type * as FirebaseAdmin from 'firebase-admin'
+import type FirebaseAdmin from 'firebase-admin'
 import { BackendRequest, BackendRequestHandler } from '../server/server.model'
 
 export interface AdminServiceCfg {

package/src/admin/firebase.shared.service.ts

@@ -1,6 +1,6 @@
 import { _Memo } from '@naturalcycles/js-lib'
 import type { AppOptions, ServiceAccount } from 'firebase-admin'
-import type * as FirebaseAdmin from 'firebase-admin'
+import type FirebaseAdmin from 'firebase-admin'
 
 export interface FirebaseSharedServiceCfg {
   /**

package/src/bin/deploy-gae.ts

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 import { runScript } from '@naturalcycles/nodejs-lib'
-import * as yargs from 'yargs'
+import yargs from 'yargs'
 import { deployGae } from '../deploy/deployGae'
 import { deployHealthCheckYargsOptions } from '../deploy/deployHealthCheck'
 import { deployPrepareYargsOptions } from '../deploy/deployPrepare'

package/src/bin/deploy-health-check.ts

@@ -10,7 +10,7 @@ yarn deploy-health-check --url https://service-dot-yourproject.appspot.com
  */
 
 import { runScript } from '@naturalcycles/nodejs-lib'
-import * as yargs from 'yargs'
+import yargs from 'yargs'
 import { deployHealthCheck, deployHealthCheckYargsOptions } from '../deploy/deployHealthCheck'
 
 runScript(async () => {

package/src/bin/deploy-prepare.ts

@@ -7,7 +7,7 @@ yarn deploy-prepare
  */
 
 import { runScript } from '@naturalcycles/nodejs-lib'
-import * as yargs from 'yargs'
+import yargs from 'yargs'
 import { deployPrepare, deployPrepareYargsOptions } from '../deploy/deployPrepare'
 
 runScript(async () => {

package/src/deploy/backend.cfg.util.ts

@@ -1,6 +1,6 @@
 import { StringMap } from '@naturalcycles/js-lib'
 import { _readFileSync, AjvSchema, requireFileToExist } from '@naturalcycles/nodejs-lib'
-import * as yaml from 'js-yaml'
+import yaml from 'js-yaml'
 import { resourcesDir } from '../paths.cnst'
 
 export interface BackendCfg {

package/src/deploy/deploy.util.ts

@@ -1,7 +1,7 @@
-import * as fs from 'node:fs'
+import fs from 'node:fs'
 import { _mapValues, _merge, _truncate, localTime } from '@naturalcycles/js-lib'
 import { dimGrey, white } from '@naturalcycles/nodejs-lib'
-import * as yaml from 'js-yaml'
+import yaml from 'js-yaml'
 import { BackendCfg } from './backend.cfg.util'
 import { AppYaml, DeployInfo } from './deploy.model'
 

package/src/paths.cnst.ts

@@ -1,4 +1,4 @@
-import * as path from 'node:path'
+import path from 'node:path'
 
 export const projectDir = path.join(__dirname, '/..')
 export const resourcesDir = `${projectDir}/resources`

package/src/server/deployInfo.util.ts

@@ -1,4 +1,4 @@
-import * as fs from 'node:fs'
+import fs from 'node:fs'
 import { _memoFn } from '@naturalcycles/js-lib'
 import type { DeployInfo } from '../deploy'