firebase-admin-edge 3.0.1 → 3.1.0

package/dist/remote-config/remote-config-template.js

@@ -0,0 +1,129 @@
+import { invalidRemoteConfig, isRemoteConfigObject } from './remote-config-results.js';
+/** @internal Validate and normalize version metadata without losing int64 precision. */
+export function normalizeVersion(input) {
+    if (!isRemoteConfigObject(input)) {
+        invalidRemoteConfig('Version must be an object.');
+    }
+    const version = { ...input };
+    for (const key of ['versionNumber', 'rollbackSource']) {
+        if (version[key] !== undefined) {
+            version[key] = validateVersionNumber(version[key]);
+        }
+    }
+    if (version.updateTime !== undefined) {
+        if (typeof version.updateTime !== 'string' ||
+            !version.updateTime.trim()) {
+            invalidRemoteConfig('Invalid version update time.');
+        }
+        const date = new Date(version.updateTime);
+        if (!Number.isFinite(date.getTime())) {
+            invalidRemoteConfig('Invalid version update time.');
+        }
+        version.updateTime = date.toUTCString();
+    }
+    if (version.updateUser !== undefined &&
+        !isRemoteConfigObject(version.updateUser)) {
+        invalidRemoteConfig('Version updateUser must be an object.');
+    }
+    if (version.isLegacy !== undefined &&
+        typeof version.isLegacy !== 'boolean') {
+        invalidRemoteConfig('Version isLegacy must be a boolean.');
+    }
+    for (const key of ['description', 'updateOrigin', 'updateType']) {
+        if (version[key] !== undefined && typeof version[key] !== 'string') {
+            invalidRemoteConfig(`Version ${key} must be a string.`);
+        }
+    }
+    return Object.assign(version, {
+        toJSON() {
+            const { toJSON, ...data } = this;
+            return data;
+        }
+    });
+}
+/** @internal */
+export function validateVersionNumber(value) {
+    if ((typeof value !== 'string' && typeof value !== 'number') ||
+        (typeof value === 'number' && !Number.isSafeInteger(value)) ||
+        !/^[1-9]\d*$/.test(String(value))) {
+        invalidRemoteConfig('Version number must be a positive integer or int64 string.');
+    }
+    if (BigInt(value) > 9223372036854775807n) {
+        invalidRemoteConfig('Version number exceeds int64 range.');
+    }
+    return String(value);
+}
+/** @internal */
+export function normalizeTemplate(input) {
+    if (!isRemoteConfigObject(input) ||
+        typeof input.etag !== 'string' ||
+        !input.etag.trim()) {
+        invalidRemoteConfig('Template must have a non-empty ETag.');
+    }
+    for (const key of ['parameters', 'parameterGroups']) {
+        if (input[key] !== undefined && !isRemoteConfigObject(input[key])) {
+            invalidRemoteConfig(`${key} must be an object.`);
+        }
+    }
+    if (input.conditions !== undefined && !Array.isArray(input.conditions)) {
+        invalidRemoteConfig('conditions must be an array.');
+    }
+    const template = JSON.parse(JSON.stringify(input));
+    template.parameters ??= {};
+    template.conditions ??= [];
+    for (const parameter of [
+        ...Object.values(template.parameters),
+        ...Object.values(input.parameterGroups ?? {}).flatMap((group) => Object.values(group.parameters ?? {}))
+    ]) {
+        if (!isRemoteConfigObject(parameter)) {
+            invalidRemoteConfig('Each parameter must be an object.');
+        }
+        for (const value of Object.values(parameter.conditionalValues ?? {})) {
+            if (!('experimentValue' in value)) {
+                continue;
+            }
+            const { exposurePercent } = value.experimentValue;
+            if (exposurePercent === undefined) {
+                continue;
+            }
+            if (typeof exposurePercent !== 'number' ||
+                !Number.isFinite(exposurePercent) ||
+                exposurePercent < 0 ||
+                exposurePercent > 100) {
+                invalidRemoteConfig('Experiment exposure percent must be between 0 and 100.');
+            }
+        }
+    }
+    if (input.version !== undefined) {
+        template.version = normalizeVersion(input.version);
+    }
+    return template;
+}
+/** A mutable client template with a read-only ETag and JSON serialization. */
+export class RemoteConfigTemplate {
+    parameters;
+    parameterGroups;
+    conditions;
+    version;
+    etag;
+    constructor(input) {
+        const template = normalizeTemplate(input);
+        this.etag = template.etag;
+        this.parameters = template.parameters;
+        this.parameterGroups = template.parameterGroups ?? {};
+        this.conditions = template.conditions;
+        this.version = template.version;
+    }
+    toJSON() {
+        return {
+            parameters: this.parameters,
+            parameterGroups: this.parameterGroups,
+            conditions: this.conditions,
+            etag: this.etag,
+            version: this.version
+                ? normalizeVersion(this.version).toJSON()
+                : undefined
+        };
+    }
+}
+//# sourceMappingURL=remote-config-template.js.map

package/dist/remote-config/remote-config-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-config-template.js","sourceRoot":"","sources":["../../src/remote-config/remote-config-template.ts"],"names":[],"mappings":"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"}