firebase-admin-edge 3.0.2 → 3.1.0

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

@@ -0,0 +1,161 @@
+import { FirebaseEdgeError } from '../auth/errors.js';
+import { restFetch } from '../rest-fetch.js';
+import { invalidRemoteConfig, isRemoteConfigObject } from './remote-config-results.js';
+import { normalizeTemplate, normalizeVersion, validateVersionNumber } from './remote-config-template.js';
+/** @internal Validate list options and convert dates to the REST representation. */
+export function remoteConfigListParams(options = {}) {
+    if (!isRemoteConfigObject(options)) {
+        invalidRemoteConfig('List options must be an object.');
+    }
+    const params = {};
+    if (options.pageSize !== undefined) {
+        if (!Number.isInteger(options.pageSize) ||
+            options.pageSize < 1 ||
+            options.pageSize > 300) {
+            invalidRemoteConfig('pageSize must be an integer between 1 and 300.');
+        }
+        params.pageSize = String(options.pageSize);
+    }
+    if (options.pageToken !== undefined) {
+        if (typeof options.pageToken !== 'string' ||
+            !options.pageToken.trim()) {
+            invalidRemoteConfig('pageToken must be a non-empty string.');
+        }
+        params.pageToken = options.pageToken;
+    }
+    if (options.endVersionNumber !== undefined) {
+        params.endVersionNumber = validateVersionNumber(options.endVersionNumber);
+    }
+    for (const key of ['startTime', 'endTime']) {
+        const value = options[key];
+        if (value === undefined) {
+            continue;
+        }
+        if (!(value instanceof Date) &&
+            (typeof value !== 'string' || !value.trim())) {
+            invalidRemoteConfig(`${key} must be a date or date string.`);
+        }
+        const date = new Date(value);
+        if (!Number.isFinite(date.getTime())) {
+            invalidRemoteConfig(`Invalid ${key}.`);
+        }
+        params[key] = date.toISOString();
+    }
+    return params;
+}
+/** @internal Owns Remote Config URLs, ETags, request bodies, and API errors. */
+export async function remoteConfigRequest(projectId, accessToken, operation, fetch) {
+    let path = 'remoteConfig';
+    let method = 'GET';
+    let body;
+    let params;
+    let originalEtag;
+    const headers = { 'Accept-Encoding': 'gzip' };
+    switch (operation.type) {
+        case 'get':
+            if ('version' in operation) {
+                params = {
+                    versionNumber: validateVersionNumber(operation.version)
+                };
+            }
+            break;
+        case 'rollback':
+            path += ':rollback';
+            method = 'POST';
+            body = { versionNumber: validateVersionNumber(operation.version) };
+            break;
+        case 'list':
+            path += ':listVersions';
+            params = remoteConfigListParams(operation.options);
+            break;
+        case 'server':
+            path = 'namespaces/firebase-server/serverRemoteConfig';
+            break;
+        case 'publish':
+        case 'validate': {
+            if (operation.force !== undefined &&
+                typeof operation.force !== 'boolean') {
+                invalidRemoteConfig('force must be a boolean.');
+            }
+            const template = normalizeTemplate(operation.template);
+            method = 'PUT';
+            headers['If-Match'] = operation.force ? '*' : template.etag;
+            body = {
+                conditions: template.conditions,
+                parameters: template.parameters,
+                parameterGroups: template.parameterGroups ?? {},
+                ...(template.version && {
+                    version: { description: template.version.description }
+                })
+            };
+            if (operation.type === 'validate') {
+                params = { validate_only: 'true' };
+                originalEtag = template.etag;
+            }
+            break;
+        }
+    }
+    let responseEtag = null;
+    let responseStatus = 0;
+    const captureFetch = async (input, init) => {
+        const response = await fetch(input, init);
+        responseEtag = response.headers.get('etag');
+        responseStatus = response.status;
+        return response;
+    };
+    const { error, data } = await restFetch(`https://firebaseremoteconfig.googleapis.com/v1/projects/${encodeURIComponent(projectId)}/${path}`, {
+        method,
+        body,
+        params,
+        headers,
+        bearerToken: accessToken,
+        global: { fetch: captureFetch }
+    });
+    if (error !== null) {
+        const codes = {
+            INVALID_ARGUMENT: 'invalid-argument',
+            NOT_FOUND: 'not-found',
+            PERMISSION_DENIED: 'permission-denied',
+            UNAUTHENTICATED: 'authentication-error',
+            RESOURCE_EXHAUSTED: 'resource-exhausted',
+            FAILED_PRECONDITION: 'failed-precondition',
+            ABORTED: 'aborted',
+            INTERNAL: 'internal-error',
+            UNAVAILABLE: 'unavailable',
+            UNKNOWN: 'unknown-error'
+        };
+        const status = typeof error === 'object' ? error?.error?.status : undefined;
+        throw new FirebaseEdgeError({
+            code: `remote-config/${responseStatus === 412 ? 'etag-mismatch' : (codes[status ?? ''] ?? 'unknown-error')}`,
+            message: typeof error === 'string'
+                ? error
+                : (error?.error?.message ?? 'Remote Config request failed.')
+        });
+    }
+    if (!isRemoteConfigObject(data)) {
+        throw new FirebaseEdgeError({
+            code: 'remote-config/internal-error',
+            message: 'Invalid Remote Config response.'
+        });
+    }
+    if (operation.type === 'list') {
+        if (data.versions !== undefined && !Array.isArray(data.versions)) {
+            throw new FirebaseEdgeError({
+                code: 'remote-config/internal-error',
+                message: 'Invalid version list.'
+            });
+        }
+        return {
+            versions: (data.versions ?? []).map(normalizeVersion),
+            nextPageToken: data.nextPageToken
+        };
+    }
+    if (!responseEtag) {
+        throw new FirebaseEdgeError({
+            code: 'remote-config/internal-error',
+            message: 'Remote Config response is missing its ETag.'
+        });
+    }
+    return { ...data, etag: originalEtag ?? responseEtag };
+}
+//# sourceMappingURL=remote-config-endpoints.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"remote-config-endpoints.js","sourceRoot":"","sources":["../../src/remote-config/remote-config-endpoints.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAO7C,OAAO,EACH,mBAAmB,EACnB,oBAAoB,EACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACH,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACxB,MAAM,6BAA6B,CAAC;AAarC,oFAAoF;AACpF,MAAM,UAAU,sBAAsB,CAClC,UAA+B,EAAE;IAEjC,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,EAAE,CAAC;QACjC,mBAAmB,CAAC,iCAAiC,CAAC,CAAC;IAC3D,CAAC;IACD,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACjC,IACI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC;YACnC,OAAO,CAAC,QAAQ,GAAG,CAAC;YACpB,OAAO,CAAC,QAAQ,GAAG,GAAG,EACxB,CAAC;YACC,mBAAmB,CACf,gDAAgD,CACnD,CAAC;QACN,CAAC;QACD,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QAClC,IACI,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ;YACrC,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,EAC3B,CAAC;YACC,mBAAmB,CAAC,uCAAuC,CAAC,CAAC;QACjE,CAAC;QACD,MAAM,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IACzC,CAAC;IACD,IAAI,OAAO,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;QACzC,MAAM,CAAC,gBAAgB,GAAG,qBAAqB,CAC3C,OAAO,CAAC,gBAAgB,CAC3B,CAAC;IACN,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,CAAU,EAAE,CAAC;QAClD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACtB,SAAS;QACb,CAAC;QACD,IACI,CAAC,CAAC,KAAK,YAAY,IAAI,CAAC;YACxB,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAC9C,CAAC;YACC,mBAAmB,CAAC,GAAG,GAAG,iCAAiC,CAAC,CAAC;QACjE,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;YACnC,mBAAmB,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC;QAC3C,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACrC,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACrC,SAAiB,EACjB,WAAmB,EACnB,SAAgC,EAChC,KAA8B;IAE9B,IAAI,IAAI,GAAG,cAAc,CAAC;IAC1B,IAAI,MAAM,GAA2B,KAAK,CAAC;IAC3C,IAAI,IAAwB,CAAC;IAC7B,IAAI,MAA0C,CAAC;IAC/C,IAAI,YAAgC,CAAC;IACrC,MAAM,OAAO,GAA2B,EAAE,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAEtE,QAAQ,SAAS,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,KAAK;YACN,IAAI,SAAS,IAAI,SAAS,EAAE,CAAC;gBACzB,MAAM,GAAG;oBACL,aAAa,EAAE,qBAAqB,CAChC,SAAS,CAAC,OAA0B,CACvC;iBACJ,CAAC;YACN,CAAC;YACD,MAAM;QAEV,KAAK,UAAU;YACX,IAAI,IAAI,WAAW,CAAC;YACpB,MAAM,GAAG,MAAM,CAAC;YAChB,IAAI,GAAG,EAAE,aAAa,EAAE,qBAAqB,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YACnE,MAAM;QAEV,KAAK,MAAM;YACP,IAAI,IAAI,eAAe,CAAC;YACxB,MAAM,GAAG,sBAAsB,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YACnD,MAAM;QAEV,KAAK,QAAQ;YACT,IAAI,GAAG,+CAA+C,CAAC;YACvD,MAAM;QAEV,KAAK,SAAS,CAAC;QACf,KAAK,UAAU,CAAC,CAAC,CAAC;YACd,IACI,SAAS,CAAC,KAAK,KAAK,SAAS;gBAC7B,OAAO,SAAS,CAAC,KAAK,KAAK,SAAS,EACtC,CAAC;gBACC,mBAAmB,CAAC,0BAA0B,CAAC,CAAC;YACpD,CAAC;YACD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YACvD,MAAM,GAAG,KAAK,CAAC;YACf,OAAO,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;YAC5D,IAAI,GAAG;gBACH,UAAU,EAAE,QAAQ,CAAC,UAAU;gBAC/B,UAAU,EAAE,QAAQ,CAAC,UAAU;gBAC/B,eAAe,EAAE,QAAQ,CAAC,eAAe,IAAI,EAAE;gBAC/C,GAAG,CAAC,QAAQ,CAAC,OAAO,IAAI;oBACpB,OAAO,EAAE,EAAE,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE;iBACzD,CAAC;aACL,CAAC;YACF,IAAI,SAAS,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBAChC,MAAM,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC;gBACnC,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAC;YACjC,CAAC;YACD,MAAM;QACV,CAAC;IACL,CAAC;IACD,IAAI,YAAY,GAAkB,IAAI,CAAC;IACvC,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,MAAM,YAAY,GAA4B,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAChE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC1C,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC5C,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC;QACjC,OAAO,QAAQ,CAAC;IACpB,CAAC,CAAC;IACF,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,SAAS,CAInC,2DAA2D,kBAAkB,CAAC,SAAS,CAAC,IAAI,IAAI,EAAE,EAClG;QACI,MAAM;QACN,IAAI;QACJ,MAAM;QACN,OAAO;QACP,WAAW,EAAE,WAAW;QACxB,MAAM,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE;KAClC,CACJ,CAAC;IACF,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACjB,MAAM,KAAK,GAA2B;YAClC,gBAAgB,EAAE,kBAAkB;YACpC,SAAS,EAAE,WAAW;YACtB,iBAAiB,EAAE,mBAAmB;YACtC,eAAe,EAAE,sBAAsB;YACvC,kBAAkB,EAAE,oBAAoB;YACxC,mBAAmB,EAAE,qBAAqB;YAC1C,OAAO,EAAE,SAAS;YAClB,QAAQ,EAAE,gBAAgB;YAC1B,WAAW,EAAE,aAAa;YAC1B,OAAO,EAAE,eAAe;SAC3B,CAAC;QACF,MAAM,MAAM,GACR,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;QACjE,MAAM,IAAI,iBAAiB,CAAC;YACxB,IAAI,EAAE,iBAAiB,cAAc,KAAK,GAAG,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,IAAI,eAAe,CAAC,EAAE;YAC5G,OAAO,EACH,OAAO,KAAK,KAAK,QAAQ;gBACrB,CAAC,CAAC,KAAK;gBACP,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,IAAI,+BAA+B,CAAC;SACvE,CAAC,CAAC;IACP,CAAC;IACD,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,iBAAiB,CAAC;YACxB,IAAI,EAAE,8BAA8B;YACpC,OAAO,EAAE,iCAAiC;SAC7C,CAAC,CAAC;IACP,CAAC;IACD,IAAI,SAAS,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/D,MAAM,IAAI,iBAAiB,CAAC;gBACxB,IAAI,EAAE,8BAA8B;gBACpC,OAAO,EAAE,uBAAuB;aACnC,CAAC,CAAC;QACP,CAAC;QACD,OAAO;YACH,QAAQ,EACJ,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CACvB,CAAC,GAAG,CAAC,gBAAgB,CAAC;YACvB,aAAa,EAAE,IAAI,CAAC,aAAmC;SAC1D,CAAC;IACN,CAAC;IACD,IAAI,CAAC,YAAY,EAAE,CAAC;QAChB,MAAM,IAAI,iBAAiB,CAAC;YACxB,IAAI,EAAE,8BAA8B;YACpC,OAAO,EAAE,6CAA6C;SACzD,CAAC,CAAC;IACP,CAAC;IACD,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,YAAY,IAAI,YAAY,EAE5B,CAAC;AAC7B,CAAC"}

package/dist/remote-config/remote-config-fetch-response.d.ts

@@ -0,0 +1,8 @@
+import type { ServerConfig, FetchResponseData } from './remote-config-types.js';
+/** Produces a client fetch response from evaluated server configuration. */
+export declare class RemoteConfigFetchResponse {
+    private readonly response;
+    constructor(projectId: string, serverConfig: ServerConfig, requestEtag?: string);
+    toJSON(): FetchResponseData;
+}
+//# sourceMappingURL=remote-config-fetch-response.d.ts.map

package/dist/remote-config/remote-config-fetch-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-config-fetch-response.d.ts","sourceRoot":"","sources":["../../src/remote-config/remote-config-fetch-response.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAEhF,4EAA4E;AAC5E,qBAAa,yBAAyB;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;gBAEzC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,YAAY,EAC1B,WAAW,CAAC,EAAE,MAAM;IAqBxB,MAAM,IAAI,iBAAiB;CAG9B"}

package/dist/remote-config/remote-config-fetch-response.js

@@ -0,0 +1,26 @@
+/** Produces a client fetch response from evaluated server configuration. */
+export class RemoteConfigFetchResponse {
+    response;
+    constructor(projectId, serverConfig, requestEtag) {
+        const config = Object.fromEntries(Object.entries(serverConfig.getAll()).map(([key, value]) => [
+            key,
+            value.asString()
+        ]));
+        const json = JSON.stringify(config);
+        let hash = 0;
+        for (let index = 0; index < json.length; index++) {
+            hash = ((hash << 5) - hash + json.charCodeAt(index)) | 0;
+        }
+        const eTag = ['etag', projectId, 'firebase-server', 'fetch', hash]
+            .filter(Boolean)
+            .join('-');
+        this.response =
+            requestEtag === eTag
+                ? { status: 304, eTag }
+                : { status: 200, eTag, config };
+    }
+    toJSON() {
+        return structuredClone(this.response);
+    }
+}
+//# sourceMappingURL=remote-config-fetch-response.js.map

package/dist/remote-config/remote-config-fetch-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-config-fetch-response.js","sourceRoot":"","sources":["../../src/remote-config/remote-config-fetch-response.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,MAAM,OAAO,yBAAyB;IACjB,QAAQ,CAAoB;IAC7C,YACI,SAAiB,EACjB,YAA0B,EAC1B,WAAoB;QAEpB,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAC7B,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;YACxD,GAAG;YACH,KAAK,CAAC,QAAQ,EAAE;SACnB,CAAC,CACL,CAAC;QACF,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;YAC/C,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC;QAC7D,CAAC;QACD,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,iBAAiB,EAAE,OAAO,EAAE,IAAI,CAAC;aAC7D,MAAM,CAAC,OAAO,CAAC;aACf,IAAI,CAAC,GAAG,CAAC,CAAC;QACf,IAAI,CAAC,QAAQ;YACT,WAAW,KAAK,IAAI;gBAChB,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE;gBACvB,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC5C,CAAC;IACD,MAAM;QACF,OAAO,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;CACJ"}

package/dist/remote-config/remote-config-results.d.ts

@@ -0,0 +1,15 @@
+import { FirebaseEdgeError } from '../auth/errors.js';
+export type RemoteConfigResult<T> = {
+    error: null;
+    data: T;
+} | {
+    error: FirebaseEdgeError;
+    data: null;
+};
+/** @internal */
+export declare function remoteConfigError(cause: unknown): FirebaseEdgeError;
+/** @internal */
+export declare function invalidRemoteConfig(message: string): never;
+/** @internal */
+export declare function isRemoteConfigObject<T>(value: T): value is T & Record<string, unknown>;
+//# sourceMappingURL=remote-config-results.d.ts.map

package/dist/remote-config/remote-config-results.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-config-results.d.ts","sourceRoot":"","sources":["../../src/remote-config/remote-config-results.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAe,MAAM,mBAAmB,CAAC;AAEnE,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAC1B;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GACxB;IAAE,KAAK,EAAE,iBAAiB,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,CAAC;AAE/C,gBAAgB;AAChB,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAgBnE;AAED,gBAAgB;AAChB,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAK1D;AAED,gBAAgB;AAChB,wBAAgB,oBAAoB,CAAC,CAAC,EAClC,KAAK,EAAE,CAAC,GACT,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEtC"}

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

@@ -0,0 +1,26 @@
+import { FirebaseEdgeError, ensureError } from '../auth/errors.js';
+/** @internal */
+export function remoteConfigError(cause) {
+    if (cause instanceof FirebaseEdgeError) {
+        return cause;
+    }
+    const error = ensureError(cause);
+    return new FirebaseEdgeError({
+        code: cause instanceof SyntaxError
+            ? 'remote-config/invalid-argument'
+            : 'remote-config/unknown-error',
+        message: error.message
+    }, { cause: error });
+}
+/** @internal */
+export function invalidRemoteConfig(message) {
+    throw new FirebaseEdgeError({
+        code: 'remote-config/invalid-argument',
+        message
+    });
+}
+/** @internal */
+export function isRemoteConfigObject(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+//# sourceMappingURL=remote-config-results.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"remote-config-results.js","sourceRoot":"","sources":["../../src/remote-config/remote-config-results.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAMnE,gBAAgB;AAChB,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC5C,IAAI,KAAK,YAAY,iBAAiB,EAAE,CAAC;QACrC,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAEjC,OAAO,IAAI,iBAAiB,CACxB;QACI,IAAI,EACA,KAAK,YAAY,WAAW;YACxB,CAAC,CAAC,gCAAgC;YAClC,CAAC,CAAC,6BAA6B;QACvC,OAAO,EAAE,KAAK,CAAC,OAAO;KACzB,EACD,EAAE,KAAK,EAAE,KAAK,EAAE,CACnB,CAAC;AACN,CAAC;AAED,gBAAgB;AAChB,MAAM,UAAU,mBAAmB,CAAC,OAAe;IAC/C,MAAM,IAAI,iBAAiB,CAAC;QACxB,IAAI,EAAE,gCAAgC;QACtC,OAAO;KACV,CAAC,CAAC;AACP,CAAC;AAED,gBAAgB;AAChB,MAAM,UAAU,oBAAoB,CAChC,KAAQ;IAER,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAChF,CAAC"}

package/dist/remote-config/remote-config-template.d.ts

@@ -0,0 +1,20 @@
+import type { RemoteConfigTemplate as TemplateData, ServerTemplateData, Version } from './remote-config-types.js';
+/** @internal Validate and normalize version metadata without losing int64 precision. */
+export declare function normalizeVersion(input: Version): Version & {
+    toJSON(): object;
+};
+/** @internal */
+export declare function validateVersionNumber(value: string | number): string;
+/** @internal */
+export declare function normalizeTemplate<T extends TemplateData | ServerTemplateData>(input: T): T;
+/** A mutable client template with a read-only ETag and JSON serialization. */
+export declare class RemoteConfigTemplate implements TemplateData {
+    parameters: TemplateData['parameters'];
+    parameterGroups: TemplateData['parameterGroups'];
+    conditions: TemplateData['conditions'];
+    version?: Version;
+    readonly etag: string;
+    constructor(input: TemplateData);
+    toJSON(): TemplateData;
+}
+//# sourceMappingURL=remote-config-template.d.ts.map

package/dist/remote-config/remote-config-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-config-template.d.ts","sourceRoot":"","sources":["../../src/remote-config/remote-config-template.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,oBAAoB,IAAI,YAAY,EACpC,kBAAkB,EAClB,OAAO,EACV,MAAM,0BAA0B,CAAC;AAMlC,wFAAwF;AACxF,wBAAgB,gBAAgB,CAC5B,KAAK,EAAE,OAAO,GACf,OAAO,GAAG;IAAE,MAAM,IAAI,MAAM,CAAA;CAAE,CA8ChC;AAED,gBAAgB;AAChB,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAcpE;AAED,gBAAgB;AAChB,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,YAAY,GAAG,kBAAkB,EACzE,KAAK,EAAE,CAAC,GACT,CAAC,CAqDH;AAED,8EAA8E;AAC9E,qBAAa,oBAAqB,YAAW,YAAY;IACrD,UAAU,EAAE,YAAY,CAAC,YAAY,CAAC,CAAC;IACvC,eAAe,EAAE,YAAY,CAAC,iBAAiB,CAAC,CAAC;IACjD,UAAU,EAAE,YAAY,CAAC,YAAY,CAAC,CAAC;IACvC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,KAAK,EAAE,YAAY;IAS/B,MAAM,IAAI,YAAY;CAWzB"}

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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"}