@launchdarkly/node-server-sdk-dynamodb 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+
+## 0.1.0 (2023-06-15)
+
+
+### Features
+
+* Implement support for the DynamoDB persistent store. ([#158](https://github.com/launchdarkly/js-core/issues/158)) ([eaa063e](https://github.com/launchdarkly/js-core/commit/eaa063e4daaf4710cf4c3fc502bbdfb2108c829d))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * devDependencies
+    * @launchdarkly/node-server-sdk bumped from 0.4.4 to 0.5.0

package/LICENSE

@@ -0,0 +1,13 @@
+Copyright 2023 Catamorphic, Co.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,110 @@
+# LaunchDarkly Server-Side SDK for Node.js
+
+[![NPM][node-dynamodb-npm-badge]][node-dynamodb-npm-link]
+[![Actions Status][node-dynamodb-ci-badge]][node-dynamodb-ci]
+[![Documentation](https://img.shields.io/static/v1?label=GitHub+Pages&message=API+reference&color=00add8)](https://launchdarkly.github.io/js-core/packages/store/node-server-sdk-dynamodb/docs/)
+
+This library provides a DynamoDB-backed persistence mechanism (feature store) for the [LaunchDarkly Node.js SDK](https://github.com/launchdarkly/js-core/packages/sdk/server-node), replacing the default in-memory feature store. It uses the AWS SDK for Node.js.
+The minimum version of the LaunchDarkly Server-Side SDK for Node for use with this library is 8.0.0. 
+
+This SDK is a beta version and should not be considered ready for production use while this message is visible.
+
+## LaunchDarkly overview
+
+[LaunchDarkly](https://www.launchdarkly.com) is a feature management platform that serves over 100 billion feature flags daily to help teams build better software, faster. [Get started](https://docs.launchdarkly.com/home/getting-started) using LaunchDarkly today!
+
+[![Twitter Follow](https://img.shields.io/twitter/follow/launchdarkly.svg?style=social&label=Follow&maxAge=2592000)](https://twitter.com/intent/follow?screen_name=launchdarkly)
+
+## Supported Node versions
+
+This package is compatible with Node.js versions 14 and above.
+
+## Getting started
+
+Refer to [Using DynamoDB as a persistent feature store](https://docs.launchdarkly.com/sdk/features/storing-data/dynamodb#nodejs-server-side).
+
+## Quick setup
+
+1. In DynamoDB, create a table which has the following schema: a partition key called "namespace" and a sort key called "key", both with a string type. The LaunchDarkly library does not create the table automatically, because it has no way of knowing what additional properties (such as permissions and throughput) you would want it to have.
+
+2. Install this package with `npm` or `yarn`:
+
+`npm install launchdarkly-node-server-sdk-dynamodb --save`
+
+3. If your application does not already have its own dependency on the `@aws-sdk/client-dynamodb` package, and if it will _not_ be running in AWS Lambda, add `@aws-sdk/client-dynamodb` as well:
+
+`npm install @aws-sdk/client-dynamodb --save`
+
+The `launchdarkly-node-server-sdk-dynamodb` package does not provide `@aws-sdk/client-dynamodb` as a transitive dependency, because it is provided automatically by the Lambda runtime and this would unnecessarily increase the size of applications deployed in Lambda. Therefore, if you are not using Lambda you need to provide `@aws-sdk/client-dynamodb` separately.
+
+4. Import the package:
+
+```typescript
+const { DynamoDBFeatureStoreFactory } = require('launchdarkly-node-server-sdk-dynamodb');
+```
+
+5. When configuring your SDK client, add the DynamoDB feature store:
+
+```typescript
+const store = DynamoDBFeatureStoreFactory('YOUR TABLE NAME');
+const config = { featureStore: store };
+const client = LaunchDarkly.init('YOUR SDK KEY', config);
+```
+
+By default, the DynamoDB client will try to get your AWS credentials and region name from environment variables and/or local configuration files, as described in the AWS SDK documentation. You can also specify any valid [DynamoDB client options](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/DynamoDB.html#constructor-property) like this:
+
+```typescript
+const dynamoDBOptions = { accessKeyId: 'YOUR KEY', secretAccessKey: 'YOUR SECRET' };
+const store = DynamoDBFeatureStoreFactory('YOUR TABLE NAME', { clientOptions: dynamoDBOptions });
+```
+
+Alternatively, if you already have a fully configured DynamoDB client object, you can tell LaunchDarkly to use that:
+
+```typescript
+const store = DynamoDBFeatureStoreFactory('YOUR TABLE NAME', { dynamoDBClient: myDynamoDBClientInstance });
+```
+
+6. If you are running a [LaunchDarkly Relay Proxy](https://github.com/launchdarkly/ld-relay) instance, or any other process that will pre-populate the DynamoDB table with feature flags from LaunchDarkly, you can use [daemon mode](https://github.com/launchdarkly/ld-relay#daemon-mode), so that the SDK retrieves flag data only from DynamoDB and does not communicate directly with LaunchDarkly. This is controlled by the SDK's `useLdd` option:
+
+```typescript
+const config = { featureStore: store, useLdd: true };
+const client = LaunchDarkly.init('YOUR SDK KEY', config);
+```
+
+7. If the same DynamoDB table is being shared by SDK clients for different LaunchDarkly environments, set the `prefix` option to a different short string for each one to keep the keys from colliding:
+
+```typescript
+const store = DynamoDBFeatureStoreFactory('YOUR TABLE NAME', { prefix: 'env1' });
+```
+
+## Caching behavior
+
+To reduce traffic to DynamoDB, there is an optional in-memory cache that retains the last known data for a configurable amount of time. This is on by default; to turn it off (and guarantee that the latest feature flag data will always be retrieved from DynamoDB for every flag evaluation), configure the store as follows:
+
+```typescript
+const factory = DynamoDBFeatureStoreFactory({ cacheTTL: 0 });
+```
+
+## Contributing
+
+We encourage pull requests and other contributions from the community. Check out our [contributing guidelines](CONTRIBUTING.md) for instructions on how to contribute to this SDK.
+
+## About LaunchDarkly
+
+- LaunchDarkly is a continuous delivery platform that provides feature flags as a service and allows developers to iterate quickly and safely. We allow you to easily flag your features and manage them from the LaunchDarkly dashboard. With LaunchDarkly, you can:
+  - Roll out a new feature to a subset of your users (like a group of users who opt-in to a beta tester group), gathering feedback and bug reports from real-world use cases.
+  - Gradually roll out a feature to an increasing percentage of users, and track the effect that the feature has on key metrics (for instance, how likely is a user to complete a purchase if they have feature A versus feature B?).
+  - Turn off a feature that you realize is causing performance problems in production, without needing to re-deploy, or even restart the application with a changed configuration file.
+  - Grant access to certain features based on user attributes, like payment plan (eg: users on the ‘gold’ plan get access to more features than users in the ‘silver’ plan). Disable parts of your application to facilitate maintenance, without taking everything offline.
+- LaunchDarkly provides feature flag SDKs for a wide variety of languages and technologies. Check out [our documentation](https://docs.launchdarkly.com/sdk) for a complete list.
+- Explore LaunchDarkly
+  - [launchdarkly.com](https://www.launchdarkly.com/ 'LaunchDarkly Main Website') for more information
+  - [docs.launchdarkly.com](https://docs.launchdarkly.com/ 'LaunchDarkly Documentation') for our documentation and SDK reference guides
+  - [apidocs.launchdarkly.com](https://apidocs.launchdarkly.com/ 'LaunchDarkly API Documentation') for our API documentation
+  - [blog.launchdarkly.com](https://blog.launchdarkly.com/ 'LaunchDarkly Blog Documentation') for the latest product updates
+
+[node-dynamodb-ci-badge]: https://github.com/launchdarkly/js-core/actions/workflows/node-dynamodb.yml/badge.svg
+[node-dynamodb-ci]: https://github.com/launchdarkly/js-core/actions/workflows/node-dynamodb.yml
+
+[node-dynamodb-npm-badge]: https://img.shields.io/npm/v/@launchdarkly/node-server-sdk-dynamodb.svg?style=flat-square
+[node-dynamodb-npm-link]: https://www.npmjs.com/package/@launchdarkly/node-server-sdk-dynamodb

package/dist/src/DynamoDBBigSegmentStore.d.ts

@@ -0,0 +1,12 @@
+import { LDLogger, interfaces } from '@launchdarkly/node-server-sdk';
+import LDDynamoDBOptions from './LDDynamoDBOptions';
+export default class DynamoDBBigSegmentStore implements interfaces.BigSegmentStore {
+    private readonly tableName;
+    private readonly logger?;
+    private state;
+    constructor(tableName: string, options?: LDDynamoDBOptions, logger?: LDLogger | undefined);
+    getMetadata(): Promise<interfaces.BigSegmentStoreMetadata | undefined>;
+    getUserMembership(userHash: string): Promise<interfaces.BigSegmentStoreMembership | undefined>;
+    close(): void;
+}
+//# sourceMappingURL=DynamoDBBigSegmentStore.d.ts.map

package/dist/src/DynamoDBBigSegmentStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DynamoDBBigSegmentStore.d.ts","sourceRoot":"","sources":["../../src/DynamoDBBigSegmentStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,iBAAiB,MAAM,qBAAqB,CAAC;AAkCpD,MAAM,CAAC,OAAO,OAAO,uBAAwB,YAAW,UAAU,CAAC,eAAe;IAO9E,OAAO,CAAC,QAAQ,CAAC,SAAS;IAE1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAR1B,OAAO,CAAC,KAAK,CAAsB;gBAMhB,SAAS,EAAE,MAAM,EAClC,OAAO,CAAC,EAAE,iBAAiB,EACV,MAAM,CAAC,sBAAU;IAK9B,WAAW,IAAI,OAAO,CAAC,UAAU,CAAC,uBAAuB,GAAG,SAAS,CAAC;IAetE,iBAAiB,CACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,CAAC,yBAAyB,GAAG,SAAS,CAAC;IAsB5D,KAAK,IAAI,IAAI;CAGd"}

package/dist/src/DynamoDBBigSegmentStore.js

@@ -0,0 +1,92 @@
+"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.ATTR_EXCLUDED = exports.ATTR_INCLUDED = exports.ATTR_SYNC_ON = exports.KEY_USER_DATA = exports.KEY_METADATA = void 0;
+const DynamoDBClientState_1 = require("./DynamoDBClientState");
+const Value_1 = require("./Value");
+/**
+ * Exported for testing.
+ * @internal
+ */
+exports.KEY_METADATA = 'big_segments_metadata';
+/**
+ * Exported for testing.
+ * @internal
+ */
+exports.KEY_USER_DATA = 'big_segments_user';
+/**
+ * Exported for testing.
+ * @internal
+ */
+exports.ATTR_SYNC_ON = 'synchronizedOn';
+/**
+ * Exported for testing.
+ * @internal
+ */
+exports.ATTR_INCLUDED = 'included';
+/**
+ * Exported for testing.
+ * @internal
+ */
+exports.ATTR_EXCLUDED = 'excluded';
+class DynamoDBBigSegmentStore {
+    // Logger is not currently used, but is included to reduce the chance of a
+    // compatibility break to add a log.
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    constructor(tableName, options, logger) {
+        this.tableName = tableName;
+        this.logger = logger;
+        this.state = new DynamoDBClientState_1.default(options);
+    }
+    getMetadata() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const key = this.state.prefixedKey(exports.KEY_METADATA);
+            const data = yield this.state.get(this.tableName, {
+                namespace: (0, Value_1.stringValue)(key),
+                key: (0, Value_1.stringValue)(key),
+            });
+            if (data) {
+                const attr = data[exports.ATTR_SYNC_ON];
+                if (attr && attr.N) {
+                    return { lastUpToDate: parseInt(attr.N, 10) };
+                }
+            }
+            return {};
+        });
+    }
+    getUserMembership(userHash) {
+        var _a, _b;
+        return __awaiter(this, void 0, void 0, function* () {
+            const data = yield this.state.get(this.tableName, {
+                namespace: (0, Value_1.stringValue)(this.state.prefixedKey(exports.KEY_USER_DATA)),
+                key: (0, Value_1.stringValue)(userHash),
+            });
+            if (data) {
+                const excludedRefs = data[exports.ATTR_EXCLUDED];
+                const includedRefs = data[exports.ATTR_INCLUDED];
+                const membership = {};
+                (_a = excludedRefs === null || excludedRefs === void 0 ? void 0 : excludedRefs.SS) === null || _a === void 0 ? void 0 : _a.forEach((ref) => {
+                    membership[ref] = false;
+                });
+                (_b = includedRefs === null || includedRefs === void 0 ? void 0 : includedRefs.SS) === null || _b === void 0 ? void 0 : _b.forEach((ref) => {
+                    membership[ref] = true;
+                });
+                return membership;
+            }
+            return undefined;
+        });
+    }
+    close() {
+        this.state.close();
+    }
+}
+exports.default = DynamoDBBigSegmentStore;
+//# sourceMappingURL=DynamoDBBigSegmentStore.js.map

package/dist/src/DynamoDBBigSegmentStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DynamoDBBigSegmentStore.js","sourceRoot":"","sources":["../../src/DynamoDBBigSegmentStore.ts"],"names":[],"mappings":";;;;;;;;;;;;AAEA,+DAAwD;AACxD,mCAAsC;AAEtC;;;GAGG;AACU,QAAA,YAAY,GAAG,uBAAuB,CAAC;AAEpD;;;GAGG;AACU,QAAA,aAAa,GAAG,mBAAmB,CAAC;AAEjD;;;GAGG;AACU,QAAA,YAAY,GAAG,gBAAgB,CAAC;AAE7C;;;GAGG;AACU,QAAA,aAAa,GAAG,UAAU,CAAC;AAExC;;;GAGG;AACU,QAAA,aAAa,GAAG,UAAU,CAAC;AAExC,MAAqB,uBAAuB;IAG1C,0EAA0E;IAC1E,oCAAoC;IACpC,6DAA6D;IAC7D,YACmB,SAAiB,EAClC,OAA2B,EACV,MAAiB;QAFjB,cAAS,GAAT,SAAS,CAAQ;QAEjB,WAAM,GAAN,MAAM,CAAW;QAElC,IAAI,CAAC,KAAK,GAAG,IAAI,6BAAmB,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;IAEK,WAAW;;YACf,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,oBAAY,CAAC,CAAC;YACjD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE;gBAChD,SAAS,EAAE,IAAA,mBAAW,EAAC,GAAG,CAAC;gBAC3B,GAAG,EAAE,IAAA,mBAAW,EAAC,GAAG,CAAC;aACtB,CAAC,CAAC;YACH,IAAI,IAAI,EAAE;gBACR,MAAM,IAAI,GAAG,IAAI,CAAC,oBAAY,CAAC,CAAC;gBAChC,IAAI,IAAI,IAAI,IAAI,CAAC,CAAC,EAAE;oBAClB,OAAO,EAAE,YAAY,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAE,EAAE,EAAE,CAAC,EAAE,CAAC;iBAChD;aACF;YACD,OAAO,EAAE,CAAC;QACZ,CAAC;KAAA;IAEK,iBAAiB,CACrB,QAAgB;;;YAEhB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE;gBAChD,SAAS,EAAE,IAAA,mBAAW,EAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,qBAAa,CAAC,CAAC;gBAC7D,GAAG,EAAE,IAAA,mBAAW,EAAC,QAAQ,CAAC;aAC3B,CAAC,CAAC;YACH,IAAI,IAAI,EAAE;gBACR,MAAM,YAAY,GAAG,IAAI,CAAC,qBAAa,CAAC,CAAC;gBACzC,MAAM,YAAY,GAAG,IAAI,CAAC,qBAAa,CAAC,CAAC;gBAEzC,MAAM,UAAU,GAAyC,EAAE,CAAC;gBAE5D,MAAA,YAAY,aAAZ,YAAY,uBAAZ,YAAY,CAAE,EAAE,0CAAE,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;oBAChC,UAAU,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;gBAC1B,CAAC,CAAC,CAAC;gBACH,MAAA,YAAY,aAAZ,YAAY,uBAAZ,YAAY,CAAE,EAAE,0CAAE,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;oBAChC,UAAU,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;gBACzB,CAAC,CAAC,CAAC;gBACH,OAAO,UAAU,CAAC;aACnB;YACD,OAAO,SAAS,CAAC;;KAClB;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF;AAxDD,0CAwDC"}

package/dist/src/DynamoDBBigSegmentStoreFactory.d.ts

@@ -0,0 +1,16 @@
+import { LDOptions, interfaces } from '@launchdarkly/node-server-sdk';
+import LDDynamoDBOptions from './LDDynamoDBOptions';
+/**
+ * Configures a big segment store factory backed by a DynamoDB instance.
+ *
+ * "Big segments" are a specific type of user segments. For more information, read the
+ * LaunchDarkly documentation about user segments: https://docs.launchdarkly.com/home/users/segments
+ *
+ * @param tableName The table name in DynamoDB (required). The table must already exist.
+ *   See: https://docs.launchdarkly.com/sdk/features/storing-data/dynamodb
+ * @param options Optional configuration (required), please refer to {@link LDDynamoDBOptions}.
+ *
+ * @returns A function which creates big segment stores based on the provided config.
+ */
+export default function DynamoDBBigSegmentStoreFactory(tableName: string, options?: LDDynamoDBOptions): (config: LDOptions) => interfaces.BigSegmentStore;
+//# sourceMappingURL=DynamoDBBigSegmentStoreFactory.d.ts.map

package/dist/src/DynamoDBBigSegmentStoreFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DynamoDBBigSegmentStoreFactory.d.ts","sourceRoot":"","sources":["../../src/DynamoDBBigSegmentStoreFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,iBAAiB,MAAM,qBAAqB,CAAC;AAGpD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,OAAO,UAAU,8BAA8B,CACpD,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,CAAC,MAAM,EAAE,SAAS,KAAK,UAAU,CAAC,eAAe,CAEnD"}

package/dist/src/DynamoDBBigSegmentStoreFactory.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const DynamoDBBigSegmentStore_1 = require("./DynamoDBBigSegmentStore");
+/**
+ * Configures a big segment store factory backed by a DynamoDB instance.
+ *
+ * "Big segments" are a specific type of user segments. For more information, read the
+ * LaunchDarkly documentation about user segments: https://docs.launchdarkly.com/home/users/segments
+ *
+ * @param tableName The table name in DynamoDB (required). The table must already exist.
+ *   See: https://docs.launchdarkly.com/sdk/features/storing-data/dynamodb
+ * @param options Optional configuration (required), please refer to {@link LDDynamoDBOptions}.
+ *
+ * @returns A function which creates big segment stores based on the provided config.
+ */
+function DynamoDBBigSegmentStoreFactory(tableName, options) {
+    return (config) => new DynamoDBBigSegmentStore_1.default(tableName, options, config.logger);
+}
+exports.default = DynamoDBBigSegmentStoreFactory;
+//# sourceMappingURL=DynamoDBBigSegmentStoreFactory.js.map

package/dist/src/DynamoDBBigSegmentStoreFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DynamoDBBigSegmentStoreFactory.js","sourceRoot":"","sources":["../../src/DynamoDBBigSegmentStoreFactory.ts"],"names":[],"mappings":";;AAEA,uEAAgE;AAEhE;;;;;;;;;;;GAWG;AACH,SAAwB,8BAA8B,CACpD,SAAiB,EACjB,OAA2B;IAE3B,OAAO,CAAC,MAAiB,EAAE,EAAE,CAAC,IAAI,iCAAuB,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;AAC/F,CAAC;AALD,iDAKC"}

package/dist/src/DynamoDBClientState.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=DynamoDBClientState.d.ts.map

package/dist/src/DynamoDBClientState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DynamoDBClientState.d.ts","sourceRoot":"","sources":["../../src/DynamoDBClientState.ts"],"names":[],"mappings":""}

package/dist/src/DynamoDBClientState.js

@@ -0,0 +1,132 @@
+"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());
+    });
+};
+var __asyncValues = (this && this.__asyncValues) || function (o) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var m = o[Symbol.asyncIterator], i;
+    return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i);
+    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }
+    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const client_dynamodb_1 = require("@aws-sdk/client-dynamodb");
+// Unlike some other database integrations where the key prefix is mandatory and has
+// a default value, in DynamoDB it is fine to not have a prefix. If there is one, we
+// prepend it to keys with a ':' separator.
+const DEFAULT_PREFIX = '';
+// BatchWrite can only accept 25 items at a time, so split up the writes into batches of 25.
+const WRITE_BATCH_SIZE = 25;
+/**
+ * Class for managing the state of a dynamodb client.
+ *
+ * Used for the dynamodb persistent store as well as the dynamodb big segment store.
+ *
+ * @internal
+ */
+class DynamoDBClientState {
+    constructor(options) {
+        this.prefix = (options === null || options === void 0 ? void 0 : options.prefix) ? `${options.prefix}:` : DEFAULT_PREFIX;
+        // We track if we own the client so that we can destroy clients that we own.
+        if (options === null || options === void 0 ? void 0 : options.dynamoDBClient) {
+            this.client = options.dynamoDBClient;
+            this.owned = false;
+        }
+        else if (options === null || options === void 0 ? void 0 : options.clientOptions) {
+            this.client = new client_dynamodb_1.DynamoDBClient(options.clientOptions);
+            this.owned = true;
+        }
+        else {
+            this.client = new client_dynamodb_1.DynamoDBClient({});
+            this.owned = true;
+        }
+    }
+    /**
+     * Get a key with prefix prepended.
+     * @param key The key to prefix.
+     * @returns The prefixed key.
+     */
+    prefixedKey(key) {
+        return `${this.prefix}${key}`;
+    }
+    query(params) {
+        var _a, e_1, _b, _c;
+        return __awaiter(this, void 0, void 0, function* () {
+            const records = [];
+            try {
+                // Using a generator here is a substantial ergonomic improvement.
+                // eslint-disable-next-line no-restricted-syntax
+                for (var _d = true, _e = __asyncValues((0, client_dynamodb_1.paginateQuery)({ client: this.client }, params)), _f; _f = yield _e.next(), _a = _f.done, !_a;) {
+                    _c = _f.value;
+                    _d = false;
+                    try {
+                        const page = _c;
+                        if (page.Items) {
+                            records.push(...page.Items);
+                        }
+                    }
+                    finally {
+                        _d = true;
+                    }
+                }
+            }
+            catch (e_1_1) { e_1 = { error: e_1_1 }; }
+            finally {
+                try {
+                    if (!_d && !_a && (_b = _e.return)) yield _b.call(_e);
+                }
+                finally { if (e_1) throw e_1.error; }
+            }
+            return records;
+        });
+    }
+    batchWrite(table, params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const batches = [];
+            // Split into batches of at most 25 commands.
+            while (params.length) {
+                batches.push(params.splice(0, WRITE_BATCH_SIZE));
+            }
+            // Execute all the batches and wait for them to complete.
+            yield Promise.all(batches.map((batch) => this.client.send(new client_dynamodb_1.BatchWriteItemCommand({
+                RequestItems: { [table]: batch },
+            }))));
+        });
+    }
+    get(table, key) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const res = yield this.client.send(new client_dynamodb_1.GetItemCommand({
+                TableName: table,
+                Key: key,
+            }));
+            return res.Item;
+        });
+    }
+    put(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                yield this.client.send(new client_dynamodb_1.PutItemCommand(params));
+            }
+            catch (err) {
+                // If we couldn't upsert because of the version, then that is fine.
+                // Otherwise we return failure.
+                if (!(err instanceof client_dynamodb_1.ConditionalCheckFailedException)) {
+                    throw err;
+                }
+            }
+        });
+    }
+    close() {
+        if (this.owned) {
+            this.client.destroy();
+        }
+    }
+}
+exports.default = DynamoDBClientState;
+//# sourceMappingURL=DynamoDBClientState.js.map

package/dist/src/DynamoDBClientState.js.map

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

package/dist/src/DynamoDBCore.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=DynamoDBCore.d.ts.map

package/dist/src/DynamoDBCore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DynamoDBCore.d.ts","sourceRoot":"","sources":["../../src/DynamoDBCore.ts"],"names":[],"mappings":""}

package/dist/src/DynamoDBCore.js

@@ -0,0 +1,252 @@
+"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.calculateSize = void 0;
+const Value_1 = require("./Value");
+// We won't try to store items whose total size exceeds this. The DynamoDB documentation says
+// only "400KB", which probably means 400*1024, but to avoid any chance of trying to store a
+// too-large item we are rounding it down.
+const DYNAMODB_MAX_SIZE = 400000;
+/**
+ * Exported for testing.
+ * @internal
+ */
+function calculateSize(item, logger) {
+    return Object.entries(item).reduce((prev, [key, value]) => {
+        // see: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/CapacityUnitCalculations.html
+        if (value.S) {
+            return prev + key.length + Buffer.byteLength(value.S);
+        }
+        if (value.N) {
+            // Numeric values will be over-estimated compared to the DynamoDB size calculation.
+            return prev + key.length + Buffer.byteLength(value.N);
+        }
+        if (value.BOOL) {
+            return prev + key.length + 1;
+        }
+        logger === null || logger === void 0 ? void 0 : logger.warn('Unrecognized type in size calculation');
+        return prev;
+    }, 100);
+}
+exports.calculateSize = calculateSize;
+/**
+ * Internal implementation of the DynamoDB feature store.
+ *
+ * Implementation notes:
+ *
+ * Feature flags, segments, and any other kind of entity the LaunchDarkly client may wish
+ * to store, are all put in the same table. The only two required attributes are "key" (which
+ * is present in all store-able entities) and "namespace" (a parameter from the client that is
+ * used to disambiguate between flags and segments).
+ *
+ * Because of DynamoDB's restrictions on attribute values (e.g. empty strings are not
+ * allowed), the standard DynamoDB marshaling mechanism with one attribute per object property
+ * is not used. Instead, the entire object is serialized to JSON and stored in a single
+ * attribute, "item". The "version" property is also stored as a separate attribute since it
+ * is used for updates.
+ *
+ * Since DynamoDB doesn't have transactions, the init method - which replaces the entire data
+ * store - is not atomic, so there can be a race condition if another process is adding new data
+ * via upsert. To minimize this, we don't delete all the data at the start; instead, we update
+ * the items we've received, and then delete all other items. That could potentially result in
+ * deleting new data from another process, but that would be the case anyway if the init
+ * happened to execute later than the upsert(); we are relying on the fact that normally the
+ * process that did the init() will also receive the new data shortly and do its own upsert.
+ *
+ * DynamoDB has a maximum item size of 400KB. Since each feature flag or user segment is
+ * stored as a single item, this mechanism will not work for extremely large flags or segments.
+ * @internal
+ */
+class DynamoDBCore {
+    constructor(tableName, state, logger) {
+        this.tableName = tableName;
+        this.state = state;
+        this.logger = logger;
+    }
+    initializedToken() {
+        const prefixed = (0, Value_1.stringValue)(this.state.prefixedKey('$inited'));
+        return { namespace: prefixed, key: prefixed };
+    }
+    /**
+     * For a set of init data read all the existing data with matching namespaces.
+     * @param allData A set of init data.
+     * @returns A list of all data with matching namespaces.
+     */
+    readExistingItems(allData) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const promises = allData.map((kind) => {
+                const { namespace } = kind.key;
+                return this.state.query(this.queryParamsForNamespace(namespace));
+            });
+            const records = (yield Promise.all(promises)).flat();
+            return records;
+        });
+    }
+    /**
+     * Mashal a SerializedItemDescriptor into an item for the DB.
+     * @param kind The kind of the data.
+     * @param item The item to marshal.
+     * @returns The marshalled data.
+     */
+    marshalItem(kind, item) {
+        const dbItem = {
+            namespace: (0, Value_1.stringValue)(this.state.prefixedKey(kind.namespace)),
+            key: (0, Value_1.stringValue)(item.key),
+            version: (0, Value_1.numberValue)(item.item.version),
+        };
+        if (item.item.serializedItem) {
+            dbItem.item = (0, Value_1.stringValue)(item.item.serializedItem);
+        }
+        return dbItem;
+    }
+    unmarshalItem(dbItem) {
+        var _a, _b, _c;
+        return {
+            // Version should exist.
+            version: parseInt(((_a = dbItem.version) === null || _a === void 0 ? void 0 : _a.N) || '0', 10),
+            // These fields may be undefined, and that is fine.
+            deleted: !!((_b = dbItem.deleted) === null || _b === void 0 ? void 0 : _b.BOOL),
+            serializedItem: (_c = dbItem.item) === null || _c === void 0 ? void 0 : _c.S,
+        };
+    }
+    init(allData, callback) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const items = yield this.readExistingItems(allData);
+            // Make a key from an existing DB item.
+            function makeNamespaceKey(item) {
+                return `${item.namespace.S}$${item.key.S}`;
+            }
+            const existingNamespaceKeys = {};
+            items.forEach((item) => {
+                existingNamespaceKeys[makeNamespaceKey(item)] = true;
+            });
+            delete existingNamespaceKeys[makeNamespaceKey(this.initializedToken())];
+            // Generate a list of write operations, and then execute them in a batch.
+            const ops = [];
+            allData.forEach((collection) => {
+                collection.item.forEach((item) => {
+                    const dbItem = this.marshalItem(collection.key, item);
+                    if (this.checkSizeLimit(dbItem)) {
+                        delete existingNamespaceKeys[`${this.state.prefixedKey(collection.key.namespace)}$${item.key}`];
+                        ops.push({ PutRequest: { Item: dbItem } });
+                    }
+                });
+            });
+            // Remove existing data that is not in the new list.
+            Object.keys(existingNamespaceKeys).forEach((namespaceKey) => {
+                const namespaceAndKey = namespaceKey.split('$');
+                ops.push({
+                    DeleteRequest: {
+                        Key: { namespace: (0, Value_1.stringValue)(namespaceAndKey[0]), key: (0, Value_1.stringValue)(namespaceAndKey[1]) },
+                    },
+                });
+            });
+            // Always write the initialized token when we initialize.
+            ops.push({ PutRequest: { Item: this.initializedToken() } });
+            yield this.state.batchWrite(this.tableName, ops);
+            callback();
+        });
+    }
+    get(kind, key, callback) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const read = yield this.state.get(this.tableName, {
+                namespace: (0, Value_1.stringValue)(this.state.prefixedKey(kind.namespace)),
+                key: (0, Value_1.stringValue)(key),
+            });
+            if (read) {
+                callback(this.unmarshalItem(read));
+            }
+            else {
+                callback(undefined);
+            }
+        });
+    }
+    getAll(kind, callback) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const params = this.queryParamsForNamespace(kind.namespace);
+            const results = yield this.state.query(params);
+            callback(results.map((record) => ({ key: record.key.S, item: this.unmarshalItem(record) })));
+        });
+    }
+    upsert(kind, key, descriptor, callback) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const params = this.makeVersionedPutRequest(kind, { key, item: descriptor });
+            if (!this.checkSizeLimit(params.Item)) {
+                // We deliberately don't report this back to the SDK as an error, because we don't want to trigger any
+                // useless retry behavior. We just won't do the update.
+                callback();
+                return;
+            }
+            try {
+                yield this.state.put(params);
+                this.get(kind, key, (readDescriptor) => {
+                    callback(undefined, readDescriptor);
+                });
+            }
+            catch (err) {
+                callback(err, undefined);
+            }
+        });
+    }
+    initialized(callback) {
+        var _a, _b;
+        return __awaiter(this, void 0, void 0, function* () {
+            let initialized = false;
+            try {
+                const token = this.initializedToken();
+                const data = yield this.state.get(this.tableName, token);
+                initialized = !!(((_a = data === null || data === void 0 ? void 0 : data.key) === null || _a === void 0 ? void 0 : _a.S) === token.key.S);
+            }
+            catch (err) {
+                (_b = this.logger) === null || _b === void 0 ? void 0 : _b.error(`Error reading inited: ${err}`);
+                initialized = false;
+            }
+            // Callback outside the try. In case it raised an exception.
+            callback(initialized);
+        });
+    }
+    close() {
+        this.state.close();
+    }
+    getDescription() {
+        return 'DynamoDB';
+    }
+    queryParamsForNamespace(namespace) {
+        return {
+            TableName: this.tableName,
+            KeyConditionExpression: 'namespace = :namespace',
+            FilterExpression: 'attribute_not_exists(deleted) OR deleted = :deleted',
+            ExpressionAttributeValues: {
+                ':namespace': (0, Value_1.stringValue)(this.state.prefixedKey(namespace)),
+                ':deleted': (0, Value_1.boolValue)(false),
+            },
+        };
+    }
+    makeVersionedPutRequest(kind, item) {
+        return {
+            TableName: this.tableName,
+            Item: this.marshalItem(kind, item),
+            ConditionExpression: 'attribute_not_exists(version) OR version < :new_version',
+            ExpressionAttributeValues: { ':new_version': (0, Value_1.numberValue)(item.item.version) },
+        };
+    }
+    checkSizeLimit(item) {
+        var _a;
+        const size = calculateSize(item);
+        if (size <= DYNAMODB_MAX_SIZE) {
+            return true;
+        }
+        (_a = this.logger) === null || _a === void 0 ? void 0 : _a.error(`The item "${item.key.S}" in "${item.namespace.S}" was too large to store in DynamoDB and was dropped`);
+        return false;
+    }
+}
+exports.default = DynamoDBCore;
+//# sourceMappingURL=DynamoDBCore.js.map

package/dist/src/DynamoDBCore.js.map

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

package/dist/src/DynamoDBFeatureStore.d.ts

@@ -0,0 +1,18 @@
+import { interfaces, LDFeatureStore, LDFeatureStoreDataStorage, LDFeatureStoreItem, LDFeatureStoreKindData, LDKeyedFeatureStoreItem, LDLogger } from '@launchdarkly/node-server-sdk';
+import LDDynamoDBOptions from './LDDynamoDBOptions';
+/**
+ * Integration between the LaunchDarkly SDK and DynamoDB.
+ */
+export default class DynamoDBFeatureStore implements LDFeatureStore {
+    private wrapper;
+    constructor(tableName: string, options?: LDDynamoDBOptions, logger?: LDLogger);
+    get(kind: interfaces.DataKind, key: string, callback: (res: LDFeatureStoreItem | null) => void): void;
+    all(kind: interfaces.DataKind, callback: (res: LDFeatureStoreKindData) => void): void;
+    init(allData: LDFeatureStoreDataStorage, callback: () => void): void;
+    delete(kind: interfaces.DataKind, key: string, version: number, callback: () => void): void;
+    upsert(kind: interfaces.DataKind, data: LDKeyedFeatureStoreItem, callback: () => void): void;
+    initialized(callback: (isInitialized: boolean) => void): void;
+    close(): void;
+    getDescription?(): string;
+}
+//# sourceMappingURL=DynamoDBFeatureStore.d.ts.map

package/dist/src/DynamoDBFeatureStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DynamoDBFeatureStore.d.ts","sourceRoot":"","sources":["../../src/DynamoDBFeatureStore.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,cAAc,EACd,yBAAyB,EACzB,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,EACvB,QAAQ,EAET,MAAM,+BAA+B,CAAC;AACvC,OAAO,iBAAiB,MAAM,qBAAqB,CAAC;AAKpD;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,oBAAqB,YAAW,cAAc;IACjE,OAAO,CAAC,OAAO,CAA6B;gBAEhC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,QAAQ;IAO7E,GAAG,CACD,IAAI,EAAE,UAAU,CAAC,QAAQ,EACzB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,CAAC,GAAG,EAAE,kBAAkB,GAAG,IAAI,KAAK,IAAI,GACjD,IAAI;IAIP,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,sBAAsB,KAAK,IAAI,GAAG,IAAI;IAIrF,IAAI,CAAC,OAAO,EAAE,yBAAyB,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAIpE,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAI3F,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,QAAQ,EAAE,IAAI,EAAE,uBAAuB,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAI5F,WAAW,CAAC,QAAQ,EAAE,CAAC,aAAa,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI;IAI7D,KAAK,IAAI,IAAI;IAIb,cAAc,CAAC,IAAI,MAAM;CAG1B"}

package/dist/src/DynamoDBFeatureStore.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_server_sdk_1 = require("@launchdarkly/node-server-sdk");
+const DynamoDBCore_1 = require("./DynamoDBCore");
+const DynamoDBClientState_1 = require("./DynamoDBClientState");
+const TtlFromOptions_1 = require("./TtlFromOptions");
+/**
+ * Integration between the LaunchDarkly SDK and DynamoDB.
+ */
+class DynamoDBFeatureStore {
+    constructor(tableName, options, logger) {
+        this.wrapper = new node_server_sdk_1.PersistentDataStoreWrapper(new DynamoDBCore_1.default(tableName, new DynamoDBClientState_1.default(options), logger), (0, TtlFromOptions_1.default)(options));
+    }
+    get(kind, key, callback) {
+        this.wrapper.get(kind, key, callback);
+    }
+    all(kind, callback) {
+        this.wrapper.all(kind, callback);
+    }
+    init(allData, callback) {
+        this.wrapper.init(allData, callback);
+    }
+    delete(kind, key, version, callback) {
+        this.wrapper.delete(kind, key, version, callback);
+    }
+    upsert(kind, data, callback) {
+        this.wrapper.upsert(kind, data, callback);
+    }
+    initialized(callback) {
+        this.wrapper.initialized(callback);
+    }
+    close() {
+        this.wrapper.close();
+    }
+    getDescription() {
+        return this.wrapper.getDescription();
+    }
+}
+exports.default = DynamoDBFeatureStore;
+//# sourceMappingURL=DynamoDBFeatureStore.js.map

package/dist/src/DynamoDBFeatureStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DynamoDBFeatureStore.js","sourceRoot":"","sources":["../../src/DynamoDBFeatureStore.ts"],"names":[],"mappings":";;AAAA,mEASuC;AAEvC,iDAA0C;AAC1C,+DAAwD;AACxD,qDAA8C;AAE9C;;GAEG;AACH,MAAqB,oBAAoB;IAGvC,YAAY,SAAiB,EAAE,OAA2B,EAAE,MAAiB;QAC3E,IAAI,CAAC,OAAO,GAAG,IAAI,4CAA0B,CAC3C,IAAI,sBAAY,CAAC,SAAS,EAAE,IAAI,6BAAmB,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,EACrE,IAAA,wBAAc,EAAC,OAAO,CAAC,CACxB,CAAC;IACJ,CAAC;IAED,GAAG,CACD,IAAyB,EACzB,GAAW,EACX,QAAkD;QAElD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,GAAG,CAAC,IAAyB,EAAE,QAA+C;QAC5E,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC;IAED,IAAI,CAAC,OAAkC,EAAE,QAAoB;QAC3D,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,CAAC,IAAyB,EAAE,GAAW,EAAE,OAAe,EAAE,QAAoB;QAClF,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,CAAC,IAAyB,EAAE,IAA6B,EAAE,QAAoB;QACnF,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAED,WAAW,CAAC,QAA0C;QACpD,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED,cAAc;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;IACvC,CAAC;CACF;AA7CD,uCA6CC"}

package/dist/src/DynamoDBFeatureStoreFactory.d.ts

@@ -0,0 +1,18 @@
+import { LDClientContext } from '@launchdarkly/node-server-sdk';
+import DynamoDBFeatureStore from './DynamoDBFeatureStore';
+import LDDynamoDBOptions from './LDDynamoDBOptions';
+/**
+ * Configures a feature store backed by a DynamoDB instance.
+ *
+ * For more details about how and why you can use a persistent feature store, see
+ * the [Using DynamoDB as a persistent feature store](https://docs.launchdarkly.com/sdk/features/storing-data/dynamodb#nodejs-server-side).
+ *
+ * @param tableName The table name in DynamoDB (required). The table must already exist.
+ *   See: https://docs.launchdarkly.com/sdk/features/storing-data/dynamodb
+ * @param options Optional configuration, please refer to {@link LDDynamoDBOptions}.
+ *
+ * @returns
+ *   A factory function suitable for use in the SDK configuration (LDOptions).
+ */
+export default function DynamoDBFeatureStoreFactory(tableName: string, options?: LDDynamoDBOptions): (config: LDClientContext) => DynamoDBFeatureStore;
+//# sourceMappingURL=DynamoDBFeatureStoreFactory.d.ts.map

package/dist/src/DynamoDBFeatureStoreFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DynamoDBFeatureStoreFactory.d.ts","sourceRoot":"","sources":["../../src/DynamoDBFeatureStoreFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,oBAAoB,MAAM,wBAAwB,CAAC;AAC1D,OAAO,iBAAiB,MAAM,qBAAqB,CAAC;AAEpD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,OAAO,UAAU,2BAA2B,CACjD,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,iBAAiB,YAEX,eAAe,0BAEhC"}

package/dist/src/DynamoDBFeatureStoreFactory.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const DynamoDBFeatureStore_1 = require("./DynamoDBFeatureStore");
+/**
+ * Configures a feature store backed by a DynamoDB instance.
+ *
+ * For more details about how and why you can use a persistent feature store, see
+ * the [Using DynamoDB as a persistent feature store](https://docs.launchdarkly.com/sdk/features/storing-data/dynamodb#nodejs-server-side).
+ *
+ * @param tableName The table name in DynamoDB (required). The table must already exist.
+ *   See: https://docs.launchdarkly.com/sdk/features/storing-data/dynamodb
+ * @param options Optional configuration, please refer to {@link LDDynamoDBOptions}.
+ *
+ * @returns
+ *   A factory function suitable for use in the SDK configuration (LDOptions).
+ */
+function DynamoDBFeatureStoreFactory(tableName, options) {
+    return (config) => new DynamoDBFeatureStore_1.default(tableName, options, config.basicConfiguration.logger);
+}
+exports.default = DynamoDBFeatureStoreFactory;
+//# sourceMappingURL=DynamoDBFeatureStoreFactory.js.map

package/dist/src/DynamoDBFeatureStoreFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DynamoDBFeatureStoreFactory.js","sourceRoot":"","sources":["../../src/DynamoDBFeatureStoreFactory.ts"],"names":[],"mappings":";;AACA,iEAA0D;AAG1D;;;;;;;;;;;;GAYG;AACH,SAAwB,2BAA2B,CACjD,SAAiB,EACjB,OAA2B;IAE3B,OAAO,CAAC,MAAuB,EAAE,EAAE,CACjC,IAAI,8BAAoB,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;AACnF,CAAC;AAND,8CAMC"}

package/dist/src/LDDynamoDBOptions.d.ts

@@ -0,0 +1,40 @@
+import { LDLogger } from '@launchdarkly/node-server-sdk';
+import { DynamoDBClient, DynamoDBClientConfig } from '@aws-sdk/client-dynamodb';
+/**
+ * Options for configuring {@link DynamoDBFeatureStoreFactory} or {@link DynamoDBBigSegmentStoreFactory}.
+ */
+export default interface LDDynamoDBOptions {
+    /**
+     * Options to be passed to the DynamoDB client constructor, as defined by the AWS SDK.
+     */
+    clientOptions?: DynamoDBClientConfig;
+    /**
+     * Specifies an existing, already-configured DynamoDB client instance that the feature store
+     * should use rather than creating one of its own. If you specify an existing client, then the
+     * clientOptions property is ignored.
+     */
+    dynamoDBClient?: DynamoDBClient;
+    /**
+     * An optional namespace prefix for all keys stored in DynamoDB. Use this if you are sharing
+     * the same database table between multiple clients that are for different LaunchDarkly
+     * environments, to avoid key collisions.
+     */
+    prefix?: string;
+    /**
+     * The amount of time, in seconds, that recently read or updated items should remain in an
+     * in-memory cache. If it is zero, there will be no in-memory caching.
+     *
+     * This parameter applies only to {@link DynamoDBFeatureStore}. It is ignored for {@link DynamoDBBigSegmentStore}.
+     * Caching for {@link DynamoDBBigSegmentStore} is configured separately, in the SDK's
+     * `LDBigSegmentsOptions` type, since it is independent of what database implementation is used.
+     *
+     * If omitted, the default value is 15 seconds.
+     */
+    cacheTTL?: number;
+    /**
+     * A logger to be used for warnings and errors generated by the feature store. If not specified,
+     * it will use the SDK's logging configuration.
+     */
+    logger?: LDLogger;
+}
+//# sourceMappingURL=LDDynamoDBOptions.d.ts.map

package/dist/src/LDDynamoDBOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LDDynamoDBOptions.d.ts","sourceRoot":"","sources":["../../src/LDDynamoDBOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhF;;GAEG;AACH,MAAM,CAAC,OAAO,WAAW,iBAAiB;IACxC;;OAEG;IACH,aAAa,CAAC,EAAE,oBAAoB,CAAC;IAErC;;;;OAIG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,MAAM,CAAC,EAAE,QAAQ,CAAC;CACnB"}

package/dist/src/LDDynamoDBOptions.js

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

package/dist/src/LDDynamoDBOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LDDynamoDBOptions.js","sourceRoot":"","sources":["../../src/LDDynamoDBOptions.ts"],"names":[],"mappings":""}

package/dist/src/TtlFromOptions.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=TtlFromOptions.d.ts.map

package/dist/src/TtlFromOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TtlFromOptions.d.ts","sourceRoot":"","sources":["../../src/TtlFromOptions.ts"],"names":[],"mappings":""}

package/dist/src/TtlFromOptions.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * The default TTL cache time in seconds.
+ */
+const DEFAULT_CACHE_TTL_S = 15;
+/**
+ * Get a cache TTL based on LDDynamoDBOptions. If the TTL is not specified, then
+ * the default of 15 seconds will be used.
+ * @param options The options to get a TTL for.
+ * @returns The TTL, in seconds.
+ * @internal
+ */
+function TtlFromOptions(options) {
+    // 0 is a valid option. So we need a null/undefined check.
+    if ((options === null || options === void 0 ? void 0 : options.cacheTTL) === undefined || options.cacheTTL === null) {
+        return DEFAULT_CACHE_TTL_S;
+    }
+    return options.cacheTTL;
+}
+exports.default = TtlFromOptions;
+//# sourceMappingURL=TtlFromOptions.js.map

package/dist/src/TtlFromOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TtlFromOptions.js","sourceRoot":"","sources":["../../src/TtlFromOptions.ts"],"names":[],"mappings":";;AAEA;;GAEG;AACH,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAE/B;;;;;;GAMG;AACH,SAAwB,cAAc,CAAC,OAA2B;IAChE,0DAA0D;IAC1D,IAAI,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,QAAQ,MAAK,SAAS,IAAI,OAAO,CAAC,QAAQ,KAAK,IAAI,EAAE;QAChE,OAAO,mBAAmB,CAAC;KAC5B;IACD,OAAO,OAAQ,CAAC,QAAQ,CAAC;AAC3B,CAAC;AAND,iCAMC"}

package/dist/src/Value.d.ts

@@ -0,0 +1,5 @@
+import { AttributeValue } from '@aws-sdk/client-dynamodb';
+export declare function stringValue(val: string): AttributeValue;
+export declare function boolValue(val: boolean): AttributeValue;
+export declare function numberValue(val: number): AttributeValue;
+//# sourceMappingURL=Value.d.ts.map

package/dist/src/Value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Value.d.ts","sourceRoot":"","sources":["../../src/Value.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAEvD;AACD,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,CAEtD;AACD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAEvD"}

package/dist/src/Value.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.numberValue = exports.boolValue = exports.stringValue = void 0;
+function stringValue(val) {
+    return { S: val };
+}
+exports.stringValue = stringValue;
+function boolValue(val) {
+    return { BOOL: val };
+}
+exports.boolValue = boolValue;
+function numberValue(val) {
+    return { N: val.toString(10) };
+}
+exports.numberValue = numberValue;
+//# sourceMappingURL=Value.js.map

package/dist/src/Value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Value.js","sourceRoot":"","sources":["../../src/Value.ts"],"names":[],"mappings":";;;AAEA,SAAgB,WAAW,CAAC,GAAW;IACrC,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;AACpB,CAAC;AAFD,kCAEC;AACD,SAAgB,SAAS,CAAC,GAAY;IACpC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;AACvB,CAAC;AAFD,8BAEC;AACD,SAAgB,WAAW,CAAC,GAAW;IACrC,OAAO,EAAE,CAAC,EAAE,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;AACjC,CAAC;AAFD,kCAEC"}

package/dist/src/index.d.ts

@@ -0,0 +1,4 @@
+export { default as DynamoDBFeatureStore } from './DynamoDBFeatureStoreFactory';
+export { default as DynamoDBBigSegmentStore } from './DynamoDBBigSegmentStoreFactory';
+export { default as LDDynamoDBOptions } from './LDDynamoDBOptions';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,EAAE,OAAO,IAAI,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAEtF,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DynamoDBBigSegmentStore = exports.DynamoDBFeatureStore = void 0;
+// Exporting the factories without the 'Factory'. This keeps them in-line with
+// previous store versions. The differentiation between the factory and the store
+// is not critical for consuming the SDK.
+var DynamoDBFeatureStoreFactory_1 = require("./DynamoDBFeatureStoreFactory");
+Object.defineProperty(exports, "DynamoDBFeatureStore", { enumerable: true, get: function () { return DynamoDBFeatureStoreFactory_1.default; } });
+var DynamoDBBigSegmentStoreFactory_1 = require("./DynamoDBBigSegmentStoreFactory");
+Object.defineProperty(exports, "DynamoDBBigSegmentStore", { enumerable: true, get: function () { return DynamoDBBigSegmentStoreFactory_1.default; } });
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,8EAA8E;AAC9E,iFAAiF;AACjF,yCAAyC;AACzC,6EAAgF;AAAvE,mIAAA,OAAO,OAAwB;AACxC,mFAAsF;AAA7E,yIAAA,OAAO,OAA2B"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@launchdarkly/node-server-sdk-dynamodb",
+  "version": "0.1.0",
+  "description": "DynamoDB-backed feature store for the LaunchDarkly Server-Side SDK for Node.js",
+  "homepage": "https://github.com/launchdarkly/js-core/tree/main/packages/store/node-server-sdk-dynamodb",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/launchdarkly/js-core.git"
+  },
+  "type": "commonjs",
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "launchdarkly",
+    "analytics",
+    "client"
+  ],
+  "license": "Apache-2.0",
+  "scripts": {
+    "clean": "npx tsc --build --clean",
+    "test": "npx jest --ci --runInBand",
+    "build": "npx tsc",
+    "lint": "npx eslint . --ext .ts",
+    "lint:fix": "yarn run lint --fix",
+    "doc": "../../../scripts/build-doc.sh ."
+  },
+  "dependencies": {
+    "ioredis": "^5.3.2"
+  },
+  "peerDependencies": {
+    "@aws-sdk/client-dynamodb": "3.348.0",
+    "@launchdarkly/node-server-sdk": "0.4.4"
+  },
+  "devDependencies": {
+    "@aws-sdk/client-dynamodb": "3.348.0",
+    "@launchdarkly/node-server-sdk": "0.5.0",
+    "@types/jest": "^29.4.0",
+    "@typescript-eslint/eslint-plugin": "^5.22.0",
+    "@typescript-eslint/parser": "^5.22.0",
+    "eslint": "^8.14.0",
+    "eslint-config-airbnb-base": "^15.0.0",
+    "eslint-config-airbnb-typescript": "^17.0.0",
+    "eslint-config-prettier": "^8.7.0",
+    "eslint-plugin-import": "^2.26.0",
+    "eslint-plugin-prettier": "^4.2.1",
+    "jest": "^29.5.0",
+    "launchdarkly-js-test-helpers": "^2.2.0",
+    "prettier": "^2.8.4",
+    "ts-jest": "^29.0.5",
+    "typedoc": "0.23.26",
+    "typescript": "^4.6.3"
+  }
+}