superposition-provider 0.84.0

package/dist/superposition-provider.d.ts

@@ -0,0 +1,36 @@
+import { EvaluationContext, Provider, JsonValue, ResolutionDetails, ProviderStatus, OpenFeatureEventEmitter, ProviderMetadata, Hook, Logger } from '@openfeature/server-sdk';
+import { ConfigurationClient } from './configuration-client';
+import { EvaluationCacheOptions, RefreshStrategy, ConfigData, ExperimentationOptions } from './types';
+export interface SuperpositionProviderOptions {
+    endpoint: string;
+    token: string;
+    org_id: string;
+    workspace_id: string;
+    httpClient?: any;
+    fallbackConfig?: ConfigData;
+    evaluationCache?: EvaluationCacheOptions;
+    refreshStrategy?: RefreshStrategy;
+    experimentationOptions?: ExperimentationOptions;
+}
+export declare class SuperpositionProvider implements Provider {
+    private config;
+    readonly metadata: ProviderMetadata;
+    events: OpenFeatureEventEmitter;
+    readonly hooks: Hook[];
+    private client;
+    status: ProviderStatus;
+    private processedContextCache;
+    constructor(config: SuperpositionProviderOptions);
+    initialize(context?: EvaluationContext): Promise<void>;
+    onClose(): Promise<void>;
+    private evaluateFlag;
+    private filterContext;
+    private createResolver;
+    resolveBooleanEvaluation(flagKey: string, defaultValue: boolean, context: EvaluationContext): Promise<ResolutionDetails<boolean>>;
+    resolveStringEvaluation(flagKey: string, defaultValue: string, context: EvaluationContext): Promise<ResolutionDetails<string>>;
+    resolveNumberEvaluation(flagKey: string, defaultValue: number, context: EvaluationContext): Promise<ResolutionDetails<number>>;
+    resolveObjectEvaluation<T extends JsonValue>(flagKey: string, defaultValue: T, context: EvaluationContext, logger?: Logger): Promise<ResolutionDetails<T>>;
+    resolveAllConfigDetails(defaultValue: Record<string, any>, context: EvaluationContext): Promise<Record<string, any>>;
+    getStatus(): ProviderStatus;
+    getConfigurationClient(): ConfigurationClient;
+}

package/dist/types.d.ts

@@ -0,0 +1,57 @@
+export interface SuperpositionOptions {
+    endpoint: string;
+    token: string;
+    org_id?: string;
+    workspace_id?: string;
+    httpClient?: any;
+}
+export interface CacheOptions {
+    ttl?: number;
+    size?: number;
+}
+export interface EvaluationCacheOptions {
+    ttl?: number;
+    size?: number;
+}
+export interface PollingStrategy {
+    interval: number;
+    timeout?: number;
+}
+export interface OnDemandStrategy {
+    ttl: number;
+    timeout?: number;
+    use_stale_on_error?: boolean;
+}
+export type RefreshStrategy = PollingStrategy | OnDemandStrategy;
+export interface ExperimentationOptions {
+    refreshStrategy: RefreshStrategy;
+    evaluationCache?: EvaluationCacheOptions;
+    defaultIdentifier?: string;
+}
+export interface ConfigOptions {
+    fallbackConfig?: Record<string, any>;
+    evaluationCache?: EvaluationCacheOptions;
+    refreshStrategy?: RefreshStrategy;
+}
+export interface ConfigData {
+    default_configs: Record<string, any>;
+    contexts: any[];
+    overrides: Record<string, Record<string, any>>;
+}
+export interface FfiExperiment {
+    id: string;
+    context: Record<string, string>;
+    variants: Variant[];
+    traffic_percentage: number;
+}
+export interface Variant {
+    id: string;
+    variant_type: 'CONTROL' | 'EXPERIMENTAL';
+    context_id?: string;
+    override_id?: string;
+    overrides: Record<string, string>;
+}
+export interface ExperimentationArgs {
+    experiments: FfiExperiment[];
+    targeting_key: string;
+}

package/dist/utils.d.ts

@@ -0,0 +1,5 @@
+export declare function getNestedValue(obj: any, key: string): any;
+export declare function convertToBoolean(value: any, defaultValue: boolean): boolean;
+export declare function convertToString(value: any, defaultValue: string): string;
+export declare function convertToNumber(value: any, defaultValue: number): number;
+export declare function convertToObject<T>(value: any, defaultValue: T): T;

package/package.json

@@ -0,0 +1,62 @@
+{
+    "name": "superposition-provider",
+    "version": "0.84.0",
+    "type": "module",
+    "description": "OpenFeature provider for Superposition feature flags",
+    "main": "./dist/index.js",
+    "module": "./dist/index.esm.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "import": "./dist/index.esm.js",
+            "require": "./dist/index.js",
+            "types": "./dist/index.d.ts"
+        }
+    },
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/juspay/superposition.git"
+    },
+    "scripts": {
+        "prebuild": "node build-deps.js",
+        "build": "rollup -c",
+        "clean": "rimraf dist",
+        "prepack": "npm run clean && npm run build",
+        "test": "jest",
+        "prepublishOnly": "npm --no-git-tag-version version $VERSION"
+    },
+    "peerDependencies": {
+        "@openfeature/server-sdk": "^1.13.0"
+    },
+    "dependencies": {
+        "koffi": "^2.11.0",
+        "tslib": "^2.6.2"
+    },
+    "devDependencies": {
+        "@openfeature/server-sdk": "^1.13.0",
+        "@rollup/plugin-commonjs": "^25.0.0",
+        "@rollup/plugin-json": "^6.1.0",
+        "@rollup/plugin-node-resolve": "^15.0.0",
+        "@rollup/plugin-typescript": "^11.0.0",
+        "@types/jest": "^29.5.12",
+        "@types/node": "^20.0.0",
+        "jest": "^29.7.0",
+        "rimraf": "^5.0.0",
+        "rollup": "^4.0.0",
+        "rollup-plugin-copy": "^3.5.0",
+        "rollup-plugin-dts": "^6.0.0",
+        "ts-jest": "^29.1.1",
+        "tslib": "^2.6.2",
+        "typescript": "~5.2.2"
+    },
+    "engines": {
+        "node": ">=18.0.0"
+    },
+    "files": [
+        "dist/**/*"
+    ],
+    "bundledDependencies": [
+        "superposition-bindings",
+        "superposition-sdk"
+    ]
+}