@naturalcycles/backend-lib 8.0.2 → 8.0.4

package/cfg/tsconfig.json

@@ -27,7 +27,7 @@
     // 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,
+    "useDefineForClassFields": true,
     "importHelpers": true,
 
     // Strictness
@@ -38,6 +38,7 @@
     "suppressImplicitAnyIndexErrors": false,
     "noImplicitOverride": true,
     "noUncheckedIndexedAccess": true,
+    "noUncheckedSideEffectImports": true,
     "noPropertyAccessFromIndexSignature": true,
 
     // Enabled should be faster, but will catch less errors

package/dist/admin/adminMiddleware.d.ts

@@ -1,6 +1,6 @@
-import { BackendRequestHandler } from '../server/server.model';
-import { BaseAdminService } from './base.admin.service';
-import { FirebaseSharedServiceCfg } from './firebase.shared.service';
+import type { BackendRequestHandler } from '../server/server.model';
+import type { BaseAdminService } from './base.admin.service';
+import type { FirebaseSharedServiceCfg } from './firebase.shared.service';
 export interface RequireAdminCfg {
     /**
      * @default '/login.html'

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

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

package/dist/admin/base.admin.service.js

@@ -11,6 +11,7 @@ const adminInfoDisabled = () => ({
  * Base implementation based on Firebase Auth tokens passed as 'admin_token' cookie.
  */
 class BaseAdminService {
+    firebaseAuth;
     constructor(firebaseAuth, cfg) {
         this.firebaseAuth = firebaseAuth;
         this.cfg = {
@@ -19,6 +20,7 @@ class BaseAdminService {
             ...cfg,
         };
     }
+    cfg;
     adminInfoDisabled() {
         return {
             email: 'authDisabled',

package/dist/admin/firebase.shared.service.js

@@ -4,6 +4,7 @@ exports.FirebaseSharedService = void 0;
 const tslib_1 = require("tslib");
 const js_lib_1 = require("@naturalcycles/js-lib");
 class FirebaseSharedService {
+    cfg;
     constructor(cfg) {
         this.cfg = cfg;
     }

package/dist/admin/secureHeaderMiddleware.d.ts

@@ -1,5 +1,5 @@
-import { AdminMiddleware, RequireAdminCfg } from './adminMiddleware';
-import { BaseAdminService } from './base.admin.service';
+import type { AdminMiddleware, RequireAdminCfg } from './adminMiddleware';
+import type { BaseAdminService } from './base.admin.service';
 export interface SecureHeaderMiddlewareCfg extends RequireAdminCfg {
     adminService: BaseAdminService;
     /**

package/dist/db/httpDB.d.ts

@@ -1,6 +1,7 @@
-import { BaseCommonDB, CommonDB, CommonDBOptions, CommonDBSaveOptions, CommonDBStreamOptions, CommonDBSupport, DBQuery, RunQueryResult } from '@naturalcycles/db-lib';
-import { FetcherOptions, JsonSchemaRootObject, ObjectWithId } from '@naturalcycles/js-lib';
-import { ReadableTyped } from '@naturalcycles/nodejs-lib';
+import type { CommonDB, CommonDBOptions, CommonDBSaveOptions, CommonDBStreamOptions, CommonDBSupport, DBQuery, RunQueryResult } from '@naturalcycles/db-lib';
+import { BaseCommonDB } from '@naturalcycles/db-lib';
+import type { FetcherOptions, JsonSchemaRootObject, ObjectWithId } from '@naturalcycles/js-lib';
+import type { ReadableTyped } from '@naturalcycles/nodejs-lib';
 export interface HttpDBCfg extends FetcherOptions {
     baseUrl: string;
 }

package/dist/db/httpDB.js

@@ -8,25 +8,27 @@ const js_lib_1 = require("@naturalcycles/js-lib");
  * Implementation of CommonDB that proxies all requests via HTTP to "httpDBRequestHandler".
  */
 class HttpDB extends db_lib_1.BaseCommonDB {
+    cfg;
+    support = {
+        ...db_lib_1.commonDBFullSupport,
+        streaming: false,
+        createTable: false,
+        bufferValues: false,
+        updateSaveMethod: false,
+        insertSaveMethod: false,
+        transactions: false,
+        patchByQuery: false,
+        increment: false,
+    };
     constructor(cfg) {
         super();
         this.cfg = cfg;
-        this.support = {
-            ...db_lib_1.commonDBFullSupport,
-            streaming: false,
-            createTable: false,
-            bufferValues: false,
-            updateSaveMethod: false,
-            insertSaveMethod: false,
-            transactions: false,
-            patchByQuery: false,
-            increment: false,
-        };
         this.setCfg(cfg);
     }
     setCfg(cfg) {
         this.fetcher = (0, js_lib_1.getFetcher)(cfg);
     }
+    fetcher;
     async ping() {
         await this.fetcher.getVoid(`ping`);
     }

package/dist/db/httpDBRequestHandler.d.ts

@@ -1,6 +1,7 @@
-import { CommonDB, CommonDBOptions, CommonDBSaveOptions, DBQuery } from '@naturalcycles/db-lib';
-import { ObjectWithId } from '@naturalcycles/js-lib';
-import { BackendRouter } from '..';
+import type { CommonDB, CommonDBOptions, CommonDBSaveOptions } from '@naturalcycles/db-lib';
+import { DBQuery } from '@naturalcycles/db-lib';
+import type { ObjectWithId } from '@naturalcycles/js-lib';
+import type { BackendRouter } from '..';
 export interface GetByIdsInput {
     table: string;
     ids: string[];

package/dist/db/index.d.ts

@@ -1,4 +1,5 @@
-import { HttpDB, HttpDBCfg } from './httpDB';
+import type { HttpDBCfg } from './httpDB';
+import { HttpDB } from './httpDB';
 import { httpDBRequestHandler } from './httpDBRequestHandler';
 export type { HttpDBCfg };
 export { HttpDB, httpDBRequestHandler };

package/dist/deploy/backend.cfg.util.d.ts

@@ -1,4 +1,4 @@
-import { StringMap } from '@naturalcycles/js-lib';
+import type { StringMap } from '@naturalcycles/js-lib';
 export interface BackendCfg {
     gaeProject: string;
     gaeProjectByBranch?: StringMap;

package/dist/deploy/deploy.util.d.ts

@@ -1,5 +1,5 @@
-import { BackendCfg } from './backend.cfg.util';
-import { AppYaml, DeployInfo } from './deploy.model';
+import type { BackendCfg } from './backend.cfg.util';
+import type { AppYaml, DeployInfo } from './deploy.model';
 export declare function createAndSaveDeployInfo(backendCfg: BackendCfg, targetDir: string): Promise<DeployInfo>;
 export declare function createDeployInfo(backendCfg: BackendCfg, overrideBranch?: string): Promise<DeployInfo>;
 export declare function createAndSaveAppYaml(backendCfg: BackendCfg, deployInfo: DeployInfo, projectDir: string, targetDir: string, appYamlPassEnv?: string): AppYaml;

package/dist/deploy/deployGae.d.ts

@@ -1,5 +1,5 @@
-import { DeployHealthCheckOptions } from './deployHealthCheck';
-import { DeployPrepareOptions } from './deployPrepare';
+import type { DeployHealthCheckOptions } from './deployHealthCheck';
+import type { DeployPrepareOptions } from './deployPrepare';
 export interface DeployGaeOptions extends DeployPrepareOptions, DeployHealthCheckOptions {
 }
 export declare function deployGae(opt?: DeployGaeOptions): Promise<void>;

package/dist/deploy/deployPrepare.d.ts

@@ -1,4 +1,4 @@
-import { DeployInfo } from './deploy.model';
+import type { DeployInfo } from './deploy.model';
 export interface DeployPrepareOptions {
     projectDir?: string;
     targetDir?: string;

package/dist/deploy/index.d.ts

@@ -1,8 +1,10 @@
-import { BackendCfg, getBackendCfg } from './backend.cfg.util';
-import { DeployInfo } from './deploy.model';
+import type { BackendCfg } from './backend.cfg.util';
+import { getBackendCfg } from './backend.cfg.util';
+import type { DeployInfo } from './deploy.model';
 import { createAppYaml, createDeployInfo } from './deploy.util';
 import { deployGae } from './deployGae';
-import { deployHealthCheck, DeployHealthCheckOptions } from './deployHealthCheck';
+import type { DeployHealthCheckOptions } from './deployHealthCheck';
+import { deployHealthCheck } from './deployHealthCheck';
 import { deployPrepare } from './deployPrepare';
 export type { BackendCfg, DeployHealthCheckOptions, DeployInfo };
 export { createAppYaml, createDeployInfo, deployGae, deployHealthCheck, deployPrepare, getBackendCfg, };

package/dist/env/env.shared.service.d.ts

@@ -1,4 +1,4 @@
-import { StringMap } from '@naturalcycles/js-lib';
+import type { StringMap } from '@naturalcycles/js-lib';
 export interface BaseEnv {
     name: string;
 }

package/dist/env/env.shared.service.js

@@ -7,6 +7,8 @@ class EnvSharedService {
     constructor(cfg) {
         this.envMap = (0, js_lib_1._by)(cfg.environments, e => e.name);
     }
+    envMap;
+    env;
     init() {
         this.getEnv();
     }

package/dist/sentry/sentry.shared.service.d.ts

@@ -1,4 +1,4 @@
-import { CommonLogger, Primitive, StringMap } from '@naturalcycles/js-lib';
+import type { CommonLogger, Primitive, StringMap } from '@naturalcycles/js-lib';
 import type { Breadcrumb, SeverityLevel } from '@sentry/node';
 import type * as SentryLib from '@sentry/node';
 export interface SentrySharedServiceCfg {

package/dist/sentry/sentry.shared.service.js

@@ -28,6 +28,7 @@ class SentrySharedService {
     constructor(sentryServiceCfg) {
         this.sentry = sentryServiceCfg.sentry;
     }
+    sentry;
     /**
      * For GDPR reasons we never send more information than just User ID.
      */

package/dist/server/asyncLocalStorageMiddleware.d.ts

@@ -1,5 +1,5 @@
-import { CommonLogger } from '@naturalcycles/js-lib';
-import { BackendRequest, BackendRequestHandler } from './server.model';
+import type { CommonLogger } from '@naturalcycles/js-lib';
+import type { BackendRequest, BackendRequestHandler } from './server.model';
 export interface RequestLocalStorage {
     req: BackendRequest;
 }

package/dist/server/basicAuthMiddleware.d.ts

@@ -1,5 +1,5 @@
-import { StringMap } from '@naturalcycles/js-lib';
-import { BackendRequestHandler } from './server.model';
+import type { StringMap } from '@naturalcycles/js-lib';
+import type { BackendRequestHandler } from './server.model';
 export interface BasicAuthMiddlewareCfg {
     /**
      * Map from login (Sting) to password (String).

package/dist/server/bodyParserTimeoutMiddleware.d.ts

@@ -1,4 +1,4 @@
-import { BackendRequestHandler } from '../index';
+import type { BackendRequestHandler } from '../index';
 export interface BodyParserTimeoutMiddlewareCfg {
     /**
      * @default 10

package/dist/server/createDefaultApp.d.ts

@@ -1,3 +1,3 @@
-import { BackendApplication } from '..';
-import { DefaultAppCfg } from './createDefaultApp.model';
+import type { BackendApplication } from '..';
+import type { DefaultAppCfg } from './createDefaultApp.model';
 export declare function createDefaultApp(cfg: DefaultAppCfg): BackendApplication;

package/dist/server/createDefaultApp.model.d.ts

@@ -1,8 +1,8 @@
-import { Options, OptionsJson, OptionsUrlencoded } from 'body-parser';
-import { CorsOptions } from 'cors';
-import { SentrySharedService } from '../sentry/sentry.shared.service';
-import { GenericErrorMiddlewareCfg } from './genericErrorMiddleware';
-import { BackendRequestHandler } from './server.model';
+import type { Options, OptionsJson, OptionsUrlencoded } from 'body-parser';
+import type { CorsOptions } from 'cors';
+import type { SentrySharedService } from '../sentry/sentry.shared.service';
+import type { GenericErrorMiddlewareCfg } from './genericErrorMiddleware';
+import type { BackendRequestHandler } from './server.model';
 /**
  * Plain RequestHandler can be provided - then it's mounted to /
  * Otherwise `path` can be provided to specify mounting point.

package/dist/server/genericErrorMiddleware.d.ts

@@ -1,6 +1,6 @@
-import { ErrorObject } from '@naturalcycles/js-lib';
-import { SentrySharedService } from '../sentry/sentry.shared.service';
-import { BackendErrorRequestHandler, BackendRequest, BackendResponse } from './server.model';
+import type { ErrorObject } from '@naturalcycles/js-lib';
+import type { SentrySharedService } from '../sentry/sentry.shared.service';
+import type { BackendErrorRequestHandler, BackendRequest, BackendResponse } from './server.model';
 export interface GenericErrorMiddlewareCfg {
     sentryService?: SentrySharedService;
     /**

package/dist/server/getDefaultRouter.d.ts

@@ -1,4 +1,4 @@
-import { BackendRequestHandler, BackendRouter } from './server.model';
+import type { BackendRequestHandler, BackendRouter } from './server.model';
 /**
  * Convenience method.
  */

package/dist/server/logMiddleware.d.ts

@@ -1,5 +1,5 @@
-import { CommonLogger } from '@naturalcycles/js-lib';
-import { BackendRequestHandler } from './server.model';
+import type { CommonLogger } from '@naturalcycles/js-lib';
+import type { BackendRequestHandler } from './server.model';
 /**
  * Logger that logs in AppEngine format.
  * To be used in outside-of-request situations (otherwise req.log should be used).

package/dist/server/methodOverrideMiddleware.d.ts

@@ -1,4 +1,4 @@
-import { BackendRequestHandler } from './server.model';
+import type { BackendRequestHandler } from './server.model';
 export interface MethodOverrideMiddlewareCfg {
     /**
      * @default _method

package/dist/server/notFoundMiddleware.d.ts

@@ -1,2 +1,2 @@
-import { BackendRequestHandler } from './server.model';
+import type { BackendRequestHandler } from './server.model';
 export declare function notFoundMiddleware(): BackendRequestHandler;

package/dist/server/okMiddleware.d.ts

@@ -1,2 +1,2 @@
-import { BackendRequestHandler } from './server.model';
+import type { BackendRequestHandler } from './server.model';
 export declare function okMiddleware(): BackendRequestHandler;

package/dist/server/request.log.util.d.ts

@@ -1,3 +1,3 @@
-import { BackendRequest } from './server.model';
+import type { BackendRequest } from './server.model';
 export declare function logRequest(req: BackendRequest, statusCode: number, ...tokens: any[]): void;
 export declare function coloredHttpCode(statusCode: number): string;

package/dist/server/request.util.d.ts

@@ -1,4 +1,4 @@
-import { BackendRequest } from './server.model';
+import type { BackendRequest } from './server.model';
 /**
  * Returns e.g:
  *

package/dist/server/requestTimeoutMiddleware.d.ts

@@ -1,5 +1,5 @@
-import { NumberOfSeconds } from '@naturalcycles/js-lib';
-import { BackendRequest, BackendRequestHandler, BackendResponse } from '../index';
+import type { NumberOfSeconds } from '@naturalcycles/js-lib';
+import type { BackendRequest, BackendRequestHandler, BackendResponse } from '../index';
 export interface RequestTimeoutMiddlewareCfg {
     /**
      * @default 120

package/dist/server/safeJsonMiddleware.d.ts

@@ -1,4 +1,4 @@
-import { BackendRequestHandler } from './server.model';
+import type { BackendRequestHandler } from './server.model';
 /**
  * Replaces express's built-in req.json() function with the safe one,
  * protected from circular references.

package/dist/server/server.util.d.ts

@@ -1,4 +1,4 @@
-import { Server } from 'node:http';
+import type { Server } from 'node:http';
 export interface DestroyableServer extends Server {
     destroy: () => Promise<void>;
 }

package/dist/server/serverStatsMiddleware.d.ts

@@ -1,4 +1,4 @@
-import { BackendRequestHandler } from '../index';
+import type { BackendRequestHandler } from '../index';
 /**
  * Depends on serverStatsMiddleware to work.
  *

package/dist/server/serverStatusMiddleware.d.ts

@@ -1,3 +1,3 @@
-import { BackendRequestHandler } from './server.model';
+import type { BackendRequestHandler } from './server.model';
 export declare function serverStatusMiddleware(projectDir?: string, extra?: any): BackendRequestHandler;
 export declare function getServerStatusData(projectDir?: string, extra?: any): Record<string, any>;

package/dist/server/simpleRequestLoggerMiddleware.d.ts

@@ -1,4 +1,4 @@
-import { BackendRequestHandler } from '../index';
+import type { BackendRequestHandler } from '../index';
 export interface SimpleRequestLoggerMiddlewareCfg {
     /**
      * @default false

package/dist/server/startServer.d.ts

@@ -1,5 +1,5 @@
-import { Server } from 'node:http';
-import { StartServerCfg, StartServerData } from './startServer.model';
+import type { Server } from 'node:http';
+import type { StartServerCfg, StartServerData } from './startServer.model';
 export declare class BackendServer {
     private cfg;
     constructor(cfg: StartServerCfg);

package/dist/server/startServer.js

@@ -9,9 +9,11 @@ const nodejs_lib_1 = require("@naturalcycles/nodejs-lib");
 const index_1 = require("../index");
 const { NODE_OPTIONS, APP_ENV } = process.env;
 class BackendServer {
+    cfg;
     constructor(cfg) {
         this.cfg = cfg;
     }
+    server;
     async start() {
         const { port: cfgPort, expressApp = (0, index_1.createDefaultApp)(this.cfg), registerUncaughtExceptionHandlers = true, } = this.cfg;
         // 1. Register error handlers, etc.

package/dist/server/startServer.model.d.ts

@@ -1,7 +1,7 @@
-import { Server } from 'node:http';
-import { SentrySharedService } from '../sentry/sentry.shared.service';
-import { DefaultAppCfg } from './createDefaultApp.model';
-import { BackendApplication } from './server.model';
+import type { Server } from 'node:http';
+import type { SentrySharedService } from '../sentry/sentry.shared.service';
+import type { DefaultAppCfg } from './createDefaultApp.model';
+import type { BackendApplication } from './server.model';
 /**
  * If DefaultAppCfg.resources is passed and `expressApp` is not passed - it will call createDefaultApp(cfg).
  */

package/dist/server/validation/validateMiddleware.d.ts

@@ -1,7 +1,8 @@
-import { JsonSchema, JsonSchemaBuilder } from '@naturalcycles/js-lib';
-import { AjvSchema, AjvValidationError } from '@naturalcycles/nodejs-lib';
-import { BackendRequestHandler } from '../server.model';
-import { ReqValidationOptions } from './validateRequest';
+import type { JsonSchema, JsonSchemaBuilder } from '@naturalcycles/js-lib';
+import type { AjvValidationError } from '@naturalcycles/nodejs-lib';
+import { AjvSchema } from '@naturalcycles/nodejs-lib';
+import type { BackendRequestHandler } from '../server.model';
+import type { ReqValidationOptions } from './validateRequest';
 export declare function validateBody(schema: JsonSchema | JsonSchemaBuilder | AjvSchema, opt?: ReqValidationOptions<AjvValidationError>): BackendRequestHandler;
 export declare function validateParams(schema: JsonSchema | JsonSchemaBuilder | AjvSchema, opt?: ReqValidationOptions<AjvValidationError>): BackendRequestHandler;
 export declare function validateQuery(schema: JsonSchema | JsonSchemaBuilder | AjvSchema, opt?: ReqValidationOptions<AjvValidationError>): BackendRequestHandler;

package/dist/server/validation/validateMiddleware.js

@@ -31,7 +31,7 @@ function validateObject(prop, schema, opt = {}) {
     });
     const reportPredicate = typeof opt.report === 'function' ? opt.report : () => opt.report;
     return (req, _res, next) => {
-        const error = ajvSchema.getValidationError(req[prop]);
+        const error = ajvSchema.getValidationError(req[prop] || {});
         if (error) {
             const report = reportPredicate(error);
             if (opt.redactPaths) {

package/dist/server/validation/validateRequest.d.ts

@@ -1,5 +1,5 @@
-import { AnySchema, JoiValidationError } from '@naturalcycles/nodejs-lib';
-import { BackendRequest } from '../server.model';
+import type { AnySchema, JoiValidationError } from '@naturalcycles/nodejs-lib';
+import type { BackendRequest } from '../server.model';
 export interface ReqValidationOptions<ERR extends Error> {
     /**
      * Pass a 'dot-paths' (e.g `pw`, or `input.pw`) that needs to be redacted from the output, in case of error.

package/dist/server/validation/validateRequest.js

@@ -42,7 +42,7 @@ class ValidateRequest {
         return this.validate(req, 'headers', schema, options);
     }
     validate(req, reqProperty, schema, opt = {}) {
-        const { value, error } = (0, nodejs_lib_1.getValidationResult)(req[reqProperty], schema, `request ${reqProperty}`);
+        const { value, error } = (0, nodejs_lib_1.getValidationResult)(req[reqProperty] || {}, schema, `request ${reqProperty}`);
         if (error) {
             let report;
             if (typeof opt.report === 'boolean') {

package/dist/server/validation/zodValidateMiddleware.d.ts

@@ -1,6 +1,6 @@
-import { ZodSchema, ZodValidationError } from '@naturalcycles/js-lib';
-import { BackendRequestHandler } from '../server.model';
-import { ReqValidationOptions } from './validateRequest';
+import type { ZodSchema, ZodValidationError } from '@naturalcycles/js-lib/dist/zod/index.js';
+import type { BackendRequestHandler } from '../server.model';
+import type { ReqValidationOptions } from './validateRequest';
 /**
  * Validates req property (body, params or query).
  * Supports Joi schema or AjvSchema (from nodejs-lib).

package/dist/server/validation/zodValidateMiddleware.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.zodReqValidate = zodReqValidate;
 const js_lib_1 = require("@naturalcycles/js-lib");
+const index_js_1 = require("@naturalcycles/js-lib/dist/zod/index.js");
 const REDACTED = 'REDACTED';
 /**
  * Validates req property (body, params or query).
@@ -12,7 +13,7 @@ const REDACTED = 'REDACTED';
 function zodReqValidate(prop, schema, opt = {}) {
     const reportPredicate = typeof opt.report === 'function' ? opt.report : () => opt.report;
     return (req, _res, next) => {
-        const { error } = (0, js_lib_1.zSafeValidate)(req[prop], schema);
+        const { error } = (0, index_js_1.zSafeValidate)(req[prop] || {}, schema);
         if (!error) {
             return next();
         }

package/dist/testing/express.test.service.d.ts

@@ -1,6 +1,6 @@
-import { Fetcher, FetcherOptions } from '@naturalcycles/js-lib';
-import { BackendApplication, DefaultAppCfg } from '../index';
-import { BackendRequestHandlerCfg } from '../server/createDefaultApp.model';
+import type { Fetcher, FetcherOptions } from '@naturalcycles/js-lib';
+import type { BackendApplication, DefaultAppCfg } from '../index';
+import type { BackendRequestHandlerCfg } from '../server/createDefaultApp.model';
 export interface ExpressApp extends Fetcher {
     close: () => Promise<void>;
 }

package/dist/testing/index.d.ts

@@ -1,3 +1,4 @@
-import { ExpressApp, expressTestService } from './express.test.service';
+import type { ExpressApp } from './express.test.service';
+import { expressTestService } from './express.test.service';
 export type { ExpressApp };
 export { expressTestService };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturalcycles/backend-lib",
-  "version": "8.0.2",
+  "version": "8.0.4",
   "scripts": {
     "prepare": "husky",
     "build": "dev-lib build",

package/src/admin/adminMiddleware.ts

@@ -1,9 +1,9 @@
 import { _memoFn, AppError } from '@naturalcycles/js-lib'
 import { fs2 } from '@naturalcycles/nodejs-lib'
 import ejs from 'ejs'
-import { BackendRequestHandler } from '../server/server.model'
-import { BaseAdminService } from './base.admin.service'
-import { FirebaseSharedServiceCfg } from './firebase.shared.service'
+import type { BackendRequestHandler } from '../server/server.model'
+import type { BaseAdminService } from './base.admin.service'
+import type { FirebaseSharedServiceCfg } from './firebase.shared.service'
 
 export interface RequireAdminCfg {
   /**

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

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

package/src/admin/secureHeaderMiddleware.ts

@@ -1,8 +1,9 @@
 import { AppError } from '@naturalcycles/js-lib'
 import { timingSafeStringEqual } from '@naturalcycles/nodejs-lib'
-import { BackendRequestHandler } from '../server/server.model'
-import { AdminMiddleware, RequireAdminCfg, requireAdminPermissions } from './adminMiddleware'
-import { BaseAdminService } from './base.admin.service'
+import type { BackendRequestHandler } from '../server/server.model'
+import type { AdminMiddleware, RequireAdminCfg } from './adminMiddleware'
+import { requireAdminPermissions } from './adminMiddleware'
+import type { BaseAdminService } from './base.admin.service'
 
 export interface SecureHeaderMiddlewareCfg extends RequireAdminCfg {
   adminService: BaseAdminService

package/src/db/httpDB.ts

@@ -1,8 +1,6 @@
 import { Readable } from 'node:stream'
-import {
-  BaseCommonDB,
+import type {
   CommonDB,
-  commonDBFullSupport,
   CommonDBOptions,
   CommonDBSaveOptions,
   CommonDBStreamOptions,
@@ -10,14 +8,15 @@ import {
   DBQuery,
   RunQueryResult,
 } from '@naturalcycles/db-lib'
-import {
+import { BaseCommonDB, commonDBFullSupport } from '@naturalcycles/db-lib'
+import type {
   Fetcher,
   FetcherOptions,
-  getFetcher,
   JsonSchemaRootObject,
   ObjectWithId,
 } from '@naturalcycles/js-lib'
-import { ReadableTyped } from '@naturalcycles/nodejs-lib'
+import { getFetcher } from '@naturalcycles/js-lib'
+import type { ReadableTyped } from '@naturalcycles/nodejs-lib'
 
 export interface HttpDBCfg extends FetcherOptions {
   baseUrl: string

package/src/db/httpDBRequestHandler.ts

@@ -1,18 +1,14 @@
-import {
-  CommonDB,
-  CommonDBOptions,
-  CommonDBSaveOptions,
-  DBQuery,
-  InMemoryDB,
-} from '@naturalcycles/db-lib'
+import type { CommonDB, CommonDBOptions, CommonDBSaveOptions } from '@naturalcycles/db-lib'
+import { DBQuery, InMemoryDB } from '@naturalcycles/db-lib'
 import {
   commonDBOptionsSchema,
   commonDBSaveOptionsSchema,
   dbQuerySchema,
 } from '@naturalcycles/db-lib/dist/validation'
-import { ObjectWithId } from '@naturalcycles/js-lib'
+import type { ObjectWithId } from '@naturalcycles/js-lib'
 import { anyObjectSchema, arraySchema, objectSchema, stringSchema } from '@naturalcycles/nodejs-lib'
-import { BackendRouter, getDefaultRouter, validateRequest } from '..'
+import type { BackendRouter } from '..'
+import { getDefaultRouter, validateRequest } from '..'
 
 export interface GetByIdsInput {
   table: string

package/src/db/index.ts

@@ -1,4 +1,5 @@
-import { HttpDB, HttpDBCfg } from './httpDB'
+import type { HttpDBCfg } from './httpDB'
+import { HttpDB } from './httpDB'
 import { httpDBRequestHandler } from './httpDBRequestHandler'
 
 export type { HttpDBCfg }

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

@@ -1,4 +1,4 @@
-import { StringMap } from '@naturalcycles/js-lib'
+import type { StringMap } from '@naturalcycles/js-lib'
 import { AjvSchema, fs2, requireFileToExist } from '@naturalcycles/nodejs-lib'
 import { resourcesDir } from '../paths.cnst'
 

package/src/deploy/deploy.util.ts

@@ -1,7 +1,7 @@
 import { _assert, _mapValues, _merge, _truncate, localTime } from '@naturalcycles/js-lib'
 import { dimGrey, fs2, sha256, white } from '@naturalcycles/nodejs-lib'
-import { BackendCfg } from './backend.cfg.util'
-import { AppYaml, DeployInfo } from './deploy.model'
+import type { BackendCfg } from './backend.cfg.util'
+import type { AppYaml, DeployInfo } from './deploy.model'
 
 const APP_YAML_DEFAULT = (): AppYaml => ({
   runtime: 'nodejs22',

package/src/deploy/deployGae.ts

@@ -2,8 +2,10 @@ import { _anyToError, _objectAssign, pRetry } from '@naturalcycles/js-lib'
 import { appendToGithubSummary, exec2 } from '@naturalcycles/nodejs-lib'
 import { getBackendCfg } from './backend.cfg.util'
 import { createDeployInfo } from './deploy.util'
-import { deployHealthCheck, DeployHealthCheckOptions } from './deployHealthCheck'
-import { deployPrepare, DeployPrepareOptions } from './deployPrepare'
+import type { DeployHealthCheckOptions } from './deployHealthCheck'
+import { deployHealthCheck } from './deployHealthCheck'
+import type { DeployPrepareOptions } from './deployPrepare'
+import { deployPrepare } from './deployPrepare'
 
 export interface DeployGaeOptions extends DeployPrepareOptions, DeployHealthCheckOptions {}
 

package/src/deploy/deployHealthCheck.ts

@@ -1,12 +1,7 @@
-import { inspect, InspectOptions } from 'node:util'
-import {
-  _filterFalsyValues,
-  _ms,
-  _since,
-  getFetcher,
-  pDelay,
-  UnixTimestampMillis,
-} from '@naturalcycles/js-lib'
+import type { InspectOptions } from 'node:util'
+import { inspect } from 'node:util'
+import type { UnixTimestampMillis } from '@naturalcycles/js-lib'
+import { _filterFalsyValues, _ms, _since, getFetcher, pDelay } from '@naturalcycles/js-lib'
 import { dimGrey, exec2, red } from '@naturalcycles/nodejs-lib'
 import { coloredHttpCode } from '../server/request.log.util'
 

package/src/deploy/deployPrepare.ts

@@ -1,7 +1,7 @@
 import { dimGrey, fs2, kpySync } from '@naturalcycles/nodejs-lib'
 import { srcDir } from '../paths.cnst'
 import { getBackendCfg } from './backend.cfg.util'
-import { DeployInfo } from './deploy.model'
+import type { DeployInfo } from './deploy.model'
 import { createAndSaveAppYaml, createAndSaveDeployInfo } from './deploy.util'
 
 export interface DeployPrepareOptions {

package/src/deploy/index.ts

@@ -1,8 +1,10 @@
-import { BackendCfg, getBackendCfg } from './backend.cfg.util'
-import { DeployInfo } from './deploy.model'
+import type { BackendCfg } from './backend.cfg.util'
+import { getBackendCfg } from './backend.cfg.util'
+import type { DeployInfo } from './deploy.model'
 import { createAppYaml, createDeployInfo } from './deploy.util'
 import { deployGae } from './deployGae'
-import { deployHealthCheck, DeployHealthCheckOptions } from './deployHealthCheck'
+import type { DeployHealthCheckOptions } from './deployHealthCheck'
+import { deployHealthCheck } from './deployHealthCheck'
 import { deployPrepare } from './deployPrepare'
 
 export type { BackendCfg, DeployHealthCheckOptions, DeployInfo }

package/src/env/env.shared.service.ts

@@ -1,4 +1,5 @@
-import { _assert, _by, StringMap } from '@naturalcycles/js-lib'
+import type { StringMap } from '@naturalcycles/js-lib'
+import { _assert, _by } from '@naturalcycles/js-lib'
 import { dimGrey } from '@naturalcycles/nodejs-lib'
 
 export interface BaseEnv {

package/src/sentry/sentry.shared.service.ts

@@ -1,12 +1,7 @@
-import {
-  _anyToError,
-  _isErrorObject,
-  CommonLogger,
-  CommonLogLevel,
-  Primitive,
-  StringMap,
-} from '@naturalcycles/js-lib'
-import { _inspect, InspectAnyOptions } from '@naturalcycles/nodejs-lib'
+import type { CommonLogger, CommonLogLevel, Primitive, StringMap } from '@naturalcycles/js-lib'
+import { _anyToError, _isErrorObject } from '@naturalcycles/js-lib'
+import type { InspectAnyOptions } from '@naturalcycles/nodejs-lib'
+import { _inspect } from '@naturalcycles/nodejs-lib'
 import type { Breadcrumb, SeverityLevel } from '@sentry/node'
 import type * as SentryLib from '@sentry/node'
 import { getRequestLogger } from '../index'

package/src/server/asyncLocalStorageMiddleware.ts

@@ -1,7 +1,8 @@
 import { AsyncLocalStorage } from 'node:async_hooks'
-import { _lazyValue, CommonLogger } from '@naturalcycles/js-lib'
+import type { CommonLogger } from '@naturalcycles/js-lib'
+import { _lazyValue } from '@naturalcycles/js-lib'
 import { ciLogger, devLogger, gaeLogger } from './logMiddleware'
-import { BackendRequest, BackendRequestHandler } from './server.model'
+import type { BackendRequest, BackendRequestHandler } from './server.model'
 
 const { GAE_INSTANCE, CI } = process.env
 const isGAE = !!GAE_INSTANCE

package/src/server/basicAuthMiddleware.ts

@@ -1,6 +1,7 @@
-import { _split, StringMap } from '@naturalcycles/js-lib'
+import type { StringMap } from '@naturalcycles/js-lib'
+import { _split } from '@naturalcycles/js-lib'
 import { base64ToString, timingSafeStringEqual } from '@naturalcycles/nodejs-lib'
-import { BackendRequestHandler } from './server.model'
+import type { BackendRequestHandler } from './server.model'
 
 export interface BasicAuthMiddlewareCfg {
   /**

package/src/server/bodyParserTimeoutMiddleware.ts

@@ -1,5 +1,6 @@
 import { AppError } from '@naturalcycles/js-lib'
-import { BackendRequestHandler, respondWithError } from '../index'
+import type { BackendRequestHandler } from '../index'
+import { respondWithError } from '../index'
 
 export interface BodyParserTimeoutMiddlewareCfg {
   /**

package/src/server/createDefaultApp.model.ts

@@ -1,8 +1,8 @@
-import { Options, OptionsJson, OptionsUrlencoded } from 'body-parser'
-import { CorsOptions } from 'cors'
-import { SentrySharedService } from '../sentry/sentry.shared.service'
-import { GenericErrorMiddlewareCfg } from './genericErrorMiddleware'
-import { BackendRequestHandler } from './server.model'
+import type { Options, OptionsJson, OptionsUrlencoded } from 'body-parser'
+import type { CorsOptions } from 'cors'
+import type { SentrySharedService } from '../sentry/sentry.shared.service'
+import type { GenericErrorMiddlewareCfg } from './genericErrorMiddleware'
+import type { BackendRequestHandler } from './server.model'
 
 /**
  * Plain RequestHandler can be provided - then it's mounted to /

package/src/server/createDefaultApp.ts

@@ -1,9 +1,10 @@
 import cookieParser = require('cookie-parser')
 import cors = require('cors')
 import express = require('express')
-import { BackendApplication, isGAE, methodOverrideMiddleware } from '..'
+import type { BackendApplication } from '..'
+import { isGAE, methodOverrideMiddleware } from '..'
 import { asyncLocalStorageMiddleware } from './asyncLocalStorageMiddleware'
-import {
+import type {
   BackendRequestHandlerCfg,
   BackendRequestHandlerWithPath,
   DefaultAppCfg,

package/src/server/genericErrorMiddleware.ts

@@ -1,13 +1,7 @@
-import {
-  _anyToError,
-  _errorLikeToErrorObject,
-  _filterUndefinedValues,
-  AppError,
-  BackendErrorResponseObject,
-  ErrorObject,
-} from '@naturalcycles/js-lib'
-import { SentrySharedService } from '../sentry/sentry.shared.service'
-import { BackendErrorRequestHandler, BackendRequest, BackendResponse } from './server.model'
+import type { AppError, BackendErrorResponseObject, ErrorObject } from '@naturalcycles/js-lib'
+import { _anyToError, _errorLikeToErrorObject, _filterUndefinedValues } from '@naturalcycles/js-lib'
+import type { SentrySharedService } from '../sentry/sentry.shared.service'
+import type { BackendErrorRequestHandler, BackendRequest, BackendResponse } from './server.model'
 
 export interface GenericErrorMiddlewareCfg {
   sentryService?: SentrySharedService

package/src/server/getDefaultRouter.ts

@@ -1,5 +1,5 @@
 import { Router } from 'express'
-import { BackendRequestHandler, BackendRouter } from './server.model'
+import type { BackendRequestHandler, BackendRouter } from './server.model'
 
 /**
  * Convenience method.

package/src/server/logMiddleware.ts

@@ -1,7 +1,7 @@
 import { inspect } from 'node:util'
-import { AnyObject, CommonLogger } from '@naturalcycles/js-lib'
+import type { AnyObject, CommonLogger } from '@naturalcycles/js-lib'
 import { _inspect, dimGrey } from '@naturalcycles/nodejs-lib'
-import { BackendRequestHandler } from './server.model'
+import type { BackendRequestHandler } from './server.model'
 
 const { GOOGLE_CLOUD_PROJECT, GAE_INSTANCE, APP_ENV } = process.env
 const isGAE = !!GAE_INSTANCE

package/src/server/methodOverrideMiddleware.ts

@@ -1,4 +1,4 @@
-import { BackendRequestHandler } from './server.model'
+import type { BackendRequestHandler } from './server.model'
 
 export interface MethodOverrideMiddlewareCfg {
   /**

package/src/server/notFoundMiddleware.ts

@@ -1,5 +1,5 @@
 import { getRequestEndpoint } from './request.util'
-import { BackendRequestHandler } from './server.model'
+import type { BackendRequestHandler } from './server.model'
 
 export function notFoundMiddleware(): BackendRequestHandler {
   return (req, res) => {

package/src/server/okMiddleware.ts

@@ -1,4 +1,4 @@
-import { BackendRequestHandler } from './server.model'
+import type { BackendRequestHandler } from './server.model'
 
 export function okMiddleware(): BackendRequestHandler {
   return (_req, res) => {

package/src/server/request.log.util.ts

@@ -1,6 +1,6 @@
-import { CommonLogLevel } from '@naturalcycles/js-lib'
+import type { CommonLogLevel } from '@naturalcycles/js-lib'
 import { boldGrey, green, red, yellow } from '@naturalcycles/nodejs-lib'
-import { BackendRequest } from './server.model'
+import type { BackendRequest } from './server.model'
 
 export function logRequest(req: BackendRequest, statusCode: number, ...tokens: any[]): void {
   req[logLevel(statusCode)](

package/src/server/request.util.ts

@@ -1,4 +1,4 @@
-import { BackendRequest } from './server.model'
+import type { BackendRequest } from './server.model'
 
 /**
  * Returns e.g:

package/src/server/requestTimeoutMiddleware.ts

@@ -1,12 +1,7 @@
-import { _ms, AppError, NumberOfSeconds } from '@naturalcycles/js-lib'
-import {
-  BackendRequest,
-  BackendRequestHandler,
-  BackendResponse,
-  getRequestEndpoint,
-  onFinished,
-  respondWithError,
-} from '../index'
+import type { NumberOfSeconds } from '@naturalcycles/js-lib'
+import { _ms, AppError } from '@naturalcycles/js-lib'
+import type { BackendRequest, BackendRequestHandler, BackendResponse } from '../index'
+import { getRequestEndpoint, onFinished, respondWithError } from '../index'
 
 export interface RequestTimeoutMiddlewareCfg {
   /**

package/src/server/safeJsonMiddleware.ts

@@ -1,5 +1,5 @@
 import { _safeJsonStringify } from '@naturalcycles/js-lib'
-import { BackendRequestHandler, BackendResponse } from './server.model'
+import type { BackendRequestHandler, BackendResponse } from './server.model'
 
 /**
  * Replaces express's built-in req.json() function with the safe one,

package/src/server/server.util.ts

@@ -1,6 +1,6 @@
-import { Server } from 'node:http'
-import { Socket } from 'node:net'
-import { StringMap } from '@naturalcycles/js-lib'
+import type { Server } from 'node:http'
+import type { Socket } from 'node:net'
+import type { StringMap } from '@naturalcycles/js-lib'
 
 export interface DestroyableServer extends Server {
   destroy: () => Promise<void>

package/src/server/serverStatsMiddleware.ts

@@ -1,3 +1,4 @@
+import type { StringMap } from '@naturalcycles/js-lib'
 import {
   _get,
   _mapValues,
@@ -9,9 +10,9 @@ import {
   _stringMapValues,
   _sum,
   NumberStack,
-  StringMap,
 } from '@naturalcycles/js-lib'
-import { BackendRequestHandler, onFinished } from '../index'
+import type { BackendRequestHandler } from '../index'
+import { onFinished } from '../index'
 import { getRequestEndpoint } from './request.util'
 
 const { GAE_INSTANCE } = process.env

package/src/server/serverStatusMiddleware.ts

@@ -1,7 +1,7 @@
 import { _filterNullishValues, localTime } from '@naturalcycles/js-lib'
 import { memoryUsageFull, processSharedUtil } from '@naturalcycles/nodejs-lib'
 import { getDeployInfo } from './deployInfo.util'
-import { BackendRequestHandler } from './server.model'
+import type { BackendRequestHandler } from './server.model'
 
 const { versions, arch, platform } = process
 const { GAE_APPLICATION, GAE_SERVICE, GAE_VERSION, K_SERVICE, K_REVISION, APP_ENV, NODE_OPTIONS } =

package/src/server/simpleRequestLoggerMiddleware.ts

@@ -1,6 +1,8 @@
-import { _since, UnixTimestampMillis } from '@naturalcycles/js-lib'
+import type { UnixTimestampMillis } from '@naturalcycles/js-lib'
+import { _since } from '@naturalcycles/js-lib'
 import { boldGrey, dimGrey } from '@naturalcycles/nodejs-lib'
-import { BackendRequestHandler, onFinished } from '../index'
+import type { BackendRequestHandler } from '../index'
+import { onFinished } from '../index'
 import { logRequest } from './request.log.util'
 
 const { APP_ENV } = process.env

package/src/server/startServer.model.ts

@@ -1,7 +1,7 @@
-import { Server } from 'node:http'
-import { SentrySharedService } from '../sentry/sentry.shared.service'
-import { DefaultAppCfg } from './createDefaultApp.model'
-import { BackendApplication } from './server.model'
+import type { Server } from 'node:http'
+import type { SentrySharedService } from '../sentry/sentry.shared.service'
+import type { DefaultAppCfg } from './createDefaultApp.model'
+import type { BackendApplication } from './server.model'
 
 /**
  * If DefaultAppCfg.resources is passed and `expressApp` is not passed - it will call createDefaultApp(cfg).

package/src/server/startServer.ts

@@ -1,9 +1,9 @@
-import { Server } from 'node:http'
+import type { Server } from 'node:http'
 import os from 'node:os'
 import { _Memo, _ms } from '@naturalcycles/js-lib'
 import { boldGrey, dimGrey, white } from '@naturalcycles/nodejs-lib'
 import { createDefaultApp } from '../index'
-import { StartServerCfg, StartServerData } from './startServer.model'
+import type { StartServerCfg, StartServerData } from './startServer.model'
 
 const { NODE_OPTIONS, APP_ENV } = process.env
 

package/src/server/validation/validateMiddleware.ts

@@ -1,7 +1,9 @@
-import { _get, AppError, JsonSchema, JsonSchemaBuilder } from '@naturalcycles/js-lib'
-import { AjvSchema, AjvValidationError } from '@naturalcycles/nodejs-lib'
-import { BackendRequestHandler } from '../server.model'
-import { ReqValidationOptions } from './validateRequest'
+import type { JsonSchema, JsonSchemaBuilder } from '@naturalcycles/js-lib'
+import { _get, AppError } from '@naturalcycles/js-lib'
+import type { AjvValidationError } from '@naturalcycles/nodejs-lib'
+import { AjvSchema } from '@naturalcycles/nodejs-lib'
+import type { BackendRequestHandler } from '../server.model'
+import type { ReqValidationOptions } from './validateRequest'
 
 const REDACTED = 'REDACTED'
 
@@ -52,7 +54,7 @@ function validateObject(
     typeof opt.report === 'function' ? opt.report : () => opt.report as boolean | undefined
 
   return (req, _res, next) => {
-    const error = ajvSchema.getValidationError(req[prop])
+    const error = ajvSchema.getValidationError(req[prop] || {})
     if (error) {
       const report = reportPredicate(error)
 

package/src/server/validation/validateRequest.ts

@@ -1,6 +1,7 @@
 import { _get, AppError } from '@naturalcycles/js-lib'
-import { AnySchema, getValidationResult, JoiValidationError } from '@naturalcycles/nodejs-lib'
-import { BackendRequest } from '../server.model'
+import type { AnySchema, JoiValidationError } from '@naturalcycles/nodejs-lib'
+import { getValidationResult } from '@naturalcycles/nodejs-lib'
+import type { BackendRequest } from '../server.model'
 
 const REDACTED = 'REDACTED'
 
@@ -89,7 +90,11 @@ class ValidateRequest {
     schema: AnySchema<T>,
     opt: ReqValidationOptions<JoiValidationError> = {},
   ): T {
-    const { value, error } = getValidationResult(req[reqProperty], schema, `request ${reqProperty}`)
+    const { value, error } = getValidationResult(
+      req[reqProperty] || {},
+      schema,
+      `request ${reqProperty}`,
+    )
     if (error) {
       let report: boolean | undefined
       if (typeof opt.report === 'boolean') {

package/src/server/validation/zodValidateMiddleware.ts

@@ -1,6 +1,8 @@
-import { _get, AppError, ZodSchema, ZodValidationError, zSafeValidate } from '@naturalcycles/js-lib'
-import { BackendRequestHandler } from '../server.model'
-import { ReqValidationOptions } from './validateRequest'
+import { _get, AppError } from '@naturalcycles/js-lib'
+import type { ZodSchema, ZodValidationError } from '@naturalcycles/js-lib/dist/zod/index.js'
+import { zSafeValidate } from '@naturalcycles/js-lib/dist/zod/index.js'
+import type { BackendRequestHandler } from '../server.model'
+import type { ReqValidationOptions } from './validateRequest'
 
 const REDACTED = 'REDACTED'
 
@@ -19,7 +21,7 @@ export function zodReqValidate(
     typeof opt.report === 'function' ? opt.report : () => opt.report as boolean | undefined
 
   return (req, _res, next) => {
-    const { error } = zSafeValidate(req[prop], schema)
+    const { error } = zSafeValidate(req[prop] || {}, schema)
     if (!error) {
       return next()
     }

package/src/testing/express.test.service.ts

@@ -1,8 +1,10 @@
-import { Server } from 'node:http'
-import { AddressInfo } from 'node:net'
-import { Fetcher, FetcherOptions, FetchFunction, getFetcher, pDelay } from '@naturalcycles/js-lib'
-import { BackendApplication, createDefaultApp, DefaultAppCfg } from '../index'
-import { BackendRequestHandlerCfg } from '../server/createDefaultApp.model'
+import type { Server } from 'node:http'
+import type { AddressInfo } from 'node:net'
+import type { Fetcher, FetcherOptions, FetchFunction } from '@naturalcycles/js-lib'
+import { getFetcher, pDelay } from '@naturalcycles/js-lib'
+import type { BackendApplication, DefaultAppCfg } from '../index'
+import { createDefaultApp } from '../index'
+import type { BackendRequestHandlerCfg } from '../server/createDefaultApp.model'
 
 const nativeFetchFn: FetchFunction = async (url, init) => await globalThis.fetch(url, init)
 

package/src/testing/index.ts

@@ -1,4 +1,5 @@
-import { ExpressApp, expressTestService } from './express.test.service'
+import type { ExpressApp } from './express.test.service'
+import { expressTestService } from './express.test.service'
 
 export type { ExpressApp }