@dereekb/firebase-server 13.6.9 → 13.6.11

package/src/lib/nest/app.module.d.ts

@@ -4,6 +4,31 @@ import { type StorageBucketId } from '@dereekb/firebase';
 import { type FirebaseServerEnvironmentConfig } from '../env/env.config';
 import { GlobalRoutePrefixConfig } from './middleware/globalprefix';
 import type * as admin from 'firebase-admin';
+import { AssetLoader } from '@dereekb/rxjs';
+/**
+ * Default base path for local assets on the server filesystem.
+ */
+export declare const DEFAULT_SERVER_ASSETS_BASE_PATH = "./assets";
+/**
+ * Configuration for the server-side asset loader.
+ *
+ * By default, local assets are loaded from {@link DEFAULT_SERVER_ASSETS_BASE_PATH}
+ * via `nodeJsLocalAssetLoader` and remote assets are loaded via `fetchAssetLoader`.
+ *
+ * Override `local` or `remote` to supply custom loader implementations.
+ */
+export interface NestServerAssetConfig {
+    /**
+     * Optional override for the local asset loader.
+     * If omitted, uses `nodeJsLocalAssetLoader` with basePath {@link DEFAULT_SERVER_ASSETS_BASE_PATH}.
+     */
+    readonly local?: AssetLoader;
+    /**
+     * Optional override for the remote asset loader.
+     * If omitted, uses `fetchAssetLoader` with default global fetch.
+     */
+    readonly remote?: AssetLoader;
+}
 export declare class FirebaseNestServerRootModule {
 }
 /**
@@ -57,6 +82,14 @@ export interface NestServerRootModuleConfig {
      * Defaults to false (production code sets this to true via `appCheckEnabled`).
      */
     readonly appCheckEnabled?: boolean;
+    /**
+     * Optional asset loader configuration.
+     *
+     * When provided, configures the {@link AssetLoader} with the given local base path
+     * and optional remote fetch config. When omitted, the {@link AssetLoader} is still
+     * provided globally with default settings (local base path `'./assets'`).
+     */
+    readonly assets?: Maybe<NestServerAssetConfig>;
 }
 /**
  * Result of {@link buildNestServerRootModule}.

package/src/lib/nest/nest.provider.d.ts

@@ -89,6 +89,31 @@ export declare abstract class AbstractFirebaseNestContext<A, Y extends FirebaseM
     model(context: AuthDataRef, buildFn?: BuildFunction<FirebaseAppModelContext<A>>): InContextFirebaseModelsService<Y>;
     useModel<T extends FirebaseModelsServiceTypes<Y>, O>(type: T, select: UseModelInput<FirebaseAppModelContext<A>, Y, T, O>): Promise<O>;
     useModel<T extends FirebaseModelsServiceTypes<Y>>(type: T, select: UseModelInputForRolesReader<FirebaseAppModelContext<A>, Y, T>): Promise<FirebaseModelsServiceSelectionResultRolesReader<Y, T>>;
+    /**
+     * Loads and checks permissions for multiple models of the same type in parallel.
+     *
+     * Uses {@link performAsyncTasks} internally. The `use` function receives the array of
+     * successful {@link ContextGrantedModelRolesReader} values and an array of failed items.
+     *
+     * @param type - the model type to load
+     * @param select - selection params including keys array, roles, and use function
+     * @returns the result of the use function
+     *
+     * @example
+     * ```ts
+     * const result = await nest.useMultipleModels('storageFile', {
+     *   request,
+     *   keys: ['storageFile/abc', 'storageFile/def'],
+     *   roles: 'download',
+     *   throwOnFirstError: false,
+     *   use: (successful, failed) => ({
+     *     documents: successful.map((r) => r.document),
+     *     errors: failed
+     *   })
+     * });
+     * ```
+     */
+    useMultipleModels<T extends FirebaseModelsServiceTypes<Y>, O>(type: T, select: UseMultipleModelsInput<FirebaseAppModelContext<A>, Y, T, O>): Promise<O>;
 }
 /**
  * Input for {@link AbstractFirebaseNestContext.useModel} when only a roles reader is needed (no custom use function).
@@ -103,3 +128,60 @@ export type UseModelInputForRolesReader<C extends FirebaseModelServiceContext, Y
 export type UseModelInput<C extends FirebaseModelServiceContext, Y extends FirebaseModelsService<any, C>, T extends FirebaseModelsServiceTypes<Y>, O> = UseModelInputForRolesReader<C, Y, T> & {
     readonly use: UseFirebaseModelsServiceSelectionUseFunction<Y, T, O>;
 };
+/**
+ * Extracts the key type from a {@link UseFirebaseModelsServiceSelection} for a given model type.
+ */
+export type UseFirebaseModelsServiceSelectionKeyType<Y extends FirebaseModelsService<any, any>, T extends FirebaseModelsServiceTypes<Y>> = UseFirebaseModelsServiceSelection<Y, T> extends {
+    key: infer K;
+} ? K : never;
+/**
+ * Input for {@link AbstractFirebaseNestContext.useMultipleModels}.
+ *
+ * Takes an array of keys and a `use` function that receives the successful roles readers
+ * and a {@link UseMultipleModelsFailure} describing any errors. Shared `roles` and `rolesSetIncludes` apply to all keys.
+ */
+export type UseMultipleModelsInput<C extends FirebaseModelServiceContext, Y extends FirebaseModelsService<any, C>, T extends FirebaseModelsServiceTypes<Y>, O> = Omit<UseModelInputForRolesReader<C, Y, T>, 'key'> & {
+    readonly keys: UseFirebaseModelsServiceSelectionKeyType<Y, T>[];
+    readonly use: UseMultipleModelsUseFunction<Y, T, O>;
+    /**
+     * When true, throws the first error directly without calling `use`.
+     *
+     * Defaults to true (unless `useOnFirstError` is set).
+     */
+    readonly throwOnFirstError?: boolean;
+    /**
+     * When true, calls `use` on the first error with an empty successful array
+     * and `abortedEarly: true` in the failure object.
+     *
+     * Takes precedence over `throwOnFirstError` when both are set.
+     */
+    readonly useOnFirstError?: boolean;
+};
+/**
+ * Use function for {@link UseMultipleModelsInput}.
+ *
+ * Receives the successful roles readers and a failure object containing any errors.
+ */
+export type UseMultipleModelsUseFunction<Y extends FirebaseModelsService<any, any>, T extends FirebaseModelsServiceTypes<Y>, O> = (successful: FirebaseModelsServiceSelectionResultRolesReader<Y, T>[], failure: UseMultipleModelsFailure<Y, T>) => Promise<O> | O;
+/**
+ * Failure information passed to the {@link UseMultipleModelsUseFunction}.
+ *
+ * Contains the array of failed items and whether the operation was aborted early
+ * (via `useOnFirstError`) before all keys were processed.
+ */
+export interface UseMultipleModelsFailure<Y extends FirebaseModelsService<any, any>, T extends FirebaseModelsServiceTypes<Y>> {
+    readonly errors: UseMultipleModelsFailedItem<Y, T>[];
+    /**
+     * True when the operation was aborted on the first error (via `useOnFirstError`).
+     *
+     * When true, the successful array will be empty and not all keys may have been attempted.
+     */
+    readonly abortedEarly: boolean;
+}
+/**
+ * Represents a key that failed permission checking in {@link AbstractFirebaseNestContext.useMultipleModels}.
+ */
+export interface UseMultipleModelsFailedItem<Y extends FirebaseModelsService<any, any>, T extends FirebaseModelsServiceTypes<Y>> {
+    readonly key: UseFirebaseModelsServiceSelectionKeyType<Y, T>;
+    readonly error: unknown;
+}

package/test/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@dereekb/firebase-server/test",
-  "version": "13.6.9",
+  "version": "13.6.11",
   "peerDependencies": {
-    "@dereekb/analytics": "13.6.9",
-    "@dereekb/date": "13.6.9",
-    "@dereekb/firebase": "13.6.9",
-    "@dereekb/firebase-server": "13.6.9",
-    "@dereekb/model": "13.6.9",
-    "@dereekb/nestjs": "13.6.9",
-    "@dereekb/rxjs": "13.6.9",
-    "@dereekb/util": "13.6.9",
+    "@dereekb/analytics": "13.6.11",
+    "@dereekb/date": "13.6.11",
+    "@dereekb/firebase": "13.6.11",
+    "@dereekb/firebase-server": "13.6.11",
+    "@dereekb/model": "13.6.11",
+    "@dereekb/nestjs": "13.6.11",
+    "@dereekb/rxjs": "13.6.11",
+    "@dereekb/util": "13.6.11",
     "@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.6.9"
+    "@dereekb/nestjs": "13.6.11"
   },
   "exports": {
     "./package.json": "./package.json",

package/zoho/package.json

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