@dereekb/firebase 13.10.0 → 13.10.2

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
@@ -7834,10 +7835,10 @@ var FIRESTORE_DUMMY_MODEL_KEY = 'dummymodel/dummykey';
 /**
  * Creates a root-level Firestore collection focused on a single document.
  *
- * This factory function creates a specialized collection that combines standard collection
- * functionality with convenient accessors for working with a single document. It's particularly
- * useful for application settings, configuration, or any singleton-like data structures
- * that are stored in Firestore.
+ * Backing factory for the `'root-singleton'` collection kind. Combines
+ * standard collection functionality with convenient accessors for working
+ * with a single document. Useful for application settings, configuration,
+ * or any singleton-like data structures that are stored in Firestore.
  *
  * @template T - The data type of the document
  * @template D - The FirestoreDocument type, defaults to FirestoreDocument<T>
@@ -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, '');
 }
 
 /**
@@ -17831,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)
                             ];
                     }
                 });

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
@@ -7832,10 +7833,10 @@ var FIRESTORE_DUMMY_MODEL_KEY = 'dummymodel/dummykey';
 /**
  * Creates a root-level Firestore collection focused on a single document.
  *
- * This factory function creates a specialized collection that combines standard collection
- * functionality with convenient accessors for working with a single document. It's particularly
- * useful for application settings, configuration, or any singleton-like data structures
- * that are stored in Firestore.
+ * Backing factory for the `'root-singleton'` collection kind. Combines
+ * standard collection functionality with convenient accessors for working
+ * with a single document. Useful for application settings, configuration,
+ * or any singleton-like data structures that are stored in Firestore.
  *
  * @template T - The data type of the document
  * @template D - The FirestoreDocument type, defaults to FirestoreDocument<T>
@@ -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, '');
 }
 
 /**
@@ -17829,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)
                             ];
                     }
                 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/firebase",
-  "version": "13.10.0",
+  "version": "13.10.2",
   "exports": {
     "./test": {
       "module": "./test/index.esm.js",
@@ -17,17 +17,17 @@
     }
   },
   "peerDependencies": {
-    "@dereekb/util": "13.10.0",
-    "@dereekb/date": "13.10.0",
-    "@dereekb/model": "13.10.0",
-    "@dereekb/rxjs": "13.10.0",
+    "@dereekb/util": "13.10.2",
+    "@dereekb/date": "13.10.2",
+    "@dereekb/model": "13.10.2",
+    "@dereekb/rxjs": "13.10.2",
     "@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/common/firestore/collection/collection.d.ts

@@ -596,6 +596,16 @@ export interface FirestoreCollectionConfig<T, D extends FirestoreDocument<T> = F
 /**
  * Full Firestore collection interface with document CRUD, querying, iteration, and context support.
  *
+ * Backs the `'root'` collection kind: a standard Firestore root collection.
+ * Created at runtime via `firestoreContext.firestoreCollection({...})` and
+ * typed at the model layer as
+ * `<Model>FirestoreCollection = FirestoreCollection<T, D>`.
+ *
+ * For other collection kinds, see:
+ * - `'root-singleton'` ({@link RootSingleItemFirestoreCollection} in `./collection.single`) — single doc in a root collection.
+ * - `'sub-collection'` ({@link FirestoreCollectionWithParent} in `./subcollection`) — multi-item subcollection under a parent.
+ * - `'singleton-sub'` ({@link SingleItemFirestoreCollection} in `./subcollection.single`) — one document per parent.
+ *
  * This is the primary interface used to interact with a Firestore collection. It provides:
  * - **Document access**: Create, load, and manage documents via {@link FirestoreDocumentAccessor}
  * - **Querying**: Build typed queries via the query factory

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

@@ -3,9 +3,11 @@ import { type FirestoreCollection, type FirestoreCollectionConfig } from './coll
 /**
  * Configuration for creating a root-level collection that focuses on a single document.
  *
- * This configuration extends the standard FirestoreCollectionConfig with optional
- * settings for specifying a single document identifier. This is used when you need
- * to work with a specific document in a collection, such as configuration or settings.
+ * Backs the `'root-singleton'` collection kind. This configuration extends
+ * the standard FirestoreCollectionConfig with optional settings for
+ * specifying a single document identifier — used when you need to work with
+ * a specific document in a root collection, such as application
+ * configuration or per-deploy settings.
  *
  * @template T - The data type of the document
  * @template D - The FirestoreDocument type, defaults to FirestoreDocument<T>
@@ -15,6 +17,15 @@ export interface RootSingleItemFirestoreCollectionConfig<T, D extends FirestoreD
 /**
  * A Firestore collection that provides specialized accessors for working with a single document.
  *
+ * Backs the `'root-singleton'` collection kind: a single document in a root
+ * collection, identified up-front by a fixed `singleItemIdentifier`. Created
+ * at runtime via `firestoreContext.rootSingleItemFirestoreCollection({...})`
+ * and typed at the model layer as
+ * `<Model>FirestoreCollection = RootSingleItemFirestoreCollection<T, D>`.
+ *
+ * For the parent-bound counterpart (one document per parent), see
+ * {@link SingleItemFirestoreCollection} (kind `'singleton-sub'`).
+ *
  * This interface combines the capabilities of a standard FirestoreCollection with
  * FirestoreSingleDocumentAccessor, providing convenient methods for working directly
  * with a single document without needing to specify its ID in each call.
@@ -27,10 +38,10 @@ export interface RootSingleItemFirestoreCollection<T, D extends FirestoreDocumen
 /**
  * Creates a root-level Firestore collection focused on a single document.
  *
- * This factory function creates a specialized collection that combines standard collection
- * functionality with convenient accessors for working with a single document. It's particularly
- * useful for application settings, configuration, or any singleton-like data structures
- * that are stored in Firestore.
+ * Backing factory for the `'root-singleton'` collection kind. Combines
+ * standard collection functionality with convenient accessors for working
+ * with a single document. Useful for application settings, configuration,
+ * or any singleton-like data structures that are stored in Firestore.
  *
  * @template T - The data type of the document
  * @template D - The FirestoreDocument type, defaults to FirestoreDocument<T>

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

@@ -5,6 +5,10 @@
  * within a specific document rather than at the root level. Subcollections enable hierarchical
  * data modeling in Firestore by allowing documents to contain their own collections.
  *
+ * Collection kind: `'sub-collection'` (multi-item subcollection under a parent).
+ * For the one-document-per-parent variant, see `'singleton-sub'`
+ * ({@link SingleItemFirestoreCollection} in `./subcollection.single`).
+ *
  * Key features of subcollections:
  * - They provide a natural way to model hierarchical relationships
  * - They establish clear ownership boundaries (parent document owns child documents)
@@ -42,6 +46,13 @@ export interface FirestoreCollectionWithParentConfig<T, PT, D extends FirestoreD
 /**
  * A FirestoreCollection that represents a subcollection with a reference to its parent document.
  *
+ * Backs the `'sub-collection'` collection kind: a multi-item subcollection
+ * under a parent. Created at runtime via `firestoreContext.firestoreCollectionWithParent({...})`
+ * and typed at the model layer as `<Model>FirestoreCollection = FirestoreCollectionWithParent<T, PT, D, PD>`.
+ *
+ * For one-document-per-parent subcollections, use {@link SingleItemFirestoreCollection}
+ * (kind `'singleton-sub'`) instead.
+ *
  * This interface extends FirestoreCollection to maintain the parent-child relationship
  * between documents. It allows access to documents within the context of their parent,
  * enabling proper path construction and maintaining the document hierarchy.

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

@@ -18,6 +18,13 @@ export interface SingleItemFirestoreCollectionConfig<T, PT, D extends FirestoreD
  * A subcollection that provides specialized accessors for working with a single document
  * within a parent document context.
  *
+ * Backs the `'singleton-sub'` collection kind: one document per parent.
+ * Created at runtime via `firestoreContext.singleItemFirestoreCollection({...})`
+ * and typed at the model layer as `<Model>FirestoreCollection = SingleItemFirestoreCollection<T, PT, D, PD>`.
+ *
+ * For multi-item subcollections under the same parent, use
+ * {@link FirestoreCollectionWithParent} (kind `'sub-collection'`) instead.
+ *
  * This interface combines the capabilities of FirestoreCollectionWithParent (which maintains
  * the parent-child relationship) with FirestoreSingleDocumentAccessor (which provides
  * convenient methods for working with a specific document). This allows for direct access

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.
  */

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

@@ -69,13 +69,13 @@ export interface UpdateOidcClientParams extends UpdateOidcClientFieldParams, Tar
 }
 export declare const updateOidcClientParamsType: Type<UpdateOidcClientParams>;
 export type RotateOidcClientSecretParams = TargetModelParams;
-export declare const rotateOidcClientSecretParamsType: Type<RotateOidcClientSecretParams>;
+export declare const rotateOidcClientSecretParamsType: import("arktype/internal/variants/object.ts").ObjectType<TargetModelParams, {}>;
 export type RotateOidcClientSecretResult = Pick<CreateOidcClientResult, 'client_id' | 'client_secret'>;
 /**
  * Parameters for revoking/deleting an OAuth client.
  */
 export type DeleteOidcClientParams = TargetModelParams;
-export declare const deleteOidcClientParamsType: Type<DeleteOidcClientParams>;
+export declare const deleteOidcClientParamsType: import("arktype/internal/variants/object.ts").ObjectType<TargetModelParams, {}>;
 /**
  * Custom (non-CRUD) function type map for OIDC.
  */

package/src/lib/model/oidcmodel/oidcmodel.d.ts

@@ -29,7 +29,7 @@ export declare const oidcEntryIdentity: import("../..").RootFirestoreModelIdenti
  *
  * Used as the discriminator in the {@link OidcEntry.type} field.
  */
-export type OidcEntryType = 'Session' | 'AccessToken' | 'AuthorizationCode' | 'RefreshToken' | 'DeviceCode' | 'ClientCredentials' | 'Client' | 'InitialAccessToken' | 'RegistrationAccessToken' | 'Interaction' | 'ReplayDetection' | 'PushedAuthorizationRequest' | 'Grant' | 'BackchannelAuthenticationRequest' | string;
+export type OidcEntryType = 'Session' | 'AccessToken' | 'AuthorizationCode' | 'RefreshToken' | 'DeviceCode' | 'ClientCredentials' | 'Client' | 'InitialAccessToken' | 'RegistrationAccessToken' | 'Interaction' | 'ReplayDetection' | 'PushedAuthorizationRequest' | 'Grant' | 'BackchannelAuthenticationRequest' | (string & {});
 /**
  * Type value for Client adapter entries.
  */

package/test/index.cjs.js

@@ -4882,6 +4882,7 @@ function _async_to_generator$3(fn) {
     };
 }
 function _instanceof(left, right) {
+    "@swc/helpers - instanceof";
     if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
         return !!right[Symbol.hasInstance](left);
     } else {

package/test/index.esm.js

@@ -4880,6 +4880,7 @@ function _async_to_generator$3(fn) {
     };
 }
 function _instanceof(left, right) {
+    "@swc/helpers - instanceof";
     if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
         return !!right[Symbol.hasInstance](left);
     } else {

package/test/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@dereekb/firebase/test",
-  "version": "13.10.0",
+  "version": "13.10.2",
   "peerDependencies": {
-    "@dereekb/date": "13.10.0",
-    "@dereekb/firebase": "13.10.0",
-    "@dereekb/model": "13.10.0",
-    "@dereekb/rxjs": "13.10.0",
-    "@dereekb/util": "13.10.0",
+    "@dereekb/date": "13.10.2",
+    "@dereekb/firebase": "13.10.2",
+    "@dereekb/model": "13.10.2",
+    "@dereekb/rxjs": "13.10.2",
+    "@dereekb/util": "13.10.2",
     "@firebase/rules-unit-testing": "5.0.0",
-    "date-fns": "^4.0.0",
-    "firebase": "^12.12.0",
-    "rxjs": "^7.8.0"
+    "date-fns": "^4.1.0",
+    "firebase": "^12.12.1",
+    "rxjs": "^7.8.2"
   },
   "exports": {
     "./package.json": "./package.json",