Adds Flagsmith adapter

[tiagoapolo]

This pull request introduces a new provider adapter for the Flags SDK that integrates with Flagsmith. The changes include adding configuration files, updating dependencies, and creating the necessary code for the adapter.

Flagsmith documentation: https://docs.flagsmith.com/clients/next-ssr

Usage

import { createFlagsmithAdapter } from '@flags-sdk/adapter-flagsmith';
import { flag } from 'flags';

// Create the Flagsmith adapter
const flagsmithAdapter = createFlagsmithAdapter({
  environmentID: 'your-environment-id',
  // Optional: Add any other Flagsmith configuration options
  // See: https://docs.flagsmith.com/clients/javascript/
});

// Define your flags
const myFeatureFlag = flag({
  key: 'my-feature',
  adapter: flagsmithAdapter,
});

// Use the flag in your application
const flag = await myFeatureFlag();

[vercel]

@tiagoapolo is attempting to deploy a commit to the Vercel Team on Vercel.

A member of the Team first needs to authorize it.

[socket-security]

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	flagsmith@​9.0.5

View full report

[dferber90]

Thank you for your contributions so far! I left a bit of early guidance

[dferber90]

Do you work for Flagsmith? If we merge this PR we'd also put up some actual docs on flags-sdk.dev. Would you be wiling to link to our Flags SDK and those docs from https://docs.flagsmith.com?

[matthewelwell]

Hey @dferber90, just jumping in here since Tiago is on vacation - yes, Tiago works for Flagsmith.

In answer to your question, for sure, we'd be happy to link to your docs from https://docs.flagsmith.com - would you be happy with adding reciprocal backlink(s) too?

[dferber90]

Great! We'd add you to https://flags-sdk.dev/providers and create a docs page for FlagSmith

[tiagoapolo]

@dferber90 could you take one more look at my PR ?

[dferber90]

@tiagoapolo I‘m out of office this week, but @AAorris will take over leading adapter work and help you get this finalized, listed and released 👍

[AAorris]

Thanks for your PR! Please consider the following input:

Strongly recommended:

• Support identity through entities
• Optimize performance for multiple features in one request

Recommended:

• Add origin to link flags to your customers' dashboards

[AAorris]

The progress here is looking good!

It looked ready enough while reviewing that I started to explore an example app using the adapter. However, I found several issues while testing in an app.

To continue the review with me, please develop an example that uses the adapter based on an existing one

• Standard templates: https://github.com/vercel/examples/tree/main/flags-sdk
• The slim template I branched for testing with Flagsmith

You can build, test, and deploy the demo using your local adapter code by following these instructions

Please share a link to the example app with your next review request. I look forward to it!

[tiagoapolo]

@AAorris in this branch you have my example running https://github.com/tiagoapolo/examples/tree/flagsmith-adapter. Also it's deployed in vercel at: https://flags-sdk-template-ff5v5lyuk-tiagos-projects-e9d5728f.vercel.app/
Here's quick demo:

flags_compressed.mov

[AAorris]

Hi @tiagoapolo, thanks for your work and sorry for the delay. I'm back and will be reviewing this week if possible.

I don't see your code pushed up to the branch, could you make sure it's available for me to reproduce?

It would be great if the example shows how to replicate the flags in the same way as other examples:

• Free Delivery: 50% staged feature rollout by ID
• Summer Sale: 50% staged feature rollout by ID
• Proceed to Checkout: "red" | "green" | "blue" multivariant string staged 33% each by ID
• Dev tools widget is able to update the ID to see different variants