@naturalcycles/backend-lib 9.61.0 → 9.63.0

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

@@ -1,5 +1,6 @@
 import type { App, AppOptions, ServiceAccount } from 'firebase-admin/app';
 import type { Auth } from 'firebase-admin/auth';
+import type { Messaging } from 'firebase-admin/messaging';
 export interface FirebaseSharedServiceCfg {
     /**
      * If undefined - will try to use credential.applicationDefault()
@@ -34,4 +35,5 @@ export declare class FirebaseSharedService {
     init(): Promise<void>;
     admin(): Promise<App>;
     auth(): Promise<Auth>;
+    messaging(): Promise<Messaging>;
 }

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

@@ -23,6 +23,11 @@ export class FirebaseSharedService {
         const { getAuth } = await import('firebase-admin/auth');
         return getAuth(app);
     }
+    async messaging() {
+        const app = await this.admin();
+        const { getMessaging } = await import('firebase-admin/messaging');
+        return getMessaging(app);
+    }
 }
 __decorate([
     _Memo()

package/dist/bin/deploy-gae.js

@@ -1,12 +1,12 @@
+import { _parseArgs } from '@naturalcycles/nodejs-lib/args';
 import { runScript } from '@naturalcycles/nodejs-lib/runScript';
-import { _yargs } from '@naturalcycles/nodejs-lib/yargs';
 import { deployGae } from '../deploy/deployGae.js';
-import { deployHealthCheckYargsOptions } from '../deploy/deployHealthCheck.js';
-import { deployPrepareYargsOptions } from '../deploy/deployPrepare.js';
+import { deployHealthCheckCliOptions } from '../deploy/deployHealthCheck.js';
+import { deployPrepareCliOptions } from '../deploy/deployPrepare.js';
 runScript(async () => {
-    const opt = _yargs().options({
-        ...deployPrepareYargsOptions,
-        ...deployHealthCheckYargsOptions,
-    }).argv;
+    const opt = _parseArgs({
+        ...deployPrepareCliOptions,
+        ...deployHealthCheckCliOptions,
+    });
     await deployGae(opt);
 });

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

@@ -6,16 +6,16 @@ yarn deploy-health-check --url https://service-dot-yourproject.appspot.com
 --intervalSec 2
 
  */
+import { _parseArgs } from '@naturalcycles/nodejs-lib/args';
 import { runScript } from '@naturalcycles/nodejs-lib/runScript';
-import { _yargs } from '@naturalcycles/nodejs-lib/yargs';
-import { deployHealthCheck, deployHealthCheckYargsOptions } from '../deploy/deployHealthCheck.js';
+import { deployHealthCheck, deployHealthCheckCliOptions } from '../deploy/deployHealthCheck.js';
 runScript(async () => {
-    const { url, ...opt } = _yargs().options({
-        ...deployHealthCheckYargsOptions,
+    const { url, ...opt } = _parseArgs({
+        ...deployHealthCheckCliOptions,
         url: {
             type: 'string',
             demandOption: true,
         },
-    }).argv;
+    });
     await deployHealthCheck(url, opt);
 });

package/dist/bin/deploy-prepare.js

@@ -3,11 +3,11 @@
 yarn deploy-prepare
 
  */
+import { _parseArgs } from '@naturalcycles/nodejs-lib/args';
 import { runScript } from '@naturalcycles/nodejs-lib/runScript';
-import { _yargs } from '@naturalcycles/nodejs-lib/yargs';
-import { deployPrepare, deployPrepareYargsOptions } from '../deploy/deployPrepare.js';
+import { deployPrepare, deployPrepareCliOptions } from '../deploy/deployPrepare.js';
 runScript(async () => {
-    const opt = _yargs().options(deployPrepareYargsOptions).argv;
+    const opt = _parseArgs(deployPrepareCliOptions);
     await deployPrepare(opt);
 });
 // deploy strategy

package/dist/bin/undeploy-gae.js

@@ -1,13 +1,13 @@
+import { _parseArgs } from '@naturalcycles/nodejs-lib/args';
 import { runScript } from '@naturalcycles/nodejs-lib/runScript';
-import { _yargs } from '@naturalcycles/nodejs-lib/yargs';
 import { undeployGae } from '../deploy/deployGae.js';
 runScript(async () => {
-    const { branch } = _yargs().options({
+    const { branch } = _parseArgs({
         branch: {
             type: 'string',
             demandOption: true,
             desc: `Because Github Actions delete event happens after the branch is already deleted - you need to pass it manually`,
         },
-    }).argv;
+    });
     await undeployGae(branch);
 });

package/dist/deploy/deployHealthCheck.d.ts

@@ -11,50 +11,7 @@ export interface DeployHealthCheckOptions {
     gaeVersion?: string;
     authHeader?: string;
 }
-export declare const deployHealthCheckYargsOptions: {
-    readonly thresholdHealthy: {
-        readonly type: 'number';
-        readonly default: 5;
-    };
-    readonly thresholdUnhealthy: {
-        readonly type: 'number';
-        readonly default: 8;
-    };
-    readonly maxTries: {
-        readonly type: 'number';
-        readonly default: 30;
-    };
-    readonly timeoutSec: {
-        readonly type: 'number';
-        readonly default: 180;
-    };
-    readonly intervalSec: {
-        readonly type: 'number';
-        readonly default: 1;
-    };
-    readonly logOnFailure: {
-        readonly type: 'boolean';
-        readonly default: true;
-        readonly desc: 'Show server logs on health check failure (requires gaeProject, gaeService, gaeVersion)';
-    };
-    readonly logOnSuccess: {
-        readonly type: 'boolean';
-        readonly default: false;
-        readonly desc: 'Show server logs on health check success (requires gaeProject, gaeService, gaeVersion)';
-    };
-    readonly gaeProject: {
-        readonly type: 'string';
-    };
-    readonly gaeService: {
-        readonly type: 'string';
-    };
-    readonly gaeVersion: {
-        readonly type: 'string';
-    };
-    readonly authHeader: {
-        readonly type: 'string';
-    };
-};
+export declare const deployHealthCheckCliOptions: CliOptions;
 /**
  * Requires up to `healthyThreshold` consecutive OK responses to succeed.
  * Fails on up to `unhealthyThreshold` consecutive FAIL responses.

package/dist/deploy/deployHealthCheck.js

@@ -6,7 +6,7 @@ import { pDelay } from '@naturalcycles/js-lib/promise/pDelay.js';
 import { dimGrey, red } from '@naturalcycles/nodejs-lib/colors';
 import { exec2 } from '@naturalcycles/nodejs-lib/exec2';
 import { coloredHttpCode } from '../server/request.log.util.js';
-export const deployHealthCheckYargsOptions = {
+export const deployHealthCheckCliOptions = {
     thresholdHealthy: {
         type: 'number',
         default: 5,

package/dist/deploy/deployPrepare.d.ts

@@ -9,23 +9,5 @@ export interface DeployPrepareOptions {
      */
     appYamlPassEnv?: string;
 }
-export declare const deployPrepareYargsOptions: {
-    readonly projectDir: {
-        readonly type: 'string';
-        readonly default: '.';
-    };
-    readonly targetDir: {
-        readonly type: 'string';
-        readonly default: `./tmp/deploy`;
-    };
-    readonly createNpmrc: {
-        readonly type: 'boolean';
-        readonly desc: 'Create .npmrc in targetDir if NPM_TOKEN env var is set';
-        readonly default: true;
-    };
-    readonly appYamlPassEnv: {
-        readonly type: 'string';
-        readonly desc: 'Comma-separated list of env variables that will be passed to app.yaml from process.env';
-    };
-};
+export declare const deployPrepareCliOptions: CliOptions;
 export declare function deployPrepare(opt?: DeployPrepareOptions): Promise<DeployInfo>;

package/dist/deploy/deployPrepare.js

@@ -5,7 +5,7 @@ import { kpySync } from '@naturalcycles/nodejs-lib/kpy';
 import { srcDir } from '../paths.cnst.js';
 import { getBackendCfg } from './backend.cfg.util.js';
 import { createAndSaveAppYaml, createAndSaveDeployInfo } from './deploy.util.js';
-export const deployPrepareYargsOptions = {
+export const deployPrepareCliOptions = {
     projectDir: {
         type: 'string',
         default: '.',

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@naturalcycles/backend-lib",
   "type": "module",
-  "version": "9.61.0",
+  "version": "9.63.0",
   "dependencies": {
     "@naturalcycles/db-lib": "^10",
     "@naturalcycles/js-lib": "^15",
@@ -43,9 +43,9 @@
   },
   "devDependencies": {
     "@sentry/node-core": "^10",
-    "@typescript/native-preview": "beta",
     "fastify": "^5",
-    "@naturalcycles/dev-lib": "18.4.2"
+    "typescript": "rc",
+    "@naturalcycles/dev-lib": "20.50.0"
   },
   "exports": {
     ".": "./dist/index.js",

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

@@ -1,6 +1,7 @@
 import { _Memo } from '@naturalcycles/js-lib/decorators/memo.decorator.js'
 import type { App, AppOptions, ServiceAccount } from 'firebase-admin/app'
 import type { Auth } from 'firebase-admin/auth'
+import type { Messaging } from 'firebase-admin/messaging'
 
 export interface FirebaseSharedServiceCfg {
   /**
@@ -66,4 +67,10 @@ export class FirebaseSharedService {
     const { getAuth } = await import('firebase-admin/auth')
     return getAuth(app)
   }
+
+  async messaging(): Promise<Messaging> {
+    const app = await this.admin()
+    const { getMessaging } = await import('firebase-admin/messaging')
+    return getMessaging(app)
+  }
 }

package/src/bin/deploy-gae.ts

@@ -1,14 +1,14 @@
+import { _parseArgs } from '@naturalcycles/nodejs-lib/args'
 import { runScript } from '@naturalcycles/nodejs-lib/runScript'
-import { _yargs } from '@naturalcycles/nodejs-lib/yargs'
 import { deployGae } from '../deploy/deployGae.js'
-import { deployHealthCheckYargsOptions } from '../deploy/deployHealthCheck.js'
-import { deployPrepareYargsOptions } from '../deploy/deployPrepare.js'
+import { deployHealthCheckCliOptions } from '../deploy/deployHealthCheck.js'
+import { deployPrepareCliOptions } from '../deploy/deployPrepare.js'
 
 runScript(async () => {
-  const opt = _yargs().options({
-    ...deployPrepareYargsOptions,
-    ...deployHealthCheckYargsOptions,
-  }).argv
+  const opt = _parseArgs({
+    ...deployPrepareCliOptions,
+    ...deployHealthCheckCliOptions,
+  })
 
   await deployGae(opt)
 })

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

@@ -7,18 +7,18 @@ yarn deploy-health-check --url https://service-dot-yourproject.appspot.com
 
  */
 
+import { _parseArgs } from '@naturalcycles/nodejs-lib/args'
 import { runScript } from '@naturalcycles/nodejs-lib/runScript'
-import { _yargs } from '@naturalcycles/nodejs-lib/yargs'
-import { deployHealthCheck, deployHealthCheckYargsOptions } from '../deploy/deployHealthCheck.js'
+import { deployHealthCheck, deployHealthCheckCliOptions } from '../deploy/deployHealthCheck.js'
 
 runScript(async () => {
-  const { url, ...opt } = _yargs().options({
-    ...deployHealthCheckYargsOptions,
+  const { url, ...opt } = _parseArgs({
+    ...deployHealthCheckCliOptions,
     url: {
       type: 'string',
       demandOption: true,
     },
-  }).argv
+  })
 
   await deployHealthCheck(url, opt)
 })

package/src/bin/deploy-prepare.ts

@@ -4,12 +4,12 @@ yarn deploy-prepare
 
  */
 
+import { _parseArgs } from '@naturalcycles/nodejs-lib/args'
 import { runScript } from '@naturalcycles/nodejs-lib/runScript'
-import { _yargs } from '@naturalcycles/nodejs-lib/yargs'
-import { deployPrepare, deployPrepareYargsOptions } from '../deploy/deployPrepare.js'
+import { deployPrepare, deployPrepareCliOptions } from '../deploy/deployPrepare.js'
 
 runScript(async () => {
-  const opt = _yargs().options(deployPrepareYargsOptions).argv
+  const opt = _parseArgs(deployPrepareCliOptions)
 
   await deployPrepare(opt)
 })

package/src/bin/undeploy-gae.ts

@@ -1,15 +1,15 @@
+import { _parseArgs } from '@naturalcycles/nodejs-lib/args'
 import { runScript } from '@naturalcycles/nodejs-lib/runScript'
-import { _yargs } from '@naturalcycles/nodejs-lib/yargs'
 import { undeployGae } from '../deploy/deployGae.js'
 
 runScript(async () => {
-  const { branch } = _yargs().options({
+  const { branch } = _parseArgs({
     branch: {
       type: 'string',
       demandOption: true,
       desc: `Because Github Actions delete event happens after the branch is already deleted - you need to pass it manually`,
     },
-  }).argv
+  })
 
   await undeployGae(branch)
 })

package/src/deploy/deployHealthCheck.ts

@@ -8,6 +8,7 @@ import {
 } from '@naturalcycles/js-lib/object/object.util.js'
 import { pDelay } from '@naturalcycles/js-lib/promise/pDelay.js'
 import type { UnixTimestampMillis } from '@naturalcycles/js-lib/types'
+import type { CliOptions } from '@naturalcycles/nodejs-lib/args'
 import { dimGrey, red } from '@naturalcycles/nodejs-lib/colors'
 import { exec2 } from '@naturalcycles/nodejs-lib/exec2'
 import { coloredHttpCode } from '../server/request.log.util.js'
@@ -26,7 +27,7 @@ export interface DeployHealthCheckOptions {
   authHeader?: string
 }
 
-export const deployHealthCheckYargsOptions = {
+export const deployHealthCheckCliOptions = {
   thresholdHealthy: {
     type: 'number',
     default: 5,
@@ -69,7 +70,7 @@ export const deployHealthCheckYargsOptions = {
   authHeader: {
     type: 'string',
   },
-} as const
+} as const satisfies CliOptions
 
 const inspectOpt: InspectOptions = {
   colors: true,

package/src/deploy/deployPrepare.ts

@@ -1,4 +1,5 @@
 import { loadEnvFileIfExists } from '@naturalcycles/nodejs-lib'
+import type { CliOptions } from '@naturalcycles/nodejs-lib/args'
 import { dimGrey } from '@naturalcycles/nodejs-lib/colors'
 import { fs2 } from '@naturalcycles/nodejs-lib/fs2'
 import { kpySync } from '@naturalcycles/nodejs-lib/kpy'
@@ -19,7 +20,7 @@ export interface DeployPrepareOptions {
   appYamlPassEnv?: string
 }
 
-export const deployPrepareYargsOptions = {
+export const deployPrepareCliOptions = {
   projectDir: {
     type: 'string',
     default: '.',
@@ -37,7 +38,7 @@ export const deployPrepareYargsOptions = {
     type: 'string',
     desc: 'Comma-separated list of env variables that will be passed to app.yaml from process.env',
   },
-} as const
+} as const satisfies CliOptions
 
 const DEFAULT_FILES = [
   'dist',