@dereekb/firebase 13.9.0 → 13.10.1

package/index.cjs.js

@@ -3362,7 +3362,7 @@ function optionalFirestoreField(config) {
                 };
             }
             fromData = function fromData(x) {
-                return transformFrom(x == null ? loadDefaultReadValueFn() : x);
+                return transformFrom(x !== null && x !== void 0 ? x : loadDefaultReadValueFn());
             };
         } else if (transformFrom !== util.passThrough) {
             fromData = function fromData(x) {
@@ -4080,7 +4080,9 @@ function firestoreUniqueNumberArray(config) {
         performFiltering = function performFiltering(x) {
             var result = filterUnique(x);
             if (filterFn) {
-                result = result.filter(filterFn);
+                result = result.filter(function(v, i) {
+                    return filterFn(v, i);
+                });
             }
             return result;
         };
@@ -4294,10 +4296,9 @@ var assignDateCellRangeFunction = util.assignValuesToPOJOFunction({
     valueFilter: util.KeyValueTypleValueFilter.NULL
 });
 var firestoreDateCellRangeAssignFn = function firestoreDateCellRangeAssignFn(input) {
+    var _block, _to;
     var block = assignDateCellRangeFunction(DEFAULT_DATE_CELL_RANGE_VALUE, input);
-    if (block.to == null) {
-        block.to = block.i;
-    }
+    (_to = (_block = block).to) !== null && _to !== void 0 ? _to : _block.to = block.i;
     return block;
 };
 /**
@@ -7428,7 +7429,7 @@ function firestoreModelIdentity(parentOrModelName, collectionNameOrModelName, in
  * @param key
  * @returns
  */ function flatFirestoreModelKey(key) {
-    return key.replace(/\//g, '');
+    return key.replaceAll('/', '');
 }
 /**
  * Creates a TwoWayFlatFirestoreModelKey from the input FirestoreModelKey.
@@ -7436,7 +7437,7 @@ function firestoreModelIdentity(parentOrModelName, collectionNameOrModelName, in
  * @param key
  * @returns
  */ function twoWayFlatFirestoreModelKey(key) {
-    return key.replace(/\//g, '_');
+    return key.replaceAll('/', '_');
 }
 /**
  * Creates a TwoWayFlatFirestoreModelKey from the input FirestoreModelKey.
@@ -7444,7 +7445,7 @@ function firestoreModelIdentity(parentOrModelName, collectionNameOrModelName, in
  * @param key
  * @returns
  */ function inferKeyFromTwoWayFlatFirestoreModelKey(key) {
-    return key.replace(/_/g, FIRESTORE_COLLECTION_NAME_SEPARATOR);
+    return key.replaceAll('_', FIRESTORE_COLLECTION_NAME_SEPARATOR);
 }
 /**
  * Firestore Model Id Regex
@@ -7967,7 +7968,7 @@ function _object_spread_props$e(target, source) {
  * // id === 'userAAAexamplecom'
  * ```
  */ function firestoreModelIdFromEmail(emailAddress) {
-    return emailAddress.replace('@', 'AAA').replace(/[^a-zA-Z0-9]/g, '');
+    return emailAddress.replace('@', 'AAA').replaceAll(/[^a-zA-Z0-9]/g, '');
 }
 
 /**
@@ -13682,6 +13683,8 @@ function _is_native_reflect_construct$3() {
  * Used by both client and server code to access notification documents.
  *
  * @see `NotificationServerActions` in `@dereekb/firebase-server/model` for server-side action processing
+ *
+ * @dbxModelGroup Notification
  */ var NotificationFirestoreCollections = function NotificationFirestoreCollections() {
     _class_call_check$7(this, NotificationFirestoreCollections);
 };
@@ -16207,6 +16210,8 @@ function _is_native_reflect_construct$2() {
  * Used by both client and server code to access oidc model documents.
  *
  * @see `OidcModelServerActions` in `@dereekb/firebase-server/oidc` for server-side action processing
+ *
+ * @dbxModelGroup OidcModel
  */ var OidcModelFirestoreCollections = function OidcModelFirestoreCollections() {
     _class_call_check$4(this, OidcModelFirestoreCollections);
 };
@@ -16668,6 +16673,8 @@ function _is_native_reflect_construct$1() {
  * Abstract base providing access to StorageFile and StorageFileGroup Firestore collections.
  *
  * Implement this in your app module to wire up the collections for dependency injection.
+ *
+ * @dbxModelGroup StorageFile
  */ var StorageFileFirestoreCollections = function StorageFileFirestoreCollections() {
     _class_call_check$1(this, StorageFileFirestoreCollections);
 };
@@ -17825,7 +17832,7 @@ function _ts_generator$1(thisArg, body) {
                             ]), a = _ref[0], b = _ref[1];
                             return [
                                 2,
-                                _object_spread$2({}, a !== null && a !== void 0 ? a : {}, b !== null && b !== void 0 ? b : {})
+                                _object_spread$2({}, a, b)
                             ];
                     }
                 });
@@ -18798,6 +18805,8 @@ function _is_native_reflect_construct() {
  * Abstract base providing access to the SystemState Firestore collection.
  *
  * Implement this in your app module to wire up dependency injection.
+ *
+ * @dbxModelGroup SystemState
  */ var SystemStateFirestoreCollections = function SystemStateFirestoreCollections() {
     _class_call_check(this, SystemStateFirestoreCollections);
 };

package/index.esm.js

@@ -3360,7 +3360,7 @@ function optionalFirestoreField(config) {
                 };
             }
             fromData = function fromData(x) {
-                return transformFrom(x == null ? loadDefaultReadValueFn() : x);
+                return transformFrom(x !== null && x !== void 0 ? x : loadDefaultReadValueFn());
             };
         } else if (transformFrom !== passThrough) {
             fromData = function fromData(x) {
@@ -4078,7 +4078,9 @@ function firestoreUniqueNumberArray(config) {
         performFiltering = function performFiltering(x) {
             var result = filterUnique(x);
             if (filterFn) {
-                result = result.filter(filterFn);
+                result = result.filter(function(v, i) {
+                    return filterFn(v, i);
+                });
             }
             return result;
         };
@@ -4292,10 +4294,9 @@ var assignDateCellRangeFunction = assignValuesToPOJOFunction({
     valueFilter: KeyValueTypleValueFilter.NULL
 });
 var firestoreDateCellRangeAssignFn = function firestoreDateCellRangeAssignFn(input) {
+    var _block, _to;
     var block = assignDateCellRangeFunction(DEFAULT_DATE_CELL_RANGE_VALUE, input);
-    if (block.to == null) {
-        block.to = block.i;
-    }
+    (_to = (_block = block).to) !== null && _to !== void 0 ? _to : _block.to = block.i;
     return block;
 };
 /**
@@ -7426,7 +7427,7 @@ function firestoreModelIdentity(parentOrModelName, collectionNameOrModelName, in
  * @param key
  * @returns
  */ function flatFirestoreModelKey(key) {
-    return key.replace(/\//g, '');
+    return key.replaceAll('/', '');
 }
 /**
  * Creates a TwoWayFlatFirestoreModelKey from the input FirestoreModelKey.
@@ -7434,7 +7435,7 @@ function firestoreModelIdentity(parentOrModelName, collectionNameOrModelName, in
  * @param key
  * @returns
  */ function twoWayFlatFirestoreModelKey(key) {
-    return key.replace(/\//g, '_');
+    return key.replaceAll('/', '_');
 }
 /**
  * Creates a TwoWayFlatFirestoreModelKey from the input FirestoreModelKey.
@@ -7442,7 +7443,7 @@ function firestoreModelIdentity(parentOrModelName, collectionNameOrModelName, in
  * @param key
  * @returns
  */ function inferKeyFromTwoWayFlatFirestoreModelKey(key) {
-    return key.replace(/_/g, FIRESTORE_COLLECTION_NAME_SEPARATOR);
+    return key.replaceAll('_', FIRESTORE_COLLECTION_NAME_SEPARATOR);
 }
 /**
  * Firestore Model Id Regex
@@ -7965,7 +7966,7 @@ function _object_spread_props$e(target, source) {
  * // id === 'userAAAexamplecom'
  * ```
  */ function firestoreModelIdFromEmail(emailAddress) {
-    return emailAddress.replace('@', 'AAA').replace(/[^a-zA-Z0-9]/g, '');
+    return emailAddress.replace('@', 'AAA').replaceAll(/[^a-zA-Z0-9]/g, '');
 }
 
 /**
@@ -13680,6 +13681,8 @@ function _is_native_reflect_construct$3() {
  * Used by both client and server code to access notification documents.
  *
  * @see `NotificationServerActions` in `@dereekb/firebase-server/model` for server-side action processing
+ *
+ * @dbxModelGroup Notification
  */ var NotificationFirestoreCollections = function NotificationFirestoreCollections() {
     _class_call_check$7(this, NotificationFirestoreCollections);
 };
@@ -16205,6 +16208,8 @@ function _is_native_reflect_construct$2() {
  * Used by both client and server code to access oidc model documents.
  *
  * @see `OidcModelServerActions` in `@dereekb/firebase-server/oidc` for server-side action processing
+ *
+ * @dbxModelGroup OidcModel
  */ var OidcModelFirestoreCollections = function OidcModelFirestoreCollections() {
     _class_call_check$4(this, OidcModelFirestoreCollections);
 };
@@ -16666,6 +16671,8 @@ function _is_native_reflect_construct$1() {
  * Abstract base providing access to StorageFile and StorageFileGroup Firestore collections.
  *
  * Implement this in your app module to wire up the collections for dependency injection.
+ *
+ * @dbxModelGroup StorageFile
  */ var StorageFileFirestoreCollections = function StorageFileFirestoreCollections() {
     _class_call_check$1(this, StorageFileFirestoreCollections);
 };
@@ -17823,7 +17830,7 @@ function _ts_generator$1(thisArg, body) {
                             ]), a = _ref[0], b = _ref[1];
                             return [
                                 2,
-                                _object_spread$2({}, a !== null && a !== void 0 ? a : {}, b !== null && b !== void 0 ? b : {})
+                                _object_spread$2({}, a, b)
                             ];
                     }
                 });
@@ -18796,6 +18803,8 @@ function _is_native_reflect_construct() {
  * Abstract base providing access to the SystemState Firestore collection.
  *
  * Implement this in your app module to wire up dependency injection.
+ *
+ * @dbxModelGroup SystemState
  */ var SystemStateFirestoreCollections = function SystemStateFirestoreCollections() {
     _class_call_check(this, SystemStateFirestoreCollections);
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/firebase",
-  "version": "13.9.0",
+  "version": "13.10.1",
   "exports": {
     "./test": {
       "module": "./test/index.esm.js",
@@ -17,17 +17,17 @@
     }
   },
   "peerDependencies": {
-    "@dereekb/util": "13.9.0",
-    "@dereekb/date": "13.9.0",
-    "@dereekb/model": "13.9.0",
-    "@dereekb/rxjs": "13.9.0",
+    "@dereekb/util": "13.10.1",
+    "@dereekb/date": "13.10.1",
+    "@dereekb/model": "13.10.1",
+    "@dereekb/rxjs": "13.10.1",
     "@firebase/rules-unit-testing": "5.0.0",
     "arktype": "^2.2.0",
-    "date-fns": "^4.0.0",
-    "firebase": "^12.12.0",
-    "make-error": "^1.3.0",
-    "rxjs": "^7.8.0",
-    "ts-essentials": "^10.0.0"
+    "date-fns": "^4.1.0",
+    "firebase": "^12.12.1",
+    "make-error": "^1.3.6",
+    "rxjs": "^7.8.2",
+    "ts-essentials": "^10.2.0"
   },
   "module": "./index.esm.js",
   "main": "./index.cjs.js",

package/src/lib/client/function/function.d.ts

@@ -1,5 +1,10 @@
 /**
  * Key that corresponds with a function on the server.
+ *
+ * @semanticType
+ * @semanticTopic identifier
+ * @semanticTopic string
+ * @semanticTopic dereekb-firebase:functions
  */
 export type FirebaseFunctionKey = string;
 /**

package/src/lib/client/function/function.factory.d.ts

@@ -43,6 +43,11 @@ export type FirebaseFunctionMapFactory<M extends FirebaseFunctionTypeMap> = (fun
 export declare function firebaseFunctionMapFactory<M extends FirebaseFunctionTypeMap>(configMap: FirebaseFunctionTypeConfigMap<M>): FirebaseFunctionMapFactory<M>;
 /**
  * String key used to identify a function group in the app-level functions map.
+ *
+ * @semanticType
+ * @semanticTopic identifier
+ * @semanticTopic string
+ * @semanticTopic dereekb-firebase:functions
  */
 export type FirebaseFunctionMapKey = string;
 /**

package/src/lib/client/function/model.function.factory.d.ts

@@ -9,6 +9,11 @@ import { type OnCallCreateModelResult } from '../../common/model/function';
  * String identifier that routes a CRUD request to a specific sub-handler within a model's
  * CRUD function. For example, a model's `update` might have specifiers like `'status'` or `'config'`
  * to target different update behaviors.
+ *
+ * @semanticType
+ * @semanticTopic identifier
+ * @semanticTopic string
+ * @semanticTopic dereekb-firebase:functions
  */
 export type ModelFirebaseCrudFunctionSpecifier = string;
 /**

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

@@ -13,6 +13,11 @@ export declare const FIREBASE_AUTH_PASSWORD_MIN_LENGTH = 6;
 export declare const FIREBASE_AUTH_PASSWORD_MAX_LENGTH = 128;
 /**
  * Unique identifier for a Firebase Authentication user (the `uid` from Firebase Auth).
+ *
+ * @semanticType
+ * @semanticTopic identifier
+ * @semanticTopic string
+ * @semanticTopic dereekb-firebase:auth
  */
 export type FirebaseAuthUserId = string;
 /**
@@ -25,6 +30,10 @@ export interface FirebaseAuthUserIdRef {
  * Raw encoded JWT for Firebase Auth.
  *
  * Corresponds with IdToken type in Firebase Auth.
+ *
+ * @semanticType
+ * @semanticTopic string
+ * @semanticTopic dereekb-firebase:auth
  */
 export type FirebaseAuthIdToken = string;
 /**
@@ -65,6 +74,11 @@ export interface FirebaseAuthDetails extends FirebaseAuthToken, Readonly<Firebas
  * A string key used to test for ownership of a particular set of objects.
  *
  * For instance, a database model (or its parent) may have an ownership key associated with it that is compared with the user's current claims.
+ *
+ * @semanticType
+ * @semanticTopic identifier
+ * @semanticTopic string
+ * @semanticTopic dereekb-firebase:auth
  */
 export type FirebaseAuthOwnershipKey = string;
 /**

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

@@ -2,6 +2,11 @@
  * Identifies a specific development function endpoint to route requests to.
  *
  * Used in dev/test environments to invoke specific server-side functions by name.
+ *
+ * @semanticType
+ * @semanticTopic identifier
+ * @semanticTopic string
+ * @semanticTopic dereekb-firebase:functions
  */
 export type DevelopmentFirebaseFunctionSpecifier = string;
 /**

package/src/lib/common/firestore/accessor/document.d.ts

@@ -405,6 +405,14 @@ export declare function firestoreSingleDocumentAccessor<T, D extends FirestoreDo
  * Default document ID used for single-document collections. The document is stored at path `<collection>/0`.
  */
 export declare const DEFAULT_SINGLE_ITEM_FIRESTORE_COLLECTION_DOCUMENT_IDENTIFIER = "0";
+/**
+ * Document ID used for the single document in a single-item Firestore collection.
+ *
+ * @semanticType
+ * @semanticTopic identifier
+ * @semanticTopic string
+ * @semanticTopic dereekb-firebase:firestore
+ */
 export type SingleItemFirestoreCollectionDocumentIdentifier = string;
 export interface SingleItemFirestoreCollectionDocumentIdentifierRef {
     /**

package/src/lib/common/firestore/collection/collection.d.ts

@@ -26,6 +26,11 @@ export type FirestoreModelType = ModelTypeString;
  * with the same name to be returned regardless of their location in the document hierarchy.
  *
  * @example 'u', 'ps', 'or'
+ *
+ * @semanticType
+ * @semanticTopic identifier
+ * @semanticTopic string
+ * @semanticTopic dereekb-firebase:firestore
  */
 export type FirestoreCollectionName = string;
 /**
@@ -218,6 +223,11 @@ export interface FirestoreModelIdentityRef<I extends FirestoreModelIdentity = Fi
  * Example:
  *
  * 12345
+ *
+ * @semanticType
+ * @semanticTopic identifier
+ * @semanticTopic string
+ * @semanticTopic dereekb-firebase:firestore
  */
 export type FirestoreModelId = string;
 /**
@@ -431,6 +441,11 @@ export declare function firestoreModelKeyPairObject(input: FirestoreModelKey | D
  * String that is composed of the FirestoreCollectionNames derived from an input FirestoreModelKey and joined together via a separator.
  *
  * Is equivalent to a FirestoreCollectionType if the FIRESTORE_COLLECTION_NAME_SEPARATOR is used as the separator.
+ *
+ * @semanticType
+ * @semanticTopic identifier
+ * @semanticTopic string
+ * @semanticTopic dereekb-firebase:firestore
  */
 export type FirestoreModelCollectionTypeArrayName = string;
 /**

package/src/lib/common/firestore/driver/driver.d.ts

@@ -2,6 +2,11 @@ import { type FirestoreAccessorDriverRef } from './accessor';
 import { type FirestoreQueryDriverRef } from './query';
 /**
  * Optional human-readable identifier for the Firestore driver (e.g., 'firebase-admin', 'firebase-web', 'testing').
+ *
+ * @semanticType
+ * @semanticTopic identifier
+ * @semanticTopic string
+ * @semanticTopic dereekb-firebase:firestore
  */
 export type FirestoreDriverIdentifier = string;
 /**

package/src/lib/common/firestore/query/constraint.d.ts

@@ -5,6 +5,11 @@ import { type ArrayOrValue, type SeparateResult, type SortingOrder, type Maybe,
  *
  * Used to uniquely identify different types of query constraints, such as
  * where, limit, orderBy, etc.
+ *
+ * @semanticType
+ * @semanticTopic identifier
+ * @semanticTopic string
+ * @semanticTopic dereekb-firebase:firestore
  */
 export type FirestoreQueryConstraintType = string;
 /**

package/src/lib/common/storage/driver/accessor.d.ts

@@ -146,6 +146,11 @@ export interface StorageGetAclsResult {
 }
 /**
  * String used as a cursor for iterating pages of file results.
+ *
+ * @semanticType
+ * @semanticTopic identifier
+ * @semanticTopic string
+ * @semanticTopic dereekb-firebase:storage
  */
 export type StorageListFilesPageToken = string;
 export interface StorageListFilesOptions {
@@ -192,6 +197,14 @@ export interface StorageListFileResult extends StorageListItemResult {
      */
     file(): FirebaseStorageAccessorFile;
 }
+/**
+ * Token returned with a list-files result for resuming pagination on the next call.
+ *
+ * @semanticType
+ * @semanticTopic identifier
+ * @semanticTopic string
+ * @semanticTopic dereekb-firebase:storage
+ */
 export type StorageListFileResultNextPageToken = string;
 export interface StorageListFilesResult<R = unknown> {
     /**

package/src/lib/common/storage/driver/driver.d.ts

@@ -1,6 +1,11 @@
 import { type FirebaseStorageAccessorDriverRef } from './accessor';
 /**
  * Unique identifier string for a storage driver implementation.
+ *
+ * @semanticType
+ * @semanticTopic identifier
+ * @semanticTopic string
+ * @semanticTopic dereekb-firebase:storage
  */
 export type FirebaseStorageDriverIdentifier = string;
 /**

package/src/lib/common/storage/storage.d.ts

@@ -3,6 +3,11 @@ import { type SlashPath, type FactoryWithRequiredInput } from '@dereekb/util';
  * Storage bucket identifier for Firebase Cloud Storage.
  *
  * Should contain no slashes — just the bucket name (e.g., `"my-app.appspot.com"`).
+ *
+ * @semanticType
+ * @semanticTopic identifier
+ * @semanticTopic string
+ * @semanticTopic dereekb-firebase:storage
  */
 export type StorageBucketId = string;
 /**

package/src/lib/common/storage/types.d.ts

@@ -31,10 +31,20 @@ export type GoogleCloudLikeStorage = {
 export type FirebaseStorage = FirebaseStorageLikeStorage | GoogleCloudLikeStorage;
 /**
  * The public storage url link.
+ *
+ * @semanticType
+ * @semanticTopic url
+ * @semanticTopic string
+ * @semanticTopic dereekb-firebase:storage
  */
 export type StorageDownloadUrl = string;
 /**
  * A signed download link.
+ *
+ * @semanticType
+ * @semanticTopic url
+ * @semanticTopic string
+ * @semanticTopic dereekb-firebase:storage
  */
 export type StorageSignedDownloadUrl = string;
 /**
@@ -79,6 +89,10 @@ export interface StorageSignedDownloadUrlConfig {
 /**
  * Example:
  * 'Hello! \\ud83d\\ude0a';
+ *
+ * @semanticType
+ * @semanticTopic string
+ * @semanticTopic dereekb-firebase:storage
  */
 export type StorageRawDataString = string;
 /**
@@ -92,6 +106,11 @@ export type StorageRawDataStringType = 'raw';
 /**
  * Example:
  * '5b6p5Y+344GX44G+44GX44Gf77yB44GK44KB44Gn44Go44GG77yB';
+ *
+ * @semanticType
+ * @semanticTopic string
+ * @semanticTopic dereekb-firebase:storage
+ * @semanticTopic dereekb-firebase:encoding
  */
 export type StorageBase64DataString = string;
 /**
@@ -104,6 +123,11 @@ export type StorageBase64DataStringType = 'base64';
 /**
  * Example:
  * '5b6p5Y-344GX44G-44GX44Gf77yB44GK44KB44Gn44Go44GG77yB';
+ *
+ * @semanticType
+ * @semanticTopic string
+ * @semanticTopic dereekb-firebase:storage
+ * @semanticTopic dereekb-firebase:encoding
  */
 export type StorageBase64UrlDataString = string;
 /**
@@ -116,6 +140,11 @@ export type StorageBase64UrlDataStringType = 'base64url';
 /**
  * Example:
  * 'data:text/plain;base64,5b6p5Y+344GX44G+44GX44Gf77yB44GK44KB44Gn44Go44GG77yB'
+ *
+ * @semanticType
+ * @semanticTopic url
+ * @semanticTopic string
+ * @semanticTopic dereekb-firebase:storage
  */
 export type StorageDataUrlString = string;
 /**

package/src/lib/model/notification/notification.api.d.ts

@@ -91,7 +91,7 @@ export interface UpdateNotificationUserParams extends TargetModelParams {
 }
 export declare const updateNotificationUserParamsType: Type<UpdateNotificationUserParams>;
 export type ResyncNotificationUserParams = TargetModelParams;
-export declare const resyncNotificationUserParamsType: Type<ResyncNotificationUserParams>;
+export declare const resyncNotificationUserParamsType: import("arktype/internal/variants/object.ts").ObjectType<TargetModelParams, {}>;
 export interface ResyncNotificationUserResult {
     readonly notificationBoxesUpdated: number;
 }
@@ -156,7 +156,7 @@ export interface InitializeAllApplicableNotificationSummariesResult {
  * Used for updating the NotificationBox.
  */
 export type UpdateNotificationBoxParams = TargetModelParams;
-export declare const updateNotificationBoxParamsType: Type<UpdateNotificationBoxParams>;
+export declare const updateNotificationBoxParamsType: import("arktype/internal/variants/object.ts").ObjectType<TargetModelParams, {}>;
 /**
  * Used to create/update a notification box recipient.
  */