@dereekb/firebase-server 9.9.4 → 9.10.0

package/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 This file was generated using [@jscutlery/semver](https://github.com/jscutlery/semver).
 
+# [9.10.0](https://github.com/dereekb/dbx-components/compare/v9.9.5-dev...v9.10.0) (2022-10-05)
+
+
+### Features
+
+* added DbxFirebaseDevelopmentSchedulerService ([713bac5](https://github.com/dereekb/dbx-components/commit/713bac57dd1864c52394a16d990f04fc81e0c543))
+* added firebase scheduled tasks ([2114446](https://github.com/dereekb/dbx-components/commit/2114446acb1704e93cabd2933d5876f8d9adb56a))
+* added firebaseServerDevFunctions() ([375e3ac](https://github.com/dereekb/dbx-components/commit/375e3acf4e7539bdca37c68b50617ea455690d69))
+
+
+
+## [9.9.5](https://github.com/dereekb/dbx-components/compare/v9.9.4-dev...v9.9.5) (2022-09-19)
+
+
+
 ## [9.9.4](https://github.com/dereekb/dbx-components/compare/v9.9.3-dev...v9.9.4) (2022-09-19)
 
 

package/mailgun/package.json

@@ -1,42 +1,43 @@
 {
   "name": "@dereekb/firebase-server/mailgun",
-  "version": "9.9.4",
+  "version": "9.10.0",
   "type": "commonjs",
   "main": "./src/index.js",
   "typings": "./src/index.d.ts",
   "dependencies": {},
   "peerDependencies": {
-    "@dereekb/nestjs/mailgun": "9.9.4",
+    "@dereekb/nestjs/mailgun": "9.10.0",
     "@nestjs/common": "^9.0.0",
     "mailgun.js": "^8.0.0",
     "form-data": "4.0.0",
-    "@dereekb/util": "9.9.4",
+    "@dereekb/util": "9.10.0",
     "lodash.isequal": "^4.5.0",
     "make-error": "^1.3.0",
     "class-validator": "^0.13.2",
     "ts-essentials": "^9.1.2",
     "extra-set": "^2.2.11",
-    "@dereekb/nestjs": "9.9.4",
+    "@dereekb/nestjs": "9.10.0",
     "@nestjs/config": "^2.0.1",
-    "@dereekb/firebase-server": "9.9.4",
+    "@dereekb/firebase-server": "9.10.0",
     "jsonwebtoken": "^8.0.0",
-    "@dereekb/firebase": "9.9.4",
+    "@dereekb/firebase": "9.10.0",
     "rxjs": "^7.5.0",
     "firebase": "^9.9.2",
-    "@dereekb/rxjs": "9.9.4",
-    "ms": "^3.0.0-canary.1",
-    "@dereekb/model": "9.9.4",
     "class-transformer": "^0.5.1",
-    "@dereekb/date": "9.9.4",
+    "@dereekb/rxjs": "9.10.0",
+    "ms": "^3.0.0-canary.1",
+    "@dereekb/model": "9.10.0",
+    "@dereekb/date": "9.10.0",
     "date-fns": "^2.29.0",
     "date-fns-tz": "^1.3.0",
     "rrule": "git+https://git@github.com/dereekb/rrule#2b13b1ea881059ba2ecfec380e12ef244ef54570",
     "@vvo/tzdb": "^6.56.0",
-    "firebase-functions": "^3.22.0",
+    "firebase-functions": "^3.24.0",
     "firebase-admin": "^11.0.0",
     "@google-cloud/firestore": "^5.0.2",
     "@nestjs/core": "^9.0.0",
     "@nestjs/platform-express": "^9.0.0",
+    "node-schedule": "^2.1.0",
     "tslib": "^2.0.0"
   }
 }

package/package.json

@@ -1,37 +1,38 @@
 {
   "name": "@dereekb/firebase-server",
-  "version": "9.9.4",
+  "version": "9.10.0",
   "devDependencies": {
     "firebase-functions-test": "2.0.2"
   },
   "peerDependencies": {
     "jsonwebtoken": "^8.0.0",
-    "@dereekb/firebase": "9.9.4",
+    "@dereekb/firebase": "9.10.0",
     "rxjs": "^7.5.0",
     "firebase": "^9.9.2",
-    "@dereekb/util": "9.9.4",
+    "@dereekb/util": "9.10.0",
     "lodash.isequal": "^4.5.0",
     "make-error": "^1.3.0",
     "class-validator": "^0.13.2",
     "ts-essentials": "^9.1.2",
     "extra-set": "^2.2.11",
-    "@dereekb/rxjs": "9.9.4",
-    "ms": "^3.0.0-canary.1",
-    "@dereekb/model": "9.9.4",
     "class-transformer": "^0.5.1",
-    "@dereekb/date": "9.9.4",
+    "@dereekb/rxjs": "9.10.0",
+    "ms": "^3.0.0-canary.1",
+    "@dereekb/model": "9.10.0",
+    "@dereekb/date": "9.10.0",
     "date-fns": "^2.29.0",
     "date-fns-tz": "^1.3.0",
     "rrule": "git+https://git@github.com/dereekb/rrule#2b13b1ea881059ba2ecfec380e12ef244ef54570",
     "@vvo/tzdb": "^6.56.0",
-    "firebase-functions": "^3.22.0",
+    "firebase-functions": "^3.24.0",
     "firebase-admin": "^11.0.0",
     "@google-cloud/firestore": "^5.0.2",
     "@nestjs/common": "^9.0.0",
     "@nestjs/core": "^9.0.0",
     "@nestjs/platform-express": "^9.0.0",
-    "@dereekb/nestjs": "9.9.4",
+    "@dereekb/nestjs": "9.10.0",
     "@nestjs/config": "^2.0.1",
+    "node-schedule": "^2.1.0",
     "tslib": "^2.0.0"
   },
   "exports": {

package/src/lib/env/env.service.d.ts

@@ -8,6 +8,7 @@ export declare abstract class FirebaseServerEnvService {
     abstract readonly isTestingEnv: boolean;
     abstract readonly isProduction: boolean;
     abstract readonly developerToolsEnabled: boolean;
+    abstract readonly developmentSchedulerEnabled: boolean;
     /**
      * @deprecated use isDeveloperToolsEnabled instead.
      */

package/src/lib/env/env.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"env.service.js","sourceRoot":"","sources":["../../../../../../packages/firebase-server/src/lib/env/env.service.ts"],"names":[],"mappings":";;;AAOA,MAAsB,wBAAwB;CAS7C;AATD,4DASC"}
+{"version":3,"file":"env.service.js","sourceRoot":"","sources":["../../../../../../packages/firebase-server/src/lib/env/env.service.ts"],"names":[],"mappings":";;;AAOA,MAAsB,wBAAwB;CAU7C;AAVD,4DAUC"}

package/src/lib/nest/development/development.app.function.d.ts

@@ -0,0 +1,30 @@
+import { OnCallDevelopmentParams, RUN_DEV_FUNCTION_APP_FUNCTION_KEY } from '@dereekb/firebase';
+import { CallableHttpFunction, RunnableHttpFunction } from '../../function/type';
+import { NestAppPromiseGetter } from '../app';
+import { NestApplicationScheduleConfiguredFunctionMap } from '../function/schedule';
+import { OnCallWithNestContextFactory } from '../function/v1/call';
+import { OnCallHandlerWithNestContextFactory } from '../function/v2/call';
+import { AbstractFirebaseNestContext } from '../nest.provider';
+import { OnCallDevelopmentFunctionMap } from './development.function';
+export interface FirebaseServerDevFunctionsConfig<N extends AbstractFirebaseNestContext<any, any>, S extends NestApplicationScheduleConfiguredFunctionMap> {
+    readonly enabled: boolean;
+    /**
+     * Whether or not to require an auth context when calling dev functions. True by default.
+     */
+    readonly secure?: boolean;
+    readonly nest: NestAppPromiseGetter;
+    readonly developerFunctionsMap: OnCallDevelopmentFunctionMap<N>;
+    readonly onCallFactory: OnCallWithNestContextFactory<N> | OnCallHandlerWithNestContextFactory<N>;
+    /**
+     * Whether or not to disable adding the dev schedule function. False by default.
+     */
+    readonly disableDevelopmentScheduleFunction?: boolean;
+    /**
+     * Map of all scheduled functions. Used by the dev schedule function. If not provided, the dev schedule function is not generated.
+     */
+    readonly allScheduledFunctions?: S;
+}
+export interface FirebaseServerDevFunctions {
+    readonly [RUN_DEV_FUNCTION_APP_FUNCTION_KEY]: RunnableHttpFunction<OnCallDevelopmentParams> | CallableHttpFunction<OnCallDevelopmentParams>;
+}
+export declare function firebaseServerDevFunctions<N extends AbstractFirebaseNestContext<any, any>, S extends NestApplicationScheduleConfiguredFunctionMap>(config: FirebaseServerDevFunctionsConfig<N, S>): FirebaseServerDevFunctions;

package/src/lib/nest/development/development.app.function.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.firebaseServerDevFunctions = void 0;
+const tslib_1 = require("tslib");
+const firebase_server_1 = require("@dereekb/firebase-server");
+const firebase_1 = require("@dereekb/firebase");
+const development_function_1 = require("./development.function");
+const development_schedule_function_1 = require("./development.schedule.function");
+const error_1 = require("../../function/error");
+function firebaseServerDevFunctions(config) {
+    const { enabled, secure, nest, developerFunctionsMap, onCallFactory, allScheduledFunctions, disableDevelopmentScheduleFunction } = config;
+    let dev;
+    if (enabled) {
+        const fullFunctionsMap = Object.assign({}, developerFunctionsMap);
+        if (allScheduledFunctions && disableDevelopmentScheduleFunction !== false) {
+            fullFunctionsMap[firebase_1.SCHEDULED_FUNCTION_DEV_FUNCTION_SPECIFIER] = (0, development_schedule_function_1.makeScheduledFunctionDevelopmentFunction)({
+                allScheduledFunctions
+            });
+        }
+        let onCallFunction = (0, development_function_1.onCallDevelopmentFunction)(fullFunctionsMap);
+        if (secure != false) {
+            onCallFunction = (0, firebase_server_1.inAuthContext)(onCallFunction);
+        }
+        dev = onCallFactory(onCallFunction)(nest);
+    }
+    else {
+        dev = onCallFactory((x) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+            throw (0, error_1.unavailableError)({
+                message: 'developer tools service is not enabled.'
+            });
+        }))(nest);
+    }
+    return {
+        dev
+    };
+}
+exports.firebaseServerDevFunctions = firebaseServerDevFunctions;
+//# sourceMappingURL=development.app.function.js.map

package/src/lib/nest/development/development.app.function.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"development.app.function.js","sourceRoot":"","sources":["../../../../../../../packages/firebase-server/src/lib/nest/development/development.app.function.ts"],"names":[],"mappings":";;;;AAAA,8DAAyD;AACzD,gDAA0I;AAO1I,iEAAiG;AACjG,mFAA2F;AAC3F,gDAAwD;AAyBxD,SAAgB,0BAA0B,CAA0G,MAA8C;IAChM,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,EAAE,aAAa,EAAE,qBAAqB,EAAE,kCAAkC,EAAE,GAAG,MAAM,CAAC;IAE1I,IAAI,GAAkG,CAAC;IAEvG,IAAI,OAAO,EAAE;QACX,MAAM,gBAAgB,qBACjB,qBAAqB,CACzB,CAAC;QAEF,IAAI,qBAAqB,IAAI,kCAAkC,KAAK,KAAK,EAAE;YACzE,gBAAgB,CAAC,oDAAyC,CAAC,GAAG,IAAA,wEAAwC,EAAC;gBACrG,qBAAqB;aACtB,CAAC,CAAC;SACJ;QAED,IAAI,cAAc,GAAG,IAAA,gDAAyB,EAAC,gBAAgB,CAAC,CAAC;QAEjE,IAAI,MAAM,IAAI,KAAK,EAAE;YACnB,cAAc,GAAG,IAAA,+BAAa,EAAC,cAAc,CAAC,CAAC;SAChD;QAED,GAAG,GAAG,aAAa,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC;KAC3C;SAAM;QACL,GAAG,GAAG,aAAa,CAAC,CAAO,CAAC,EAAE,EAAE;YAC9B,MAAM,IAAA,wBAAgB,EAAC;gBACrB,OAAO,EAAE,yCAAyC;aACnD,CAAC,CAAC;QACL,CAAC,CAAA,CAAC,CAAC,IAAI,CAAC,CAAC;KACV;IAED,OAAO;QACL,GAAG;KACJ,CAAC;AACJ,CAAC;AAlCD,gEAkCC"}

package/src/lib/nest/development/development.assert.function.d.ts

@@ -0,0 +1,9 @@
+import { NestContextCallableRequest } from '../function/nest';
+export interface AssertDevelopmentRequestFunctionContext<N, I = unknown> {
+    request: NestContextCallableRequest<N, I>;
+    specifier: string;
+}
+/**
+ * Function that asserts something given the input request.
+ */
+export declare type AssertDevelopmentRequestFunction<N, I = unknown> = (context: AssertDevelopmentRequestFunctionContext<N, I>) => void;

package/src/lib/nest/development/development.assert.function.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=development.assert.function.js.map

package/src/lib/nest/development/development.assert.function.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"development.assert.function.js","sourceRoot":"","sources":["../../../../../../../packages/firebase-server/src/lib/nest/development/development.assert.function.ts"],"names":[],"mappings":""}

package/src/lib/nest/development/development.function.d.ts

@@ -0,0 +1,20 @@
+import { PromiseOrValue } from '@dereekb/util';
+import { OnCallDevelopmentParams, DevelopmentFirebaseFunctionSpecifierRef, DevelopmentFirebaseFunctionSpecifier } from '@dereekb/firebase';
+import { OnCallWithNestContext } from '../function/call';
+import { NestContextCallableRequest } from '../function/nest';
+import { AssertDevelopmentRequestFunction } from './development.assert.function';
+export declare type OnCallDevelopmentFunction<N, I = unknown, O = unknown> = (request: NestContextCallableRequest<N, I> & DevelopmentFirebaseFunctionSpecifierRef) => PromiseOrValue<O>;
+export declare type OnCallDevelopmentFunctionMap<N> = {
+    [key: string]: OnCallDevelopmentFunction<N, any, any>;
+};
+export interface OnCallDevelopmentConfig<N> {
+    preAssert?: AssertDevelopmentRequestFunction<N, OnCallDevelopmentParams>;
+}
+/**
+ * Creates a OnCallWithAuthorizedNestContext function for creating a model.
+ *
+ * @param map
+ * @returns
+ */
+export declare function onCallDevelopmentFunction<N>(map: OnCallDevelopmentFunctionMap<N>, config?: OnCallDevelopmentConfig<N>): OnCallWithNestContext<N, OnCallDevelopmentParams, unknown>;
+export declare function developmentUnknownSpecifierError(specifier: DevelopmentFirebaseFunctionSpecifier): import("firebase-functions/v1/auth").HttpsError;

package/src/lib/nest/development/development.function.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.developmentUnknownSpecifierError = exports.onCallDevelopmentFunction = void 0;
+const util_1 = require("@dereekb/util");
+const function_1 = require("../../function");
+/**
+ * Creates a OnCallWithAuthorizedNestContext function for creating a model.
+ *
+ * @param map
+ * @returns
+ */
+function onCallDevelopmentFunction(map, config = {}) {
+    const { preAssert = () => undefined } = config;
+    return (request) => {
+        const specifier = request.data.specifier;
+        const devFn = map[specifier];
+        if (devFn) {
+            preAssert({ request, specifier });
+            return devFn(Object.assign(Object.assign({}, request), { specifier, data: request.data.data }));
+        }
+        else {
+            throw developmentUnknownSpecifierError(specifier);
+        }
+    };
+}
+exports.onCallDevelopmentFunction = onCallDevelopmentFunction;
+function developmentUnknownSpecifierError(specifier) {
+    return (0, function_1.badRequestError)((0, util_1.serverError)({
+        status: 400,
+        code: 'UNKNOWN_SPECIFIER_ERROR',
+        message: `Invalid specifier "${specifier}" to run.`,
+        data: {
+            specifier
+        }
+    }));
+}
+exports.developmentUnknownSpecifierError = developmentUnknownSpecifierError;
+//# sourceMappingURL=development.function.js.map

package/src/lib/nest/development/development.function.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"development.function.js","sourceRoot":"","sources":["../../../../../../../packages/firebase-server/src/lib/nest/development/development.function.ts"],"names":[],"mappings":";;;AAAA,wCAA4D;AAE5D,6CAAiD;AAgBjD;;;;;GAKG;AACH,SAAgB,yBAAyB,CAAI,GAAoC,EAAE,SAAqC,EAAE;IACxH,MAAM,EAAE,SAAS,GAAG,GAAG,EAAE,CAAC,SAAS,EAAE,GAAG,MAAM,CAAC;IAE/C,OAAO,CAAC,OAAO,EAAE,EAAE;QACjB,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;QACzC,MAAM,KAAK,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC;QAE7B,IAAI,KAAK,EAAE;YACT,SAAS,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;YAClC,OAAO,KAAK,iCACP,OAAO,KACV,SAAS,EACT,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,IACvB,CAAC;SACJ;aAAM;YACL,MAAM,gCAAgC,CAAC,SAAS,CAAC,CAAC;SACnD;IACH,CAAC,CAAC;AACJ,CAAC;AAlBD,8DAkBC;AAED,SAAgB,gCAAgC,CAAC,SAA+C;IAC9F,OAAO,IAAA,0BAAe,EACpB,IAAA,kBAAW,EAAC;QACV,MAAM,EAAE,GAAG;QACX,IAAI,EAAE,yBAAyB;QAC/B,OAAO,EAAE,sBAAsB,SAAS,WAAW;QACnD,IAAI,EAAE;YACJ,SAAS;SACV;KACF,CAAC,CACH,CAAC;AACJ,CAAC;AAXD,4EAWC"}

package/src/lib/nest/development/development.schedule.function.d.ts

@@ -0,0 +1,7 @@
+import { ScheduledFunctionDevelopmentFirebaseFunctionParams, ScheduledFunctionDevelopmentFirebaseFunctionResult } from '@dereekb/firebase';
+import { NestApplicationScheduleConfiguredFunctionMap } from '../function/schedule';
+import { OnCallDevelopmentFunction } from './development.function';
+export interface MakeScheduledFunctionDevelopmentFunctionConfig {
+    readonly allScheduledFunctions: NestApplicationScheduleConfiguredFunctionMap;
+}
+export declare function makeScheduledFunctionDevelopmentFunction(config: MakeScheduledFunctionDevelopmentFunctionConfig): OnCallDevelopmentFunction<unknown, ScheduledFunctionDevelopmentFirebaseFunctionParams, ScheduledFunctionDevelopmentFirebaseFunctionResult>;

package/src/lib/nest/development/development.schedule.function.error.d.ts

@@ -0,0 +1,6 @@
+export declare const NO_RUN_NAME_SPECIFIED_FOR_SCHEDULED_FUNCTION_DEVELOPMENT_FUNCTION_CODE = "NO_RUN_NAME_SPECIFIED_FOR_SCHEDULED_FUNCTION_DEVELOPMENT_FUNCTION";
+export declare function noRunNameSpecifiedForScheduledFunctionDevelopmentFunction(): import("firebase-functions/v1/auth").HttpsError;
+export declare const UNKNOWN_SCHEDULED_FUNCTION_DEVELOPMENT_FUNCTION_NAME_CODE = "UNKNOWN_SCHEDULED_FUNCTION_DEVELOPMENT_FUNCTION_NAME";
+export declare function unknownScheduledFunctionDevelopmentFunctionName(name: unknown): import("firebase-functions/v1/auth").HttpsError;
+export declare const UNKNOWN_SCHEDULED_FUNCTION_DEVELOPMENT_FUNCTION_TYPE_CODE = "UNKNOWN_SCHEDULED_FUNCTION_DEVELOPMENT_FUNCTION_TYPE";
+export declare function unknownScheduledFunctionDevelopmentFunctionType(type: unknown): import("firebase-functions/v1/auth").HttpsError;

package/src/lib/nest/development/development.schedule.function.error.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unknownScheduledFunctionDevelopmentFunctionType = exports.UNKNOWN_SCHEDULED_FUNCTION_DEVELOPMENT_FUNCTION_TYPE_CODE = exports.unknownScheduledFunctionDevelopmentFunctionName = exports.UNKNOWN_SCHEDULED_FUNCTION_DEVELOPMENT_FUNCTION_NAME_CODE = exports.noRunNameSpecifiedForScheduledFunctionDevelopmentFunction = exports.NO_RUN_NAME_SPECIFIED_FOR_SCHEDULED_FUNCTION_DEVELOPMENT_FUNCTION_CODE = void 0;
+const error_1 = require("../../function/error");
+exports.NO_RUN_NAME_SPECIFIED_FOR_SCHEDULED_FUNCTION_DEVELOPMENT_FUNCTION_CODE = 'NO_RUN_NAME_SPECIFIED_FOR_SCHEDULED_FUNCTION_DEVELOPMENT_FUNCTION';
+function noRunNameSpecifiedForScheduledFunctionDevelopmentFunction() {
+    return (0, error_1.badRequestError)({
+        code: exports.NO_RUN_NAME_SPECIFIED_FOR_SCHEDULED_FUNCTION_DEVELOPMENT_FUNCTION_CODE,
+        message: `Must specify run parameter.`
+    });
+}
+exports.noRunNameSpecifiedForScheduledFunctionDevelopmentFunction = noRunNameSpecifiedForScheduledFunctionDevelopmentFunction;
+exports.UNKNOWN_SCHEDULED_FUNCTION_DEVELOPMENT_FUNCTION_NAME_CODE = 'UNKNOWN_SCHEDULED_FUNCTION_DEVELOPMENT_FUNCTION_NAME';
+function unknownScheduledFunctionDevelopmentFunctionName(name) {
+    return (0, error_1.badRequestError)({
+        code: exports.UNKNOWN_SCHEDULED_FUNCTION_DEVELOPMENT_FUNCTION_NAME_CODE,
+        message: `Unknown function with name "${name}"`,
+        data: {
+            name
+        }
+    });
+}
+exports.unknownScheduledFunctionDevelopmentFunctionName = unknownScheduledFunctionDevelopmentFunctionName;
+exports.UNKNOWN_SCHEDULED_FUNCTION_DEVELOPMENT_FUNCTION_TYPE_CODE = 'UNKNOWN_SCHEDULED_FUNCTION_DEVELOPMENT_FUNCTION_TYPE';
+function unknownScheduledFunctionDevelopmentFunctionType(type) {
+    return (0, error_1.badRequestError)({
+        code: exports.UNKNOWN_SCHEDULED_FUNCTION_DEVELOPMENT_FUNCTION_TYPE_CODE,
+        message: `Unknown type "${type}"`,
+        data: {
+            type
+        }
+    });
+}
+exports.unknownScheduledFunctionDevelopmentFunctionType = unknownScheduledFunctionDevelopmentFunctionType;
+//# sourceMappingURL=development.schedule.function.error.js.map

package/src/lib/nest/development/development.schedule.function.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"development.schedule.function.error.js","sourceRoot":"","sources":["../../../../../../../packages/firebase-server/src/lib/nest/development/development.schedule.function.error.ts"],"names":[],"mappings":";;;AAAA,gDAAuD;AAE1C,QAAA,sEAAsE,GAAG,mEAAmE,CAAC;AAE1J,SAAgB,yDAAyD;IACvE,OAAO,IAAA,uBAAe,EAAC;QACrB,IAAI,EAAE,8EAAsE;QAC5E,OAAO,EAAE,6BAA6B;KACvC,CAAC,CAAC;AACL,CAAC;AALD,8HAKC;AAEY,QAAA,yDAAyD,GAAG,sDAAsD,CAAC;AAEhI,SAAgB,+CAA+C,CAAC,IAAa;IAC3E,OAAO,IAAA,uBAAe,EAAC;QACrB,IAAI,EAAE,iEAAyD;QAC/D,OAAO,EAAE,+BAA+B,IAAI,GAAG;QAC/C,IAAI,EAAE;YACJ,IAAI;SACL;KACF,CAAC,CAAC;AACL,CAAC;AARD,0GAQC;AAEY,QAAA,yDAAyD,GAAG,sDAAsD,CAAC;AAEhI,SAAgB,+CAA+C,CAAC,IAAa;IAC3E,OAAO,IAAA,uBAAe,EAAC;QACrB,IAAI,EAAE,iEAAyD;QAC/D,OAAO,EAAE,iBAAiB,IAAI,GAAG;QACjC,IAAI,EAAE;YACJ,IAAI;SACL;KACF,CAAC,CAAC;AACL,CAAC;AARD,0GAQC"}

package/src/lib/nest/development/development.schedule.function.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeScheduledFunctionDevelopmentFunction = void 0;
+const tslib_1 = require("tslib");
+const util_1 = require("@dereekb/util");
+const development_schedule_function_error_1 = require("./development.schedule.function.error");
+function makeScheduledFunctionDevelopmentFunction(config) {
+    const { allScheduledFunctions } = config;
+    const getListValues = (0, util_1.cachedGetter)(() => {
+        const result = [];
+        (0, util_1.forEachKeyValue)(allScheduledFunctions, {
+            forEach: (x) => {
+                const [functionName, config] = x;
+                result.push({
+                    name: functionName.toString()
+                });
+            }
+        });
+        return result;
+    });
+    return (request) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+        const { data } = request;
+        const { type } = data;
+        switch (type) {
+            case 'run':
+                const targetRunName = data.run;
+                if (!targetRunName) {
+                    throw (0, development_schedule_function_error_1.noRunNameSpecifiedForScheduledFunctionDevelopmentFunction)();
+                }
+                const targetFunction = allScheduledFunctions[targetRunName];
+                if (!targetFunction) {
+                    throw (0, development_schedule_function_error_1.unknownScheduledFunctionDevelopmentFunctionName)(targetRunName);
+                }
+                try {
+                    yield targetFunction._runNow();
+                }
+                catch (e) {
+                    console.error(`Failed manually running task "${targetRunName}".`, e);
+                    throw e;
+                }
+                return {
+                    type: 'run',
+                    success: true
+                };
+            case 'list':
+                return {
+                    type: 'list',
+                    list: getListValues()
+                };
+            default:
+                throw (0, development_schedule_function_error_1.unknownScheduledFunctionDevelopmentFunctionType)(type);
+        }
+    });
+}
+exports.makeScheduledFunctionDevelopmentFunction = makeScheduledFunctionDevelopmentFunction;
+//# sourceMappingURL=development.schedule.function.js.map

package/src/lib/nest/development/development.schedule.function.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"development.schedule.function.js","sourceRoot":"","sources":["../../../../../../../packages/firebase-server/src/lib/nest/development/development.schedule.function.ts"],"names":[],"mappings":";;;;AACA,wCAA8D;AAG9D,+FAAoN;AAMpN,SAAgB,wCAAwC,CAAC,MAAsD;IAC7G,MAAM,EAAE,qBAAqB,EAAE,GAAG,MAAM,CAAC;IACzC,MAAM,aAAa,GAAG,IAAA,mBAAY,EAAC,GAAG,EAAE;QACtC,MAAM,MAAM,GAA4D,EAAE,CAAC;QAE3E,IAAA,sBAAe,EAAC,qBAAqB,EAAE;YACrC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE;gBACb,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;gBAEjC,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,YAAY,CAAC,QAAQ,EAAE;iBAC9B,CAAC,CAAC;YACL,CAAC;SACF,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH,OAAO,CAAO,OAAO,EAAE,EAAE;QACvB,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;QACzB,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QAEtB,QAAQ,IAAI,EAAE;YACZ,KAAK,KAAK;gBACR,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC;gBAE/B,IAAI,CAAC,aAAa,EAAE;oBAClB,MAAM,IAAA,+FAAyD,GAAE,CAAC;iBACnE;gBAED,MAAM,cAAc,GAAG,qBAAqB,CAAC,aAAa,CAAC,CAAC;gBAE5D,IAAI,CAAC,cAAc,EAAE;oBACnB,MAAM,IAAA,qFAA+C,EAAC,aAAa,CAAC,CAAC;iBACtE;gBAED,IAAI;oBACF,MAAM,cAAc,CAAC,OAAO,EAAE,CAAC;iBAChC;gBAAC,OAAO,CAAC,EAAE;oBACV,OAAO,CAAC,KAAK,CAAC,iCAAiC,aAAa,IAAI,EAAE,CAAC,CAAC,CAAC;oBACrE,MAAM,CAAC,CAAC;iBACT;gBAED,OAAO;oBACL,IAAI,EAAE,KAAK;oBACX,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,KAAK,MAAM;gBACT,OAAO;oBACL,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,aAAa,EAAE;iBACtB,CAAC;YACJ;gBACE,MAAM,IAAA,qFAA+C,EAAC,IAAI,CAAC,CAAC;SAC/D;IACH,CAAC,CAAA,CAAC;AACJ,CAAC;AAxDD,4FAwDC"}

package/src/lib/nest/development/index.d.ts

@@ -0,0 +1,5 @@
+export * from './development.app.function';
+export * from './development.assert.function';
+export * from './development.function';
+export * from './development.schedule.function';
+export * from './development.schedule.function.error';

package/src/lib/nest/development/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./development.app.function"), exports);
+tslib_1.__exportStar(require("./development.assert.function"), exports);
+tslib_1.__exportStar(require("./development.function"), exports);
+tslib_1.__exportStar(require("./development.schedule.function"), exports);
+tslib_1.__exportStar(require("./development.schedule.function.error"), exports);
+//# sourceMappingURL=index.js.map

package/src/lib/nest/development/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../packages/firebase-server/src/lib/nest/development/index.ts"],"names":[],"mappings":";;;AAAA,qEAA2C;AAC3C,wEAA8C;AAC9C,iEAAuC;AACvC,0EAAgD;AAChD,gFAAsD"}

package/src/lib/nest/env/env.service.d.ts

@@ -1,6 +1,10 @@
 import { ServerEnvironmentService } from '@dereekb/nestjs';
 import { FirebaseServerEnvService } from '../../env';
 export declare class DefaultFirebaseServerEnvService extends ServerEnvironmentService implements FirebaseServerEnvService {
+    /**
+     * Enabled when not in production and not in a testing environment.
+     */
+    get developmentSchedulerEnabled(): boolean;
     /**
      * @deprecated use isDeveloperToolsEnabled instead.z
      */

package/src/lib/nest/env/env.service.js

@@ -5,6 +5,12 @@ const tslib_1 = require("tslib");
 const nestjs_1 = require("@dereekb/nestjs");
 const common_1 = require("@nestjs/common");
 let DefaultFirebaseServerEnvService = class DefaultFirebaseServerEnvService extends nestjs_1.ServerEnvironmentService {
+    /**
+     * Enabled when not in production and not in a testing environment.
+     */
+    get developmentSchedulerEnabled() {
+        return !this.isProduction && !this.isTestingEnv;
+    }
     /**
      * @deprecated use isDeveloperToolsEnabled instead.z
      */

package/src/lib/nest/env/env.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"env.service.js","sourceRoot":"","sources":["../../../../../../../packages/firebase-server/src/lib/nest/env/env.service.ts"],"names":[],"mappings":";;;;AAAA,4CAA2D;AAC3D,2CAA4C;AAI5C,IAAa,+BAA+B,GAA5C,MAAa,+BAAgC,SAAQ,iCAAwB;IAC3E;;OAEG;IACH,IAAI,yBAAyB;QAC3B,OAAO,IAAI,CAAC,qBAAqB,CAAC;IACpC,CAAC;CACF,CAAA;AAPY,+BAA+B;IAD3C,IAAA,mBAAU,GAAE;GACA,+BAA+B,CAO3C;AAPY,0EAA+B"}
+{"version":3,"file":"env.service.js","sourceRoot":"","sources":["../../../../../../../packages/firebase-server/src/lib/nest/env/env.service.ts"],"names":[],"mappings":";;;;AAAA,4CAA2D;AAC3D,2CAA4C;AAI5C,IAAa,+BAA+B,GAA5C,MAAa,+BAAgC,SAAQ,iCAAwB;IAC3E;;OAEG;IACH,IAAI,2BAA2B;QAC7B,OAAO,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,IAAI,yBAAyB;QAC3B,OAAO,IAAI,CAAC,qBAAqB,CAAC;IACpC,CAAC;CACF,CAAA;AAdY,+BAA+B;IAD3C,IAAA,mBAAU,GAAE;GACA,+BAA+B,CAc3C;AAdY,0EAA+B"}

package/src/lib/nest/env/env.util.d.ts

@@ -0,0 +1,4 @@
+import { AsyncDecisionFunction } from '@dereekb/util';
+import { NestAppPromiseGetter } from '../app';
+export declare function nestAppIsProductionEnvironment(nest: NestAppPromiseGetter): AsyncDecisionFunction<void>;
+export declare function nestAppHasDevelopmentSchedulerEnabled(nest: NestAppPromiseGetter): AsyncDecisionFunction<void>;

package/src/lib/nest/env/env.util.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nestAppHasDevelopmentSchedulerEnabled = exports.nestAppIsProductionEnvironment = void 0;
+const env_service_1 = require("../../env/env.service");
+function nestAppIsProductionEnvironment(nest) {
+    return () => nest().then((x) => x.get(env_service_1.FirebaseServerEnvService).isProduction);
+}
+exports.nestAppIsProductionEnvironment = nestAppIsProductionEnvironment;
+function nestAppHasDevelopmentSchedulerEnabled(nest) {
+    return () => nest().then((x) => x.get(env_service_1.FirebaseServerEnvService).developmentSchedulerEnabled);
+}
+exports.nestAppHasDevelopmentSchedulerEnabled = nestAppHasDevelopmentSchedulerEnabled;
+//# sourceMappingURL=env.util.js.map

package/src/lib/nest/env/env.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.util.js","sourceRoot":"","sources":["../../../../../../../packages/firebase-server/src/lib/nest/env/env.util.ts"],"names":[],"mappings":";;;AACA,uDAAiE;AAGjE,SAAgB,8BAA8B,CAAC,IAA0B;IACvE,OAAO,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,sCAAwB,CAAC,CAAC,YAAY,CAAC,CAAC;AAChF,CAAC;AAFD,wEAEC;AAED,SAAgB,qCAAqC,CAAC,IAA0B;IAC9E,OAAO,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,sCAAwB,CAAC,CAAC,2BAA2B,CAAC,CAAC;AAC/F,CAAC;AAFD,sFAEC"}

package/src/lib/nest/env/index.d.ts

@@ -1,3 +1,4 @@
 export * from './env.config';
 export * from './env.nest';
 export * from './env.service';
+export * from './env.util';

package/src/lib/nest/env/index.js

@@ -4,4 +4,5 @@ const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./env.config"), exports);
 tslib_1.__exportStar(require("./env.nest"), exports);
 tslib_1.__exportStar(require("./env.service"), exports);
+tslib_1.__exportStar(require("./env.util"), exports);
 //# sourceMappingURL=index.js.map

package/src/lib/nest/env/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../packages/firebase-server/src/lib/nest/env/index.ts"],"names":[],"mappings":";;;AAAA,uDAA6B;AAC7B,qDAA2B;AAC3B,wDAA8B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../packages/firebase-server/src/lib/nest/env/index.ts"],"names":[],"mappings":";;;AAAA,uDAA6B;AAC7B,qDAA2B;AAC3B,wDAA8B;AAC9B,qDAA2B"}

package/src/lib/nest/function/index.d.ts

@@ -3,3 +3,5 @@ export * from './v2';
 export * from './context';
 export * from './call';
 export * from './nest';
+export * from './schedule';
+export * from './schedule.util';

package/src/lib/nest/function/index.js

@@ -6,4 +6,6 @@ tslib_1.__exportStar(require("./v2"), exports);
 tslib_1.__exportStar(require("./context"), exports);
 tslib_1.__exportStar(require("./call"), exports);
 tslib_1.__exportStar(require("./nest"), exports);
+tslib_1.__exportStar(require("./schedule"), exports);
+tslib_1.__exportStar(require("./schedule.util"), exports);
 //# sourceMappingURL=index.js.map

package/src/lib/nest/function/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../packages/firebase-server/src/lib/nest/function/index.ts"],"names":[],"mappings":";;;AAAA,+CAAqB;AACrB,+CAAqB;AACrB,oDAA0B;AAC1B,iDAAuB;AACvB,iDAAuB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../packages/firebase-server/src/lib/nest/function/index.ts"],"names":[],"mappings":";;;AAAA,+CAAqB;AACrB,+CAAqB;AACrB,oDAA0B;AAC1B,iDAAuB;AACvB,iDAAuB;AACvB,qDAA2B;AAC3B,0DAAgC"}

package/src/lib/nest/function/schedule.d.ts

@@ -0,0 +1,61 @@
+import { Minutes, PromiseOrValue } from '@dereekb/util';
+import { MakeNestContext, NestApplicationFunctionFactory } from '../nest.provider';
+import { NestApplicationContextRequest, NestContextRequest } from './nest';
+export interface OnScheduleConfig {
+    /**
+     * Scheduled time in a cron-tab format.
+     *
+     * Used by v1 and v2.
+     */
+    cron?: Minutes | string;
+    /**
+     * Scheduled time configuration in an english format.
+     *
+     * Used by v2.
+     */
+    schedule?: string;
+    /**
+     * Optional timezone to specify.
+     */
+    timezone?: string;
+    /**
+     * The number of retry attempts for a failed run.
+     */
+    retryCount?: number;
+    /**
+     * The time limit for retrying.
+     */
+    maxRetrySeconds?: number;
+    /**
+     * The minimum time to wait before retying.
+     */
+    minBackoffSeconds?: number;
+    /**
+     * The maximum time to wait before retrying.
+     */
+    maxBackoffSeconds?: number;
+    /**
+     * The time between will double max doublings times.
+     */
+    maxDoublings?: number;
+}
+export interface OnScheduleRequest<S> {
+    scheduleContext?: S;
+}
+export declare type OnScheduleWithNestApplicationRequest<S = unknown> = NestApplicationContextRequest<OnScheduleRequest<S>>;
+/**
+ * Scheduled function that is passed an INestApplicationContext in addition to the OnScheduleRequest object.
+ */
+export declare type OnScheduleWithNestApplication<S = unknown> = (request: OnScheduleWithNestApplicationRequest<S>) => PromiseOrValue<void>;
+export declare type OnScheduleWithNestContextRequest<N, S = unknown> = NestContextRequest<N, OnScheduleRequest<S>>;
+/**
+ * Scheduled function that is passed an arbitrary nest context object in addition to the OnScheduleRequest object.
+ */
+export declare type OnScheduleWithNestContext<N, S = unknown> = (request: OnScheduleWithNestContextRequest<N, S>) => PromiseOrValue<void>;
+export declare function setNestContextOnScheduleRequest<N, S>(makeNestContext: MakeNestContext<N>, request: OnScheduleWithNestApplicationRequest<S>): OnScheduleWithNestContextRequest<N, S>;
+export declare type NestApplicationScheduleConfiguredFunction<F extends object = object> = F & {
+    _runNow(): PromiseOrValue<void>;
+    readonly _schedule: OnScheduleConfig;
+};
+export declare type NestApplicationScheduleConfiguredFunctionFactory<F extends object = object> = NestApplicationFunctionFactory<NestApplicationScheduleConfiguredFunction<F>>;
+export declare type NestApplicationScheduleConfiguredFunctionMap = Record<string, NestApplicationScheduleConfiguredFunction>;

package/src/lib/nest/function/schedule.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setNestContextOnScheduleRequest = void 0;
+function setNestContextOnScheduleRequest(makeNestContext, request) {
+    request.nest = makeNestContext(request.nestApplication);
+    return request;
+}
+exports.setNestContextOnScheduleRequest = setNestContextOnScheduleRequest;
+//# sourceMappingURL=schedule.js.map

package/src/lib/nest/function/schedule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule.js","sourceRoot":"","sources":["../../../../../../../packages/firebase-server/src/lib/nest/function/schedule.ts"],"names":[],"mappings":";;;AA+DA,SAAgB,+BAA+B,CAAO,eAAmC,EAAE,OAAgD;IACxI,OAA2E,CAAC,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IAC7H,OAAO,OAA4D,CAAC;AACtE,CAAC;AAHD,0EAGC"}