@dereekb/firebase-server 13.5.2 → 13.6.1

package/mailgun/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@dereekb/firebase-server/mailgun",
-  "version": "13.5.2",
+  "version": "13.6.1",
   "peerDependencies": {
-    "@dereekb/analytics": "13.5.2",
-    "@dereekb/firebase": "13.5.2",
-    "@dereekb/firebase-server": "13.5.2",
-    "@dereekb/date": "13.5.2",
-    "@dereekb/nestjs": "13.5.2",
-    "@dereekb/model": "13.5.2",
-    "@dereekb/rxjs": "13.5.2",
-    "@dereekb/util": "13.5.2"
+    "@dereekb/analytics": "13.6.1",
+    "@dereekb/firebase": "13.6.1",
+    "@dereekb/firebase-server": "13.6.1",
+    "@dereekb/date": "13.6.1",
+    "@dereekb/nestjs": "13.6.1",
+    "@dereekb/model": "13.6.1",
+    "@dereekb/rxjs": "13.6.1",
+    "@dereekb/util": "13.6.1"
   },
   "exports": {
     "./package.json": "./package.json",

package/model/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@dereekb/firebase-server/model",
-  "version": "13.5.2",
+  "version": "13.6.1",
   "peerDependencies": {
-    "@dereekb/analytics": "13.5.2",
-    "@dereekb/date": "13.5.2",
-    "@dereekb/firebase": "13.5.2",
-    "@dereekb/firebase-server": "13.5.2",
-    "@dereekb/model": "13.5.2",
-    "@dereekb/nestjs": "13.5.2",
-    "@dereekb/rxjs": "13.5.2",
-    "@dereekb/util": "13.5.2",
+    "@dereekb/analytics": "13.6.1",
+    "@dereekb/date": "13.6.1",
+    "@dereekb/firebase": "13.6.1",
+    "@dereekb/firebase-server": "13.6.1",
+    "@dereekb/model": "13.6.1",
+    "@dereekb/nestjs": "13.6.1",
+    "@dereekb/rxjs": "13.6.1",
+    "@dereekb/util": "13.6.1",
     "@nestjs/common": "^11.1.17",
     "@nestjs/config": "^4.0.3",
     "archiver": "^7.0.0",

package/oidc/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@dereekb/firebase-server/oidc",
-  "version": "13.5.2",
+  "version": "13.6.1",
   "peerDependencies": {
-    "@dereekb/analytics": "13.5.2",
-    "@dereekb/date": "13.5.2",
-    "@dereekb/firebase": "13.5.2",
-    "@dereekb/firebase-server": "13.5.2",
-    "@dereekb/model": "13.5.2",
-    "@dereekb/nestjs": "13.5.2",
-    "@dereekb/rxjs": "13.5.2",
-    "@dereekb/util": "13.5.2",
-    "@dereekb/zoho": "13.5.2",
+    "@dereekb/analytics": "13.6.1",
+    "@dereekb/date": "13.6.1",
+    "@dereekb/firebase": "13.6.1",
+    "@dereekb/firebase-server": "13.6.1",
+    "@dereekb/model": "13.6.1",
+    "@dereekb/nestjs": "13.6.1",
+    "@dereekb/rxjs": "13.6.1",
+    "@dereekb/util": "13.6.1",
+    "@dereekb/zoho": "13.6.1",
     "@nestjs/common": "^11.1.17",
     "@nestjs/config": "^4.0.3",
     "express": "^5.0.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/firebase-server",
-  "version": "13.5.2",
+  "version": "13.6.1",
   "exports": {
     "./test": {
       "module": "./test/index.esm.js",
@@ -43,15 +43,15 @@
   "main": "./index.cjs.js",
   "types": "./src/index.d.ts",
   "peerDependencies": {
-    "@dereekb/analytics": "13.5.2",
-    "@dereekb/date": "13.5.2",
-    "@dereekb/dbx-core": "13.5.2",
-    "@dereekb/firebase": "13.5.2",
-    "@dereekb/model": "13.5.2",
-    "@dereekb/nestjs": "13.5.2",
-    "@dereekb/rxjs": "13.5.2",
-    "@dereekb/util": "13.5.2",
-    "@dereekb/zoho": "13.5.2",
+    "@dereekb/analytics": "13.6.1",
+    "@dereekb/date": "13.6.1",
+    "@dereekb/dbx-core": "13.6.1",
+    "@dereekb/firebase": "13.6.1",
+    "@dereekb/model": "13.6.1",
+    "@dereekb/nestjs": "13.6.1",
+    "@dereekb/rxjs": "13.6.1",
+    "@dereekb/util": "13.6.1",
+    "@dereekb/zoho": "13.6.1",
     "@google-cloud/firestore": "^7.11.6",
     "@google-cloud/storage": "^7.19.0",
     "@nestjs/common": "^11.1.17",

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

@@ -318,56 +318,56 @@ export interface FirebaseServerAuthInitializeNewUser<D = unknown> {
     /**
      * Specific user identifier to use.
      */
-    readonly uid?: FirebaseAuthUserId;
+    readonly uid?: Maybe<FirebaseAuthUserId>;
     /**
      * User's display name
      */
-    readonly displayName?: string;
+    readonly displayName?: Maybe<string>;
     /**
      * Email for the new user, if applicable.
      */
-    readonly email?: EmailAddress;
+    readonly email?: Maybe<EmailAddress>;
     /**
      * Phone for the new user, if applicable. Must be a valid {@link E164PhoneNumber} (e.g. `'+17206620850'`).
      *
      * Firebase Auth requires E.164 format. If the value is not valid, {@link FirebaseServerAuthUserBadInputError}
      * is thrown with code `auth/invalid-phone-number`.
      */
-    readonly phone?: E164PhoneNumber;
+    readonly phone?: Maybe<E164PhoneNumber>;
     /**
      * Temporary setup password assigned during account creation.
      *
      * This is not the user's permanent password; it is replaced when the user completes setup.
      */
-    readonly setupPassword?: FirebaseAuthSetupPassword;
+    readonly setupPassword?: Maybe<FirebaseAuthSetupPassword>;
     /**
      * Whether or not to send a setup email. Is false by default.
      */
-    readonly sendSetupContent?: boolean;
+    readonly sendSetupContent?: Maybe<boolean>;
     /**
      * Whether or not to resend a setup email if the user already existed. Is false by default.
      */
-    readonly sendSetupContentIfUserExists?: boolean;
+    readonly sendSetupContentIfUserExists?: Maybe<boolean>;
     /**
      * If true, and the setup content has been sent before, it will not be sent again.
      */
-    readonly sendSetupDetailsOnce?: boolean;
+    readonly sendSetupDetailsOnce?: Maybe<boolean>;
     /**
      * If true, will ignore throttling when sending setup content.
      */
-    readonly sendSetupIgnoreThrottle?: boolean;
+    readonly sendSetupIgnoreThrottle?: Maybe<boolean>;
     /**
      * Whether or not to throw an error if sending setup content fails. Is false by default.
      */
-    readonly sendSetupThrowErrors?: boolean;
+    readonly sendSetupThrowErrors?: Maybe<boolean>;
     /**
      * Whether or not to force sending the test details.
      */
-    readonly sendDetailsInTestEnvironment?: boolean;
+    readonly sendDetailsInTestEnvironment?: Maybe<boolean>;
     /**
      * Any additional setup context
      */
-    readonly data?: D;
+    readonly data?: Maybe<D>;
 }
 /**
  * Result of creating a new Firebase Auth user, including the generated temporary setup password.
@@ -385,26 +385,26 @@ export interface FirebaseServerAuthNewUserSendSetupDetailsConfig<D = unknown> {
     /**
      * Whether or not to force sending the test details. Usage differs between providers.
      */
-    readonly sendDetailsInTestEnvironment?: boolean;
+    readonly sendDetailsInTestEnvironment?: Maybe<boolean>;
     /**
      * Whether or not to skip sending again if the setup content has already been sent once.
      */
-    readonly sendSetupDetailsOnce?: boolean;
+    readonly sendSetupDetailsOnce?: Maybe<boolean>;
     /**
      * Whether or not to force sending again even if the send is being throttled
      */
-    readonly ignoreSendThrottleTime?: boolean;
+    readonly ignoreSendThrottleTime?: Maybe<boolean>;
     /**
      * Whether or not to throw errors if the send fails, instead of returning false.
      *
      * @see FirebaseServerAuthNewUserSendSetupDetailsNoSetupConfigError
      * @see FirebaseServerAuthNewUserSendSetupDetailsThrottleError
      */
-    readonly throwErrors?: boolean;
+    readonly throwErrors?: Maybe<boolean>;
     /**
      * Any additional setup context
      */
-    readonly data?: D;
+    readonly data?: Maybe<D>;
 }
 /**
  * Details about a user that is in the setup phase, including their user context,

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

@@ -1,6 +1,6 @@
 import { type InjectionToken, type Provider } from '@nestjs/common';
 import { type ServerEnvironmentConfig } from '@dereekb/nestjs';
-import { type WebsiteUrlWithPrefix } from '@dereekb/util';
+import { type Maybe, type WebsiteUrlWithPrefix } from '@dereekb/util';
 /**
  * Extension of ServerEnvironmentConfig for Firebase server applications.
  *
@@ -8,6 +8,24 @@ import { type WebsiteUrlWithPrefix } from '@dereekb/util';
  */
 export interface FirebaseServerEnvironmentConfig extends ServerEnvironmentConfig {
     readonly appUrl: WebsiteUrlWithPrefix;
+    /**
+     * The API URL. When not set explicitly, `buildNestServerRootModule()` computes
+     * it from `appUrl + globalApiRoutePrefix`.
+     */
+    readonly appApiUrl?: Maybe<WebsiteUrlWithPrefix>;
+    /**
+     * The webhook URL. When not set explicitly, `buildNestServerRootModule()` computes
+     * it from `appUrl + /webhook`.
+     */
+    readonly appWebhookUrl?: Maybe<WebsiteUrlWithPrefix>;
+    /**
+     * Whether the API is enabled. Requires both `appUrl` and a configured `globalApiRoutePrefix`.
+     */
+    readonly isApiEnabled?: boolean;
+    /**
+     * Whether webhooks are enabled. Requires both `appUrl` and `configureWebhooks` being true.
+     */
+    readonly isWebhooksEnabled?: boolean;
 }
 /**
  * Token to access a configured FirebaseServerEnvironmentServiceConfig for the app.

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

@@ -1,4 +1,4 @@
-import { type Maybe, type WebsiteUrlDetails } from '@dereekb/util';
+import { type Maybe, type WebsiteUrl, type WebsiteUrlDetails } from '@dereekb/util';
 /**
  * Reference to a FirebaseServerEnvService
  */
@@ -41,4 +41,20 @@ export declare abstract class FirebaseServerEnvService {
      * Parsed URL details for the application URL.
      */
     abstract readonly appUrlDetails: Maybe<WebsiteUrlDetails>;
+    /**
+     * The full API URL (e.g., 'https://app.example.com/api').
+     */
+    abstract readonly appApiUrl: Maybe<WebsiteUrl>;
+    /**
+     * The full webhook URL (e.g., 'https://app.example.com/webhook').
+     */
+    abstract readonly appWebhookUrl: Maybe<WebsiteUrl>;
+    /**
+     * Whether the API is enabled (appUrl and globalApiRoutePrefix are both configured).
+     */
+    abstract readonly isApiEnabled: boolean;
+    /**
+     * Whether webhooks are enabled (appUrl is configured and webhooks are turned on).
+     */
+    abstract readonly isWebhooksEnabled: boolean;
 }

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

@@ -1,6 +1,6 @@
 import { ServerEnvironmentService } from '@dereekb/nestjs';
 import { type FirebaseServerEnvService } from '../../env/env.service';
-import { type Maybe, type WebsiteUrlDetails } from '@dereekb/util';
+import { type Maybe, type WebsiteUrl, type WebsiteUrlDetails } from '@dereekb/util';
 /**
  * Default NestJS injectable implementation of {@link FirebaseServerEnvService}.
  *
@@ -16,4 +16,7 @@ export declare class DefaultFirebaseServerEnvService extends ServerEnvironmentSe
      */
     get developmentSchedulerEnabled(): boolean;
     get appUrlDetails(): Maybe<WebsiteUrlDetails>;
+    get appWebhookUrl(): Maybe<WebsiteUrl>;
+    get isApiEnabled(): boolean;
+    get isWebhooksEnabled(): boolean;
 }

package/src/lib/nest/model/analytics.handler.d.ts

@@ -66,6 +66,13 @@ export declare abstract class OnCallModelAnalyticsService {
  * Apps provide this in their NestJS module to enable analytics in the onCall dispatch chain.
  */
 export declare const ON_CALL_MODEL_ANALYTICS_SERVICE: InjectionToken<OnCallModelAnalyticsService>;
+/**
+ * Creates a no-op {@link OnCallModelAnalyticsService} that silently discards all events.
+ *
+ * Used as the default fallback by {@link OnCallModelAnalyticsResolver} when no analytics
+ * service is registered.
+ */
+export declare function noopOnCallModelAnalyticsService(): OnCallModelAnalyticsService;
 /**
  * @deprecated Use {@link OnCallModelAnalyticsService} instead.
  */

package/src/lib/nest/model/analytics.resolver.d.ts

@@ -0,0 +1,42 @@
+import { ModuleRef } from '@nestjs/core';
+import { type Maybe } from '@dereekb/util';
+import { type OnCallModelAnalyticsService } from './analytics.handler';
+/**
+ * Globally-registered resolver for the optional {@link OnCallModelAnalyticsService}.
+ *
+ * Calling `app.get()` directly for an optional provider through the NestFactory proxy is unsafe:
+ * the proxy wraps every method call in `ExceptionsZone`, which invokes `process.exit(1)` when
+ * the provider is missing — **before** any surrounding `try/catch` can intercept the error.
+ *
+ * This resolver sidesteps the issue by using `@Optional() @Inject()` at construction time,
+ * which NestJS handles gracefully (injecting `undefined` when the token is absent).
+ * When no service is registered, a no-op fallback from {@link noopOnCallModelAnalyticsService}
+ * is used instead.
+ *
+ * For custom analytics tokens, it falls back to `ModuleRef.get()` which is not proxied
+ * and throws a normal catchable exception.
+ *
+ * Register this provider globally via {@link buildNestServerRootModule} so that
+ * `app.get(OnCallModelAnalyticsResolver)` always succeeds through the proxy.
+ *
+ * @example
+ * ```typescript
+ * // Inside onCallModel dispatch:
+ * const resolver = app.get(OnCallModelAnalyticsResolver);
+ * const analytics = resolver.getAnalyticsService();
+ * ```
+ */
+export declare class OnCallModelAnalyticsResolver {
+    private readonly moduleRef;
+    private readonly _service;
+    constructor(moduleRef: ModuleRef, service?: OnCallModelAnalyticsService);
+    /**
+     * Returns the analytics service for the given token, or the default
+     * {@link ON_CALL_MODEL_ANALYTICS_SERVICE} if no custom token is specified.
+     *
+     * @param token - Optional custom injection token override. When omitted or equal to
+     *   {@link ON_CALL_MODEL_ANALYTICS_SERVICE}, returns the constructor-injected service.
+     * @returns The resolved analytics service.
+     */
+    getAnalyticsService(token?: Maybe<string>): OnCallModelAnalyticsService;
+}

package/src/lib/nest/model/call.model.function.d.ts

@@ -27,6 +27,9 @@ export interface OnCallModelConfig {
     readonly preAssert?: AssertModelCrudRequestFunction<unknown, OnCallTypedModelParams>;
     /**
      * Override the analytics handler injection token.
+     *
+     * It should return an {@link OnCallModelAnalyticsService}.
+     *
      * Default: {@link ON_CALL_MODEL_ANALYTICS_SERVICE}
      */
     readonly analyticsToken?: string;

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

@@ -1,6 +1,7 @@
 export * from './analytics.details';
 export * from './analytics.emit';
 export * from './analytics.handler';
+export * from './analytics.resolver';
 export * from './api.details';
 export * from './permission.error';
 export * from './specifier.function';

package/test/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@dereekb/firebase-server/test",
-  "version": "13.5.2",
+  "version": "13.6.1",
   "peerDependencies": {
-    "@dereekb/analytics": "13.5.2",
-    "@dereekb/date": "13.5.2",
-    "@dereekb/firebase": "13.5.2",
-    "@dereekb/firebase-server": "13.5.2",
-    "@dereekb/model": "13.5.2",
-    "@dereekb/nestjs": "13.5.2",
-    "@dereekb/rxjs": "13.5.2",
-    "@dereekb/util": "13.5.2",
+    "@dereekb/analytics": "13.6.1",
+    "@dereekb/date": "13.6.1",
+    "@dereekb/firebase": "13.6.1",
+    "@dereekb/firebase-server": "13.6.1",
+    "@dereekb/model": "13.6.1",
+    "@dereekb/nestjs": "13.6.1",
+    "@dereekb/rxjs": "13.6.1",
+    "@dereekb/util": "13.6.1",
     "@google-cloud/firestore": "^7.11.6",
     "@google-cloud/storage": "^7.19.0",
     "@nestjs/common": "^11.1.17",
@@ -21,7 +21,7 @@
     "make-error": "^1.3.0"
   },
   "devDependencies": {
-    "@dereekb/nestjs": "13.5.2"
+    "@dereekb/nestjs": "13.6.1"
   },
   "exports": {
     "./package.json": "./package.json",

package/zoho/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@dereekb/firebase-server/zoho",
-  "version": "13.5.2",
+  "version": "13.6.1",
   "peerDependencies": {
-    "@dereekb/analytics": "13.5.2",
-    "@dereekb/date": "13.5.2",
-    "@dereekb/model": "13.5.2",
-    "@dereekb/nestjs": "13.5.2",
-    "@dereekb/rxjs": "13.5.2",
-    "@dereekb/firebase": "13.5.2",
-    "@dereekb/util": "13.5.2",
-    "@dereekb/zoho": "13.5.2"
+    "@dereekb/analytics": "13.6.1",
+    "@dereekb/date": "13.6.1",
+    "@dereekb/model": "13.6.1",
+    "@dereekb/nestjs": "13.6.1",
+    "@dereekb/rxjs": "13.6.1",
+    "@dereekb/firebase": "13.6.1",
+    "@dereekb/util": "13.6.1",
+    "@dereekb/zoho": "13.6.1"
   },
   "exports": {
     "./package.json": "./package.json",