@atproto/bsky 0.0.216 → 0.0.217

package/dist/feature-gates/metrics.test.js

@@ -0,0 +1,152 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/// <reference types="jest" />
+const logger_1 = require("../logger");
+const metrics_1 = require("./metrics");
+jest.mock('../logger', () => ({
+    featureGatesLogger: {
+        error: jest.fn(),
+    },
+}));
+// Helper to flush promises and timers
+const flushPromises = () => new Promise((r) => setImmediate(r));
+describe('MetricsClient', () => {
+    let fetchMock;
+    let fetchRequests;
+    let client;
+    beforeEach(() => {
+        jest.useFakeTimers({ doNotFake: ['setImmediate', 'performance'] });
+        fetchRequests = [];
+        fetchMock = jest.fn().mockImplementation(async (_url, options) => {
+            const body = JSON.parse(options.body);
+            fetchRequests.push({ body });
+            return { ok: true, status: 200, text: async () => '' };
+        });
+        global.fetch = fetchMock;
+    });
+    afterEach(() => {
+        client?.stop();
+        jest.useRealTimers();
+        jest.clearAllMocks();
+    });
+    it('flushes events on interval', async () => {
+        client = new metrics_1.MetricsClient({
+            trackingEndpoint: 'https://test.metrics.api',
+        });
+        client.track('click', { button: 'submit' });
+        client.track('view', { screen: 'home' });
+        expect(fetchRequests).toHaveLength(0);
+        // Advance past the 10 second interval
+        jest.advanceTimersByTime(10000);
+        await flushPromises();
+        expect(fetchRequests).toHaveLength(1);
+        expect(fetchRequests[0].body.events).toHaveLength(2);
+        expect(fetchRequests[0].body.events[0].event).toBe('click');
+        expect(fetchRequests[0].body.events[1].event).toBe('view');
+    });
+    it('flushes when maxBatchSize is exceeded', async () => {
+        client = new metrics_1.MetricsClient({
+            trackingEndpoint: 'https://test.metrics.api',
+        });
+        client.maxBatchSize = 5;
+        // Add events up to maxBatchSize (should not flush yet)
+        for (let i = 0; i < 5; i++) {
+            client.track('click', { button: `btn-${i}` });
+        }
+        expect(fetchRequests).toHaveLength(0);
+        // One more event should trigger flush (> maxBatchSize)
+        client.track('click', { button: 'btn-trigger' });
+        await flushPromises();
+        expect(fetchRequests).toHaveLength(1);
+        expect(fetchRequests[0].body.events).toHaveLength(6);
+    });
+    it('logs error on failed request', async () => {
+        fetchMock.mockImplementation(async () => {
+            return {
+                ok: false,
+                status: 500,
+                text: async () => 'Internal Server Error',
+            };
+        });
+        client = new metrics_1.MetricsClient({
+            trackingEndpoint: 'https://test.metrics.api',
+        });
+        client.track('click', { button: 'submit' });
+        // Trigger flush via interval
+        jest.advanceTimersByTime(10000);
+        await flushPromises();
+        expect(fetchMock).toHaveBeenCalledTimes(1);
+        expect(logger_1.featureGatesLogger.error).toHaveBeenCalledWith(expect.objectContaining({
+            err: expect.any(Error),
+        }), 'Failed to send metrics');
+    });
+    it('handles fetch text() error gracefully', async () => {
+        fetchMock.mockImplementation(async () => {
+            return {
+                ok: false,
+                status: 500,
+                text: async () => {
+                    throw new Error('Failed to read response');
+                },
+            };
+        });
+        client = new metrics_1.MetricsClient({
+            trackingEndpoint: 'https://test.metrics.api',
+        });
+        client.track('click', { button: 'submit' });
+        // Trigger flush - should not throw
+        jest.advanceTimersByTime(10000);
+        await flushPromises();
+        expect(fetchMock).toHaveBeenCalledTimes(1);
+        expect(logger_1.featureGatesLogger.error).toHaveBeenCalledWith(expect.objectContaining({
+            err: expect.objectContaining({
+                message: expect.stringContaining('Unknown error'),
+            }),
+        }), 'Failed to send metrics');
+    });
+    it('flushes when stop() is called', async () => {
+        client = new metrics_1.MetricsClient({
+            trackingEndpoint: 'https://test.metrics.api',
+        });
+        client.track('click', { button: 'submit' });
+        expect(fetchRequests).toHaveLength(0);
+        // Stop should flush remaining events
+        client.stop();
+        await flushPromises();
+        expect(fetchRequests).toHaveLength(1);
+        expect(fetchRequests[0].body.events).toHaveLength(1);
+        expect(fetchRequests[0].body.events[0].event).toBe('click');
+    });
+    it('does not send if trackingEndpoint is not configured', async () => {
+        client = new metrics_1.MetricsClient({});
+        client.track('click', { button: 'submit' });
+        // Trigger flush via interval
+        jest.advanceTimersByTime(10000);
+        await flushPromises();
+        expect(fetchMock).not.toHaveBeenCalled();
+    });
+    it('start() is idempotent', async () => {
+        client = new metrics_1.MetricsClient({
+            trackingEndpoint: 'https://test.metrics.api',
+        });
+        // track() calls start() internally
+        client.track('click', { button: 'submit' });
+        client.start();
+        client.start();
+        // Advance past interval - should only flush once
+        jest.advanceTimersByTime(10000);
+        await flushPromises();
+        expect(fetchRequests).toHaveLength(1);
+    });
+    it('does not flush if queue is empty', async () => {
+        client = new metrics_1.MetricsClient({
+            trackingEndpoint: 'https://test.metrics.api',
+        });
+        client.start();
+        // Advance past interval with empty queue
+        jest.advanceTimersByTime(10000);
+        await flushPromises();
+        expect(fetchMock).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=metrics.test.js.map

package/dist/feature-gates/metrics.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.test.js","sourceRoot":"","sources":["../../src/feature-gates/metrics.test.ts"],"names":[],"mappings":"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","sourcesContent":["/// <reference types=\"jest\" />\nimport { featureGatesLogger } from '../logger'\nimport { MetricsClient } from './metrics'\n\njest.mock('../logger', () => ({\n  featureGatesLogger: {\n    error: jest.fn(),\n  },\n}))\n\ntype TestEvents = {\n  click: { button: string }\n  view: { screen: string }\n}\n\n// Helper to flush promises and timers\nconst flushPromises = () => new Promise((r) => setImmediate(r))\n\ndescribe('MetricsClient', () => {\n  let fetchMock: jest.Mock\n  let fetchRequests: { body: any }[]\n  let client: MetricsClient<TestEvents>\n\n  beforeEach(() => {\n    jest.useFakeTimers({ doNotFake: ['setImmediate', 'performance'] })\n    fetchRequests = []\n    fetchMock = jest.fn().mockImplementation(async (_url, options) => {\n      const body = JSON.parse(options.body)\n      fetchRequests.push({ body })\n      return { ok: true, status: 200, text: async () => '' }\n    })\n    global.fetch = fetchMock\n  })\n\n  afterEach(() => {\n    client?.stop()\n    jest.useRealTimers()\n    jest.clearAllMocks()\n  })\n\n  it('flushes events on interval', async () => {\n    client = new MetricsClient<TestEvents>({\n      trackingEndpoint: 'https://test.metrics.api',\n    })\n    client.track('click', { button: 'submit' })\n    client.track('view', { screen: 'home' })\n\n    expect(fetchRequests).toHaveLength(0)\n\n    // Advance past the 10 second interval\n    jest.advanceTimersByTime(10_000)\n    await flushPromises()\n\n    expect(fetchRequests).toHaveLength(1)\n    expect(fetchRequests[0].body.events).toHaveLength(2)\n    expect(fetchRequests[0].body.events[0].event).toBe('click')\n    expect(fetchRequests[0].body.events[1].event).toBe('view')\n  })\n\n  it('flushes when maxBatchSize is exceeded', async () => {\n    client = new MetricsClient<TestEvents>({\n      trackingEndpoint: 'https://test.metrics.api',\n    })\n    client.maxBatchSize = 5\n\n    // Add events up to maxBatchSize (should not flush yet)\n    for (let i = 0; i < 5; i++) {\n      client.track('click', { button: `btn-${i}` })\n    }\n\n    expect(fetchRequests).toHaveLength(0)\n\n    // One more event should trigger flush (> maxBatchSize)\n    client.track('click', { button: 'btn-trigger' })\n    await flushPromises()\n\n    expect(fetchRequests).toHaveLength(1)\n    expect(fetchRequests[0].body.events).toHaveLength(6)\n  })\n\n  it('logs error on failed request', async () => {\n    fetchMock.mockImplementation(async () => {\n      return {\n        ok: false,\n        status: 500,\n        text: async () => 'Internal Server Error',\n      }\n    })\n\n    client = new MetricsClient<TestEvents>({\n      trackingEndpoint: 'https://test.metrics.api',\n    })\n    client.track('click', { button: 'submit' })\n\n    // Trigger flush via interval\n    jest.advanceTimersByTime(10_000)\n    await flushPromises()\n\n    expect(fetchMock).toHaveBeenCalledTimes(1)\n    expect(featureGatesLogger.error).toHaveBeenCalledWith(\n      expect.objectContaining({\n        err: expect.any(Error),\n      }),\n      'Failed to send metrics',\n    )\n  })\n\n  it('handles fetch text() error gracefully', async () => {\n    fetchMock.mockImplementation(async () => {\n      return {\n        ok: false,\n        status: 500,\n        text: async () => {\n          throw new Error('Failed to read response')\n        },\n      }\n    })\n\n    client = new MetricsClient<TestEvents>({\n      trackingEndpoint: 'https://test.metrics.api',\n    })\n    client.track('click', { button: 'submit' })\n\n    // Trigger flush - should not throw\n    jest.advanceTimersByTime(10_000)\n    await flushPromises()\n\n    expect(fetchMock).toHaveBeenCalledTimes(1)\n    expect(featureGatesLogger.error).toHaveBeenCalledWith(\n      expect.objectContaining({\n        err: expect.objectContaining({\n          message: expect.stringContaining('Unknown error'),\n        }),\n      }),\n      'Failed to send metrics',\n    )\n  })\n\n  it('flushes when stop() is called', async () => {\n    client = new MetricsClient<TestEvents>({\n      trackingEndpoint: 'https://test.metrics.api',\n    })\n    client.track('click', { button: 'submit' })\n\n    expect(fetchRequests).toHaveLength(0)\n\n    // Stop should flush remaining events\n    client.stop()\n    await flushPromises()\n\n    expect(fetchRequests).toHaveLength(1)\n    expect(fetchRequests[0].body.events).toHaveLength(1)\n    expect(fetchRequests[0].body.events[0].event).toBe('click')\n  })\n\n  it('does not send if trackingEndpoint is not configured', async () => {\n    client = new MetricsClient<TestEvents>({})\n    client.track('click', { button: 'submit' })\n\n    // Trigger flush via interval\n    jest.advanceTimersByTime(10_000)\n    await flushPromises()\n\n    expect(fetchMock).not.toHaveBeenCalled()\n  })\n\n  it('start() is idempotent', async () => {\n    client = new MetricsClient<TestEvents>({\n      trackingEndpoint: 'https://test.metrics.api',\n    })\n\n    // track() calls start() internally\n    client.track('click', { button: 'submit' })\n    client.start()\n    client.start()\n\n    // Advance past interval - should only flush once\n    jest.advanceTimersByTime(10_000)\n    await flushPromises()\n\n    expect(fetchRequests).toHaveLength(1)\n  })\n\n  it('does not flush if queue is empty', async () => {\n    client = new MetricsClient<TestEvents>({\n      trackingEndpoint: 'https://test.metrics.api',\n    })\n    client.start()\n\n    // Advance past interval with empty queue\n    jest.advanceTimersByTime(10_000)\n    await flushPromises()\n\n    expect(fetchMock).not.toHaveBeenCalled()\n  })\n})\n"]}

package/dist/feature-gates/types.d.ts

@@ -0,0 +1,49 @@
+import type express from 'express';
+import { FeatureGate } from './gates';
+/**
+ * The user context passed to the feature gates client for evaluation and
+ * tracking purposes.
+ */
+export type RawUserContext = {
+    /**
+     * The user's DID
+     */
+    viewer: string | null;
+    /**
+     * The express request object, used to extract analytics headers for the user context
+     */
+    req: express.Request;
+};
+/**
+ * Extracted values from the `RawUserContext`. These values should match the
+ * `attributes` we've configured for GrowthBook in our GB dashboard. We also
+ * send these same values as properties in our analytics events, so we want to
+ * make sure they are consistent.
+ */
+export type ParsedUserContext = {
+    did?: string | null;
+    deviceId: string;
+    sessionId: string;
+};
+/**
+ * This loosely matches the metadata we send from the client for analytics
+ * events. We want to make sure we have the same properties in both places so
+ * that we can correlate feature gate evaluations with analytics events.
+ *
+ * @see https://github.com/bluesky-social/social-app/blob/76109a58dc7aafccdfbd07a81cbd9925e065d1c0/src/analytics/metadata.ts
+ */
+export type TrackingMetadata = {
+    base: {
+        deviceId: string;
+        sessionId: string;
+    };
+    session: {
+        did: string | undefined;
+    };
+};
+/**
+ * Pre-evaluated feature gates map, the result of
+ * `ctx.FeatureGatesClient.checkGates()`
+ */
+export type CheckedFeatureGatesMap = Map<FeatureGate, boolean>;
+//# sourceMappingURL=types.d.ts.map

package/dist/feature-gates/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/feature-gates/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAA;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAErC;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B;;OAEG;IACH,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB;;OAEG;IACH,GAAG,EAAE,OAAO,CAAC,OAAO,CAAA;CACrB,CAAA;AAED;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE;QACJ,QAAQ,EAAE,MAAM,CAAA;QAChB,SAAS,EAAE,MAAM,CAAA;KAClB,CAAA;IACD,OAAO,EAAE;QACP,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;KACxB,CAAA;CACF,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,CAAA"}

package/dist/feature-gates/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/feature-gates/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/feature-gates/types.ts"],"names":[],"mappings":"","sourcesContent":["import type express from 'express'\nimport { FeatureGate } from './gates'\n\n/**\n * The user context passed to the feature gates client for evaluation and\n * tracking purposes.\n */\nexport type RawUserContext = {\n  /**\n   * The user's DID\n   */\n  viewer: string | null\n  /**\n   * The express request object, used to extract analytics headers for the user context\n   */\n  req: express.Request\n}\n\n/**\n * Extracted values from the `RawUserContext`. These values should match the\n * `attributes` we've configured for GrowthBook in our GB dashboard. We also\n * send these same values as properties in our analytics events, so we want to\n * make sure they are consistent.\n */\nexport type ParsedUserContext = {\n  did?: string | null\n  deviceId: string\n  sessionId: string\n}\n\n/**\n * This loosely matches the metadata we send from the client for analytics\n * events. We want to make sure we have the same properties in both places so\n * that we can correlate feature gate evaluations with analytics events.\n *\n * @see https://github.com/bluesky-social/social-app/blob/76109a58dc7aafccdfbd07a81cbd9925e065d1c0/src/analytics/metadata.ts\n */\nexport type TrackingMetadata = {\n  base: {\n    deviceId: string\n    sessionId: string\n  }\n  session: {\n    did: string | undefined\n  }\n}\n\n/**\n * Pre-evaluated feature gates map, the result of\n * `ctx.FeatureGatesClient.checkGates()`\n */\nexport type CheckedFeatureGatesMap = Map<FeatureGate, boolean>\n"]}

package/dist/feature-gates/utils.d.ts

@@ -0,0 +1,21 @@
+import { type UserContext as GrowthBookUserContext } from '@growthbook/growthbook';
+import { ParsedUserContext, RawUserContext, TrackingMetadata } from './types';
+/**
+ * Parse the `RawUserContext` into a `ParsedUserContext` that is used as
+ * GrowthBook `attributes` as well as the metadata payload for our analytics
+ * events. This ensures that the same user properties are used for both feature
+ * gate targeting and analytics.
+ */
+export declare function parseRawUserContext(userContext: RawUserContext): ParsedUserContext;
+/**
+ * Extract the `ParsedUserContext` from the GrowthBook `UserContext`, which we
+ * passed into `isOn` as `attributes`.
+ */
+export declare function extractParsedUserContextFromGrowthBookUserContext(userContext: GrowthBookUserContext): ParsedUserContext;
+/**
+ * Convert the `ParsedUserContext` into the `TrackingMetadata` format that we
+ * use for our analytics events. This ensures that we have the same user
+ * properties as we do for events from our client app.
+ */
+export declare function parsedUserContextToTrackingMetadata(parsedUserContext: ParsedUserContext): TrackingMetadata;
+//# sourceMappingURL=utils.d.ts.map

package/dist/feature-gates/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/feature-gates/utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,WAAW,IAAI,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAClF,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAQ7E;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,cAAc,GAC1B,iBAAiB,CAsCnB;AAED;;;GAGG;AACH,wBAAgB,iDAAiD,CAC/D,WAAW,EAAE,qBAAqB,GACjC,iBAAiB,CAMnB;AAED;;;;GAIG;AACH,wBAAgB,mCAAmC,CACjD,iBAAiB,EAAE,iBAAiB,GACnC,gBAAgB,CAUlB"}

package/dist/feature-gates/utils.js

@@ -0,0 +1,85 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseRawUserContext = parseRawUserContext;
+exports.extractParsedUserContextFromGrowthBookUserContext = extractParsedUserContextFromGrowthBookUserContext;
+exports.parsedUserContextToTrackingMetadata = parsedUserContextToTrackingMetadata;
+const node_crypto_1 = __importDefault(require("node:crypto"));
+/**
+ * These need to match what the client sends
+ */
+const ANALYTICS_HEADER_DEVICE_ID = 'X-Bsky-Device-Id';
+const ANALYTICS_HEADER_SESSION_ID = 'X-Bsky-Session-Id';
+/**
+ * Parse the `RawUserContext` into a `ParsedUserContext` that is used as
+ * GrowthBook `attributes` as well as the metadata payload for our analytics
+ * events. This ensures that the same user properties are used for both feature
+ * gate targeting and analytics.
+ */
+function parseRawUserContext(userContext) {
+    const did = userContext.viewer;
+    // prioritize passthrough header
+    let deviceId = userContext.req.header(ANALYTICS_HEADER_DEVICE_ID);
+    if (!deviceId) {
+        if (did) {
+            /*
+             * If we don't have a device header, fall back to the DID. Our event
+             * proxy ensures ordering based on this deviceId (also called a stableId
+             * in the proxy), so if we have a DID, we want to use it to ensure client
+             * and server events are properly ordered.
+             */
+            deviceId = did;
+        }
+        else {
+            /*
+             * Without any better option for identifying the user, we generate a
+             * random deviceId.
+             */
+            deviceId = `anon-${node_crypto_1.default.randomUUID()}`;
+        }
+    }
+    // prioritize passthrough header
+    let sessionId = userContext.req.header(ANALYTICS_HEADER_SESSION_ID);
+    if (!sessionId) {
+        /*
+         * Without any better option for identifying the user, we generate a
+         * random deviceId.
+         */
+        sessionId = `anon-${node_crypto_1.default.randomUUID()}`;
+    }
+    return {
+        did,
+        deviceId,
+        sessionId,
+    };
+}
+/**
+ * Extract the `ParsedUserContext` from the GrowthBook `UserContext`, which we
+ * passed into `isOn` as `attributes`.
+ */
+function extractParsedUserContextFromGrowthBookUserContext(userContext) {
+    return {
+        did: userContext.attributes?.did,
+        deviceId: userContext.attributes?.deviceId,
+        sessionId: userContext.attributes?.sessionId,
+    };
+}
+/**
+ * Convert the `ParsedUserContext` into the `TrackingMetadata` format that we
+ * use for our analytics events. This ensures that we have the same user
+ * properties as we do for events from our client app.
+ */
+function parsedUserContextToTrackingMetadata(parsedUserContext) {
+    return {
+        base: {
+            deviceId: parsedUserContext.deviceId,
+            sessionId: parsedUserContext.sessionId,
+        },
+        session: {
+            did: parsedUserContext.did ?? undefined,
+        },
+    };
+}
+//# sourceMappingURL=utils.js.map

package/dist/feature-gates/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/feature-gates/utils.ts"],"names":[],"mappings":";;;;;AAgBA,kDAwCC;AAMD,8GAQC;AAOD,kFAYC;AAzFD,8DAAgC;AAIhC;;GAEG;AACH,MAAM,0BAA0B,GAAG,kBAAkB,CAAA;AACrD,MAAM,2BAA2B,GAAG,mBAAmB,CAAA;AAEvD;;;;;GAKG;AACH,SAAgB,mBAAmB,CACjC,WAA2B;IAE3B,MAAM,GAAG,GAAG,WAAW,CAAC,MAAM,CAAA;IAE9B,gCAAgC;IAChC,IAAI,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,0BAA0B,CAAC,CAAA;IACjE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,IAAI,GAAG,EAAE,CAAC;YACR;;;;;eAKG;YACH,QAAQ,GAAG,GAAG,CAAA;QAChB,CAAC;aAAM,CAAC;YACN;;;eAGG;YACH,QAAQ,GAAG,QAAQ,qBAAM,CAAC,UAAU,EAAE,EAAE,CAAA;QAC1C,CAAC;IACH,CAAC;IAED,gCAAgC;IAChC,IAAI,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,2BAA2B,CAAC,CAAA;IACnE,IAAI,CAAC,SAAS,EAAE,CAAC;QACf;;;WAGG;QACH,SAAS,GAAG,QAAQ,qBAAM,CAAC,UAAU,EAAE,EAAE,CAAA;IAC3C,CAAC;IAED,OAAO;QACL,GAAG;QACH,QAAQ;QACR,SAAS;KACV,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,SAAgB,iDAAiD,CAC/D,WAAkC;IAElC,OAAO;QACL,GAAG,EAAE,WAAW,CAAC,UAAU,EAAE,GAAG;QAChC,QAAQ,EAAE,WAAW,CAAC,UAAU,EAAE,QAAQ;QAC1C,SAAS,EAAE,WAAW,CAAC,UAAU,EAAE,SAAS;KAC7C,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,mCAAmC,CACjD,iBAAoC;IAEpC,OAAO;QACL,IAAI,EAAE;YACJ,QAAQ,EAAE,iBAAiB,CAAC,QAAQ;YACpC,SAAS,EAAE,iBAAiB,CAAC,SAAS;SACvC;QACD,OAAO,EAAE;YACP,GAAG,EAAE,iBAAiB,CAAC,GAAG,IAAI,SAAS;SACxC;KACF,CAAA;AACH,CAAC","sourcesContent":["import crypto from 'node:crypto'\nimport { type UserContext as GrowthBookUserContext } from '@growthbook/growthbook'\nimport { ParsedUserContext, RawUserContext, TrackingMetadata } from './types'\n\n/**\n * These need to match what the client sends\n */\nconst ANALYTICS_HEADER_DEVICE_ID = 'X-Bsky-Device-Id'\nconst ANALYTICS_HEADER_SESSION_ID = 'X-Bsky-Session-Id'\n\n/**\n * Parse the `RawUserContext` into a `ParsedUserContext` that is used as\n * GrowthBook `attributes` as well as the metadata payload for our analytics\n * events. This ensures that the same user properties are used for both feature\n * gate targeting and analytics.\n */\nexport function parseRawUserContext(\n  userContext: RawUserContext,\n): ParsedUserContext {\n  const did = userContext.viewer\n\n  // prioritize passthrough header\n  let deviceId = userContext.req.header(ANALYTICS_HEADER_DEVICE_ID)\n  if (!deviceId) {\n    if (did) {\n      /*\n       * If we don't have a device header, fall back to the DID. Our event\n       * proxy ensures ordering based on this deviceId (also called a stableId\n       * in the proxy), so if we have a DID, we want to use it to ensure client\n       * and server events are properly ordered.\n       */\n      deviceId = did\n    } else {\n      /*\n       * Without any better option for identifying the user, we generate a\n       * random deviceId.\n       */\n      deviceId = `anon-${crypto.randomUUID()}`\n    }\n  }\n\n  // prioritize passthrough header\n  let sessionId = userContext.req.header(ANALYTICS_HEADER_SESSION_ID)\n  if (!sessionId) {\n    /*\n     * Without any better option for identifying the user, we generate a\n     * random deviceId.\n     */\n    sessionId = `anon-${crypto.randomUUID()}`\n  }\n\n  return {\n    did,\n    deviceId,\n    sessionId,\n  }\n}\n\n/**\n * Extract the `ParsedUserContext` from the GrowthBook `UserContext`, which we\n * passed into `isOn` as `attributes`.\n */\nexport function extractParsedUserContextFromGrowthBookUserContext(\n  userContext: GrowthBookUserContext,\n): ParsedUserContext {\n  return {\n    did: userContext.attributes?.did,\n    deviceId: userContext.attributes?.deviceId,\n    sessionId: userContext.attributes?.sessionId,\n  }\n}\n\n/**\n * Convert the `ParsedUserContext` into the `TrackingMetadata` format that we\n * use for our analytics events. This ensures that we have the same user\n * properties as we do for events from our client app.\n */\nexport function parsedUserContextToTrackingMetadata(\n  parsedUserContext: ParsedUserContext,\n): TrackingMetadata {\n  return {\n    base: {\n      deviceId: parsedUserContext.deviceId,\n      sessionId: parsedUserContext.sessionId,\n    },\n    session: {\n      did: parsedUserContext.did ?? undefined,\n    },\n  }\n}\n"]}

package/dist/hydration/hydrator.d.ts

@@ -1,5 +1,5 @@
 import { DataPlaneClient } from '../data-plane/client';
-import { type CheckedFeatureGatesMap } from '../feature-gates';
+import { type CheckedFeatureGatesMap } from '../feature-gates/types';
 import { Record as ProfileRecord } from '../lexicon/types/app/bsky/actor/profile';
 import { Bookmark, BookmarkInfo, Notification } from '../proto/bsky_pb';
 import { ParsedLabelers } from '../util';
@@ -16,7 +16,12 @@ export declare class HydrateCtx {
     overrideIncludeTakedownsForActor: boolean | undefined;
     include3pBlocks: boolean | undefined;
     includeDebugField: boolean | undefined;
-    featureGates: CheckedFeatureGatesMap;
+    /**
+     * Cache of evaluated feature gates to be used in a given request lifecycle.
+     * The actual evaluations happen at the top of the route handler and the
+     * results are stored in this map.
+     */
+    featureGatesMap: CheckedFeatureGatesMap;
     constructor(vals: HydrateCtxVals);
     get skipCacheForViewer(): string[] | undefined;
     copy<V extends Partial<HydrateCtxVals>>(vals?: V): HydrateCtx & V;
@@ -28,7 +33,7 @@ export type HydrateCtxVals = {
     overrideIncludeTakedownsForActor?: boolean;
     include3pBlocks?: boolean;
     includeDebugField?: boolean;
-    featureGates?: CheckedFeatureGatesMap;
+    featureGatesMap?: CheckedFeatureGatesMap;
 };
 export type HydrationState = {
     ctx?: HydrateCtx;

package/dist/hydration/hydrator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hydrator.d.ts","sourceRoot":"","sources":["../../src/hydration/hydrator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hydrator.d.ts","sourceRoot":"","sources":["../../src/hydration/hydrator.ts"],"names":[],"mappings":"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"}

package/dist/hydration/hydrator.js

@@ -7,7 +7,6 @@ exports.mergeManyStates = exports.mergeStates = exports.Hydrator = exports.Hydra
 const node_assert_1 = __importDefault(require("node:assert"));
 const common_1 = require("@atproto/common");
 const syntax_1 = require("@atproto/syntax");
-const feature_gates_1 = require("../feature-gates");
 const lexicons_1 = require("../lexicon/lexicons");
 const record_1 = require("../lexicon/types/app/bsky/embed/record");
 const recordWithMedia_1 = require("../lexicon/types/app/bsky/embed/recordWithMedia");
@@ -63,11 +62,16 @@ class HydrateCtx {
             writable: true,
             value: this.vals.includeDebugField
         });
-        Object.defineProperty(this, "featureGates", {
+        /**
+         * Cache of evaluated feature gates to be used in a given request lifecycle.
+         * The actual evaluations happen at the top of the route handler and the
+         * results are stored in this map.
+         */
+        Object.defineProperty(this, "featureGatesMap", {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: this.vals.featureGates || new Map()
+            value: this.vals.featureGatesMap || new Map()
         });
     }
     // Convenience with use with dataplane.getActors cache control
@@ -553,7 +557,7 @@ class Hydrator {
     //       - list basic
     async hydrateThreadPosts(refs, ctx) {
         const postsState = await this.hydratePosts(refs, ctx, undefined, {
-            processDynamicTagsForView: ctx.featureGates.get(feature_gates_1.FeatureGateID.ThreadsReplyRankingExplorationEnable)
+            processDynamicTagsForView: ctx.featureGatesMap.get('threads:reply_ranking_exploration:enable')
                 ? 'thread'
                 : undefined,
         });
@@ -1002,7 +1006,7 @@ class Hydrator {
             includeTakedowns: vals.includeTakedowns,
             include3pBlocks: vals.include3pBlocks,
             includeDebugField,
-            featureGates: vals.featureGates,
+            featureGatesMap: vals.featureGatesMap,
         });
     }
     async resolveUri(uriStr) {