feat: OFREP web provider

.release-please-manifest.json

@@ -9,5 +9,6 @@
   "libs/providers/go-feature-flag-web": "0.2.0",
   "libs/shared/flagd-core": "0.1.11",
   "libs/shared/ofrep-core": "0.0.3-experimental",
-  "libs/providers/flipt": "0.0.2"
+  "libs/providers/flipt": "0.0.2",
+  "libs/providers/ofrep-web": "0.1.0"
 }

libs/providers/ofrep-web/.eslintrc.json

@@ -0,0 +1,25 @@
+{
+  "extends": ["../../../.eslintrc.json"],
+  "ignorePatterns": ["!**/*"],
+  "overrides": [
+    {
+      "files": ["*.ts", "*.tsx", "*.js", "*.jsx"],
+      "rules": {}
+    },
+    {
+      "files": ["*.ts", "*.tsx"],
+      "rules": {}
+    },
+    {
+      "files": ["*.js", "*.jsx"],
+      "rules": {}
+    },
+    {
+      "files": ["*.json"],
+      "parser": "jsonc-eslint-parser",
+      "rules": {
+        "@nx/dependency-checks": "error"
+      }
+    }
+  ]
+}

libs/providers/ofrep-web/README.md

@@ -0,0 +1,15 @@
+# ofrep-web Provider
+
+## Installation
+
+```
+$ npm install @openfeature/ofrep-web-provider
+```
+
+## Building
+
+Run `nx package providers-ofrep-web` to build the library.
+
+## Running unit tests
+
+Run `nx test providers-ofrep-web` to execute the unit tests via [Jest](https://jestjs.io).

libs/providers/ofrep-web/babel.config.json

@@ -0,0 +1,3 @@
+{
+  "presets": [["minify", { "builtIns": false }]]
+}

libs/providers/ofrep-web/jest.config.ts

@@ -0,0 +1,16 @@
+/* eslint-disable */
+export default {
+  displayName: 'providers-ofrep-web',
+  preset: '../../../jest.preset.js',
+  globals: {
+    'ts-jest': {
+      tsconfig: '<rootDir>/tsconfig.spec.json',
+    },
+  },
+  transform: {
+    '^.+\\.[tj]s$': 'ts-jest',
+  },
+  testEnvironment: 'jsdom',
+  moduleFileExtensions: ['ts', 'js', 'html'],
+  setupFiles: ['./jest.polyfills.js'],
+};

libs/providers/ofrep-web/jest.polyfills.js

@@ -0,0 +1,32 @@
+// jest.polyfills.js
+/**
+ * @note The block below contains polyfills for Node.js globals
+ * required for Jest to function when running JSDOM tests.
+ * These HAVE to be require's and HAVE to be in this exact
+ * order, since "undici" depends on the "TextEncoder" global API.
+ *
+ * Consider migrating to a more modern test runner if
+ * you don't want to deal with this.
+ */
+
+const { TextDecoder, TextEncoder } = require('node:util');
+
+// eslint-disable-next-line no-undef
+Object.defineProperties(globalThis, {
+  TextDecoder: { value: TextDecoder },
+  TextEncoder: { value: TextEncoder },
+})
+
+const { Blob, File } = require('node:buffer');
+const { fetch, Headers, FormData, Request, Response } = require('undici');
+
+// eslint-disable-next-line no-undef
+Object.defineProperties(globalThis, {
+  fetch: { value: fetch, writable: true },
+  Blob: { value: Blob },
+  File: { value: File },
+  Headers: { value: Headers },
+  FormData: { value: FormData },
+  Request: { value: Request },
+  Response: { value: Response },
+})

libs/providers/ofrep-web/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "@openfeature/ofrep-web-provider",
+  "version": "0.0.1-alpha.0",
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "main": "./src/index.js",
+  "typings": "./src/index.d.ts",
+  "scripts": {
+    "publish-if-not-exists": "cp $NPM_CONFIG_USERCONFIG .npmrc && if [ \"$(npm show $npm_package_name@$npm_package_version version)\" = \"$(npm run current-version -s)\" ]; then echo 'already published, skipping'; else npm publish --access public; fi",
+    "current-version": "echo $npm_package_version"
+  },
+  "peerDependencies": {
+    "@openfeature/web-sdk": ">=0.4.0"
+  }
+}

libs/providers/ofrep-web/project.json

@@ -0,0 +1,76 @@
+{
+  "name": "providers-ofrep-web",
+  "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "libs/providers/ofrep-web/src",
+  "projectType": "library",
+  "targets": {
+    "publish": {
+      "executor": "nx:run-commands",
+      "options": {
+        "command": "npm run publish-if-not-exists",
+        "cwd": "dist/libs/providers/ofrep-web"
+      },
+      "dependsOn": [
+        {
+          "projects": "self",
+          "target": "package"
+        }
+      ]
+    },
+    "lint": {
+      "executor": "@nx/linter:eslint",
+      "outputs": ["{options.outputFile}"],
+      "options": {
+        "lintFilePatterns": ["libs/providers/ofrep-web/**/*.ts", "libs/providers/ofrep-web/package.json"]
+      }
+    },
+    "test": {
+      "executor": "@nx/jest:jest",
+      "outputs": ["{workspaceRoot}/coverage/{projectRoot}"],
+      "options": {
+        "jestConfig": "libs/providers/ofrep-web/jest.config.ts",
+        "passWithNoTests": true
+      },
+      "configurations": {
+        "ci": {
+          "ci": true,
+          "codeCoverage": true
+        }
+      }
+    },
+    "package": {
+      "executor": "@nx/rollup:rollup",
+      "outputs": ["{options.outputPath}"],
+      "options": {
+        "project": "libs/providers/ofrep-web/package.json",
+        "outputPath": "dist/libs/providers/ofrep-web",
+        "entryFile": "libs/providers/ofrep-web/src/index.ts",
+        "tsConfig": "libs/providers/ofrep-web/tsconfig.lib.json",
+        "buildableProjectDepsInPackageJsonType": "dependencies",
+        "compiler": "tsc",
+        "generateExportsField": true,
+        "umdName": "ofrep-web",
+        "external": "all",
+        "format": ["cjs", "esm"],
+        "assets": [
+          {
+            "glob": "package.json",
+            "input": "./assets",
+            "output": "./src/"
+          },
+          {
+            "glob": "LICENSE",
+            "input": "./",
+            "output": "./"
+          },
+          {
+            "glob": "README.md",
+            "input": "./libs/providers/ofrep-web",
+            "output": "./"
+          }
+        ]
+      }
+    }
+  },
+  "tags": []
+}

libs/providers/ofrep-web/src/index.ts

@@ -0,0 +1 @@
+export * from './lib/ofrep-web-provider';

libs/providers/ofrep-web/src/lib/model/evaluation-status.ts

@@ -0,0 +1,4 @@
+export enum EvaluationStatus {
+  SUCCESS_NO_CHANGES = 'SUCCESS_NO_CHANGES',
+  SUCCESS_WITH_CHANGES = 'SUCCESS_WITH_CHANGES',
+}

libs/providers/ofrep-web/src/lib/model/ofrep-web-provider-options.ts

@@ -0,0 +1,6 @@
+import { FetchAPI } from '@openfeature/ofrep-core';
+export interface OfrepWebProviderOptions {
+  baseUrl: string;
+  pollInterval?: number; // in milliseconds
+  disablePolling?: boolean;
+}

libs/providers/ofrep-web/src/lib/model/resolutionError.ts

@@ -0,0 +1,15 @@
+import { ResolutionReason } from '@openfeature/web-sdk';
+import { EvaluationFailureErrorCode } from '@openfeature/ofrep-core';
+
+export type ResolutionError = {
+  reason: ResolutionReason;
+  errorCode: EvaluationFailureErrorCode;
+};
+
+export function isResolutionError(response: unknown): response is ResolutionError {
+  if (!response || typeof response !== 'object') {
+    return false;
+  }
+
+  return 'reason' in response && 'errorCode' in response && !('value' in response);
+}