@statsig/serverless-client 3.28.0

package/LICENSE

@@ -0,0 +1,14 @@
+ISC License (ISC)
+Copyright (c) 2021, Statsig, Inc.
+
+Permission to use, copy, modify, and/or distribute this software for any purpose
+with or without fee is hereby granted, provided that the above copyright notice
+and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS
+OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
+TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF
+THIS SOFTWARE.

package/README.md

@@ -0,0 +1,49 @@
+Statsig helps you move faster with feature gates (feature flags), and/or dynamic configs. It also allows you to run A/B/n tests to validate your new features and understand their impact on your KPIs. If you're new to Statsig, check out our product and create an account at [statsig.com](https://www.statsig.com/?ref=gh_jsm).
+
+<h1 align="center">
+	<a href="https://statsig.com/?ref=gh_jsm">
+		<img src="https://github.com/statsig-io/js-client-monorepo/assets/95646168/ae5499ed-20ff-4584-bf21-8857f800d485" />
+	</a>
+    <div />
+	<a href="https://statsig.com/?ref=gh_jsm">Statsig</a>
+</h1>
+
+<p align="center">
+	<a href="https://github.com/statsig-io/js-client-monorepo/blob/main/LICENSE">
+        	<img src="https://img.shields.io/badge/license-ISC-blue.svg?colorA=1b2528&colorB=ccfbc7&style=for-the-badge">
+    	</a>
+	<a href="https://www.npmjs.com/package/@statsig/js-client">
+        	<img src="https://img.shields.io/npm/v/@statsig/js-client.svg?colorA=1b2528&colorB=b2d3ff&style=for-the-badge">
+    	</a>
+	<a href="https://statsig.com/community?ref=gh_jsm">
+        	<img src="https://img.shields.io/badge/slack-statsig-brightgreen.svg?logo=slack&colorA=1b2528&colorB=FFF8BA&style=for-the-badge">
+    	</a>
+</p>
+
+## Getting Started
+
+Read through the [Documentation](https://docs.statsig.com/client/javascript-sdk?ref=gh_jsm) or check out the [Samples](samples/).
+
+## Packages
+
+Clients
+
+- Precomputed Evaluations (Recommended) [[npm](https://www.npmjs.com/package/@statsig/js-client)] [[source](https://github.com/statsig-io/js-client-monorepo/tree/main/packages/js-client)]
+- On Device Evaluations [[npm](https://www.npmjs.com/package/@statsig/js-on-device-eval-client)] [[source](https://github.com/statsig-io/js-client-monorepo/tree/main/packages/js-on-device-eval-client)]
+
+Product Bundles
+
+- Session Replay [[npm](https://www.npmjs.com/package/@statsig/session-replay)] [[source](https://github.com/statsig-io/js-client-monorepo/tree/main/packages/session-replay)]
+- Web Analytics [[npm](https://www.npmjs.com/package/@statsig/web-analytics)] [[source](https://github.com/statsig-io/js-client-monorepo/tree/main/packages/web-analytics)]
+
+Framework Specific Bindings
+
+- React [[npm](https://www.npmjs.com/package/@statsig/react-bindings)] [[source](https://github.com/statsig-io/js-client-monorepo/tree/main/packages/react-bindings)]
+
+- React Native [[npm](https://www.npmjs.com/package/@statsig/react-native-bindings)] [[source](https://github.com/statsig-io/js-client-monorepo/tree/main/packages/react-native-bindings)]
+
+- React Native (Expo) [[npm](https://www.npmjs.com/package/@statsig/expo-bindings)] [[source](https://github.com/statsig-io/js-client-monorepo/tree/main/packages/expo-bindings)]
+
+## Community
+
+If you need any assistance or just have a question, feel free to reach out to us on [Slack](https://statsig.com/community?ref=gh_jsm).

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@statsig/serverless-client",
+  "version": "3.28.0",
+  "license": "ISC",
+  "homepage": "https://github.com/statsig-io/js-client-monorepo",
+  "repository": {
+    "type": "git",
+    "url": "github:statsig-io/js-client-monorepo",
+    "directory": "packages/serverless"
+  },
+  "dependencies": {
+    "@statsig/client-core": "3.28.0",
+    "@statsig/js-on-device-eval-client": "3.28.0"
+  },
+  "type": "commonjs",
+  "main": "./src/index.js",
+  "typings": "./src/index.d.ts",
+  "exports": {
+    "./cloudflare": {
+      "types": "./src/provider/cloudflare.d.ts",
+      "default": "./src/provider/cloudflare.js"
+    }
+  },
+  "devDependencies": {
+    "ts-node": "^10.9.1"
+  }
+}

package/src/StatsigServerlessClient.d.ts

@@ -0,0 +1,4 @@
+import { StatsigOnDeviceEvalClient, StatsigOptions } from '@statsig/js-on-device-eval-client';
+export declare class StatsigServerlessClient extends StatsigOnDeviceEvalClient {
+    constructor(sdkKey: string, options?: StatsigOptions | null);
+}

package/src/StatsigServerlessClient.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StatsigServerlessClient = void 0;
+const js_on_device_eval_client_1 = require("@statsig/js-on-device-eval-client");
+class StatsigServerlessClient extends js_on_device_eval_client_1.StatsigOnDeviceEvalClient {
+    constructor(sdkKey, options = null) {
+        const edgeSafeOptions = Object.assign({ disableStorage: true, loggingEnabled: 'always', includeCurrentPageUrlWithEvents: false }, options);
+        super(sdkKey, edgeSafeOptions);
+    }
+}
+exports.StatsigServerlessClient = StatsigServerlessClient;

package/src/index.d.ts

@@ -0,0 +1,2 @@
+export type { StatsigUser, FeatureGateEvaluationOptions, } from '@statsig/client-core';
+export type { StatsigOptions } from '@statsig/js-on-device-eval-client';

package/src/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/src/provider/cloudflare.d.ts

@@ -0,0 +1,28 @@
+import { StatsigUpdateDetails } from '@statsig/client-core';
+import type { StatsigOptions } from '@statsig/js-on-device-eval-client';
+import { StatsigServerlessClient } from '../StatsigServerlessClient';
+type KVNamespace = {
+    get(key: string): Promise<string | null>;
+};
+export type { StatsigUser, FeatureGateEvaluationOptions, } from '@statsig/client-core';
+export type { StatsigOptions } from '@statsig/js-on-device-eval-client';
+export declare class StatsigCloudflareClient extends StatsigServerlessClient {
+    initializeFromKV(kvBinding: KVNamespace, kvKey: string): Promise<StatsigUpdateDetails>;
+}
+interface ExecutionContext {
+    waitUntil(promise: Promise<any>): void;
+}
+type Env = Record<string, any>;
+export interface statsig {
+    (request: Request, env: Env, ctx: ExecutionContext, client: StatsigCloudflareClient): Promise<Response> | Response;
+}
+export interface paramsObject {
+    kvKey: string;
+    envStatsigKey: string;
+    envKvBindingName: string;
+    statsigOptions?: StatsigOptions;
+}
+interface WorkerExport {
+    fetch(request: Request, env: Env, ctx: ExecutionContext): Promise<Response>;
+}
+export declare function handleWithStatsig(handler: statsig, params: paramsObject): WorkerExport;

package/src/provider/cloudflare.js

@@ -0,0 +1,102 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleWithStatsig = exports.StatsigCloudflareClient = void 0;
+const client_core_1 = require("@statsig/client-core");
+const StatsigServerlessClient_1 = require("../StatsigServerlessClient");
+class StatsigCloudflareClient extends StatsigServerlessClient_1.StatsigServerlessClient {
+    initializeFromKV(kvBinding, kvKey) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const startTime = performance.now();
+            if (!kvBinding) {
+                client_core_1.Log.error('Invalid KV binding provided');
+                return {
+                    duration: performance.now() - startTime,
+                    source: 'Bootstrap',
+                    success: false,
+                    error: new Error('Invalid KV binding provided'),
+                    sourceUrl: null,
+                };
+            }
+            if (!kvKey || typeof kvKey !== 'string' || kvKey.trim().length === 0) {
+                client_core_1.Log.error('Invalid KV key provided');
+                return {
+                    duration: performance.now() - startTime,
+                    source: 'Bootstrap',
+                    success: false,
+                    error: new Error('Invalid KV key provided'),
+                    sourceUrl: null,
+                };
+            }
+            try {
+                const specs = yield kvBinding.get(kvKey);
+                if (specs) {
+                    this.dataAdapter.setData(specs);
+                    return this.initializeSync({
+                        disableBackgroundCacheRefresh: true,
+                    });
+                }
+                else {
+                    client_core_1.Log.error(`Failed to fetch specs from Cloudflare KV for key "${kvKey}"`);
+                    return {
+                        duration: performance.now() - startTime,
+                        source: 'Bootstrap',
+                        success: false,
+                        error: new Error(`Failed to fetch specs from Cloudflare KV for key "${kvKey}"`),
+                        sourceUrl: null,
+                    };
+                }
+            }
+            catch (error) {
+                client_core_1.Log.error(`Failed to fetch specs from Cloudflare KV for key: "${kvKey}"`, error);
+                return {
+                    duration: performance.now() - startTime,
+                    source: 'Bootstrap',
+                    success: false,
+                    error: new Error(`Failed to fetch specs from Cloudflare KV for key: "${kvKey}"`),
+                    sourceUrl: null,
+                };
+            }
+        });
+    }
+}
+exports.StatsigCloudflareClient = StatsigCloudflareClient;
+function handleWithStatsig(handler, params) {
+    return {
+        fetch(request, env, ctx) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const envStatsigKey = params.envStatsigKey;
+                const envKvBindingName = params.envKvBindingName;
+                const kvKey = params.kvKey;
+                if (!env[envStatsigKey]) {
+                    return new Response(JSON.stringify({
+                        error: `Missing ${envStatsigKey} environment variable`,
+                    }), {
+                        headers: { 'Content-Type': 'application/json' },
+                    });
+                }
+                if (!env[envKvBindingName]) {
+                    return new Response(JSON.stringify({ error: `Missing ${envKvBindingName} Binding` }), {
+                        headers: { 'Content-Type': 'application/json' },
+                    });
+                }
+                const client = new StatsigCloudflareClient(env[envStatsigKey], params.statsigOptions);
+                yield client.initializeFromKV(env[envKvBindingName], env[kvKey]);
+                const response = yield handler(request, env, ctx, client);
+                if (response.status >= 200 && response.status < 300) {
+                    ctx.waitUntil(client.flush());
+                }
+                return response;
+            });
+        },
+    };
+}
+exports.handleWithStatsig = handleWithStatsig;