@openfeature/flagd-provider 0.10.4 → 0.11.0

package/README.md

@@ -34,8 +34,9 @@ Options can be defined in the constructor or as environment variables. Construct
 | tls                                    | FLAGD_TLS                      | boolean | false     |                  |
 | socketPath                             | FLAGD_SOCKET_PATH              | string  | -         |                  |
 | resolverType                           | FLAGD_SOURCE_RESOLVER          | string  | rpc       | rpc, in-process  |
+| offlineFlagSourcePath                  | FLAGD_OFFLINE_FLAG_SOURCE_PATH | string  | -         |                  |
 | selector                               | FLAGD_SOURCE_SELECTOR          | string  | -         |                  |
-| cache                                  | FLAGD_CACHE                    | string  | lru       | lru,disabled     |
+| cache                                  | FLAGD_CACHE                    | string  | lru       | lru, disabled    |
 | maxCacheSize                           | FLAGD_MAX_CACHE_SIZE           | int     | 1000      |                  |
 
 Below are examples of usage patterns.

package/index.cjs.js

@@ -34,10 +34,11 @@ var ENV_VAR;
     ENV_VAR["FLAGD_MAX_CACHE_SIZE"] = "FLAGD_MAX_CACHE_SIZE";
     ENV_VAR["FLAGD_SOURCE_SELECTOR"] = "FLAGD_SOURCE_SELECTOR";
     ENV_VAR["FLAGD_RESOLVER"] = "FLAGD_RESOLVER";
+    ENV_VAR["FLAGD_OFFLINE_FLAG_SOURCE_PATH"] = "FLAGD_OFFLINE_FLAG_SOURCE_PATH";
 })(ENV_VAR || (ENV_VAR = {}));
 const getEnvVarConfig = () => {
     var _a;
-    return (Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, (process.env[ENV_VAR.FLAGD_HOST] && {
+    return (Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, (process.env[ENV_VAR.FLAGD_HOST] && {
         host: process.env[ENV_VAR.FLAGD_HOST],
     })), (Number(process.env[ENV_VAR.FLAGD_PORT]) && {
         port: Number(process.env[ENV_VAR.FLAGD_PORT]),
@@ -53,6 +54,8 @@ const getEnvVarConfig = () => {
         selector: process.env[ENV_VAR.FLAGD_SOURCE_SELECTOR],
     })), ((process.env[ENV_VAR.FLAGD_RESOLVER] === 'rpc' || process.env[ENV_VAR.FLAGD_RESOLVER] === 'in-process') && {
         resolverType: process.env[ENV_VAR.FLAGD_RESOLVER],
+    })), (process.env[ENV_VAR.FLAGD_OFFLINE_FLAG_SOURCE_PATH] && {
+        offlineFlagSourcePath: process.env[ENV_VAR.FLAGD_OFFLINE_FLAG_SOURCE_PATH],
     })));
 };
 function getConfig(options = {}) {
@@ -5753,7 +5756,7 @@ const EventStreamRequest = {
 };
 const ServiceService = {
     resolveAll: {
-        path: "/schema.v1.Service/ResolveAll",
+        path: "/flagd.evaluation.v1.Service/ResolveAll",
         requestStream: false,
         responseStream: false,
         requestSerialize: (value) => Buffer.from(ResolveAllRequest.encode(value).finish()),
@@ -5762,7 +5765,7 @@ const ServiceService = {
         responseDeserialize: (value) => ResolveAllResponse.decode(value),
     },
     resolveBoolean: {
-        path: "/schema.v1.Service/ResolveBoolean",
+        path: "/flagd.evaluation.v1.Service/ResolveBoolean",
         requestStream: false,
         responseStream: false,
         requestSerialize: (value) => Buffer.from(ResolveBooleanRequest.encode(value).finish()),
@@ -5771,7 +5774,7 @@ const ServiceService = {
         responseDeserialize: (value) => ResolveBooleanResponse.decode(value),
     },
     resolveString: {
-        path: "/schema.v1.Service/ResolveString",
+        path: "/flagd.evaluation.v1.Service/ResolveString",
         requestStream: false,
         responseStream: false,
         requestSerialize: (value) => Buffer.from(ResolveStringRequest.encode(value).finish()),
@@ -5780,7 +5783,7 @@ const ServiceService = {
         responseDeserialize: (value) => ResolveStringResponse.decode(value),
     },
     resolveFloat: {
-        path: "/schema.v1.Service/ResolveFloat",
+        path: "/flagd.evaluation.v1.Service/ResolveFloat",
         requestStream: false,
         responseStream: false,
         requestSerialize: (value) => Buffer.from(ResolveFloatRequest.encode(value).finish()),
@@ -5789,7 +5792,7 @@ const ServiceService = {
         responseDeserialize: (value) => ResolveFloatResponse.decode(value),
     },
     resolveInt: {
-        path: "/schema.v1.Service/ResolveInt",
+        path: "/flagd.evaluation.v1.Service/ResolveInt",
         requestStream: false,
         responseStream: false,
         requestSerialize: (value) => Buffer.from(ResolveIntRequest.encode(value).finish()),
@@ -5798,7 +5801,7 @@ const ServiceService = {
         responseDeserialize: (value) => ResolveIntResponse.decode(value),
     },
     resolveObject: {
-        path: "/schema.v1.Service/ResolveObject",
+        path: "/flagd.evaluation.v1.Service/ResolveObject",
         requestStream: false,
         responseStream: false,
         requestSerialize: (value) => Buffer.from(ResolveObjectRequest.encode(value).finish()),
@@ -5807,7 +5810,7 @@ const ServiceService = {
         responseDeserialize: (value) => ResolveObjectResponse.decode(value),
     },
     eventStream: {
-        path: "/schema.v1.Service/EventStream",
+        path: "/flagd.evaluation.v1.Service/EventStream",
         requestStream: false,
         responseStream: true,
         requestSerialize: (value) => Buffer.from(EventStreamRequest.encode(value).finish()),
@@ -5816,7 +5819,7 @@ const ServiceService = {
         responseDeserialize: (value) => EventStreamResponse.decode(value),
     },
 };
-const ServiceClient = grpcJs.makeGenericClientConstructor(ServiceService, "schema.v1.Service");
+const ServiceClient = grpcJs.makeGenericClientConstructor(ServiceService, "flagd.evaluation.v1.Service");
 function longToString(long) {
     return long.toString();
 }
@@ -6001,83 +6004,6 @@ class GRPCService {
 }
 
 /* eslint-disable */
-/**
- * Flag definition sync API
- *
- * This proto defines a simple API to synchronize a feature flag definition.
- * It supports establishing a stream for getting notifications about changes in a flag definition.
- */
-/**
- * SyncState conveys the state of the payload. These states are related to flagd isync.go type definitions but
- * contains extras to optimize grpc use case. Refer - https://github.com/open-feature/flagd/blob/main/pkg/sync/isync.go
- */
-var SyncState;
-(function (SyncState) {
-    /** SYNC_STATE_UNSPECIFIED - Value is ignored by the listening flagd */
-    SyncState[SyncState["SYNC_STATE_UNSPECIFIED"] = 0] = "SYNC_STATE_UNSPECIFIED";
-    /**
-     * SYNC_STATE_ALL - All the flags matching the request. This is the default response and other states can be ignored
-     * by the implementation. Flagd internally replaces all existing flags for this response state.
-     */
-    SyncState[SyncState["SYNC_STATE_ALL"] = 1] = "SYNC_STATE_ALL";
-    /** SYNC_STATE_ADD - Convey an addition of a flag. Flagd internally handles this by combining new flags with existing ones */
-    SyncState[SyncState["SYNC_STATE_ADD"] = 2] = "SYNC_STATE_ADD";
-    /**
-     * SYNC_STATE_UPDATE - Convey an update of a flag. Flagd internally attempts to update if the updated flag already exist OR if it does not,
-     * it will get added
-     */
-    SyncState[SyncState["SYNC_STATE_UPDATE"] = 3] = "SYNC_STATE_UPDATE";
-    /** SYNC_STATE_DELETE - Convey a deletion of a flag. Flagd internally removes the flag */
-    SyncState[SyncState["SYNC_STATE_DELETE"] = 4] = "SYNC_STATE_DELETE";
-    /** SYNC_STATE_PING - Optional server ping to check client connectivity. Handling is ignored by flagd and is to merely support live check */
-    SyncState[SyncState["SYNC_STATE_PING"] = 5] = "SYNC_STATE_PING";
-    SyncState[SyncState["UNRECOGNIZED"] = -1] = "UNRECOGNIZED";
-})(SyncState || (SyncState = {}));
-function syncStateFromJSON(object) {
-    switch (object) {
-        case 0:
-        case "SYNC_STATE_UNSPECIFIED":
-            return SyncState.SYNC_STATE_UNSPECIFIED;
-        case 1:
-        case "SYNC_STATE_ALL":
-            return SyncState.SYNC_STATE_ALL;
-        case 2:
-        case "SYNC_STATE_ADD":
-            return SyncState.SYNC_STATE_ADD;
-        case 3:
-        case "SYNC_STATE_UPDATE":
-            return SyncState.SYNC_STATE_UPDATE;
-        case 4:
-        case "SYNC_STATE_DELETE":
-            return SyncState.SYNC_STATE_DELETE;
-        case 5:
-        case "SYNC_STATE_PING":
-            return SyncState.SYNC_STATE_PING;
-        case -1:
-        case "UNRECOGNIZED":
-        default:
-            return SyncState.UNRECOGNIZED;
-    }
-}
-function syncStateToJSON(object) {
-    switch (object) {
-        case SyncState.SYNC_STATE_UNSPECIFIED:
-            return "SYNC_STATE_UNSPECIFIED";
-        case SyncState.SYNC_STATE_ALL:
-            return "SYNC_STATE_ALL";
-        case SyncState.SYNC_STATE_ADD:
-            return "SYNC_STATE_ADD";
-        case SyncState.SYNC_STATE_UPDATE:
-            return "SYNC_STATE_UPDATE";
-        case SyncState.SYNC_STATE_DELETE:
-            return "SYNC_STATE_DELETE";
-        case SyncState.SYNC_STATE_PING:
-            return "SYNC_STATE_PING";
-        case SyncState.UNRECOGNIZED:
-        default:
-            return "UNRECOGNIZED";
-    }
-}
 function createBaseSyncFlagsRequest() {
     return { providerId: "", selector: "" };
 }
@@ -6146,16 +6072,13 @@ const SyncFlagsRequest = {
     },
 };
 function createBaseSyncFlagsResponse() {
-    return { flagConfiguration: "", state: 0 };
+    return { flagConfiguration: "" };
 }
 const SyncFlagsResponse = {
     encode(message, writer = minimal.Writer.create()) {
         if (message.flagConfiguration !== "") {
             writer.uint32(10).string(message.flagConfiguration);
         }
-        if (message.state !== 0) {
-            writer.uint32(16).int32(message.state);
-        }
         return writer;
     },
     decode(input, length) {
@@ -6171,12 +6094,6 @@ const SyncFlagsResponse = {
                     }
                     message.flagConfiguration = reader.string();
                     continue;
-                case 2:
-                    if (tag !== 16) {
-                        break;
-                    }
-                    message.state = reader.int32();
-                    continue;
             }
             if ((tag & 7) === 4 || tag === 0) {
                 break;
@@ -6186,29 +6103,22 @@ const SyncFlagsResponse = {
         return message;
     },
     fromJSON(object) {
-        return {
-            flagConfiguration: isSet(object.flagConfiguration) ? String(object.flagConfiguration) : "",
-            state: isSet(object.state) ? syncStateFromJSON(object.state) : 0,
-        };
+        return { flagConfiguration: isSet(object.flagConfiguration) ? String(object.flagConfiguration) : "" };
     },
     toJSON(message) {
         const obj = {};
         if (message.flagConfiguration !== "") {
             obj.flagConfiguration = message.flagConfiguration;
         }
-        if (message.state !== 0) {
-            obj.state = syncStateToJSON(message.state);
-        }
         return obj;
     },
     create(base) {
         return SyncFlagsResponse.fromPartial(base !== null && base !== void 0 ? base : {});
     },
     fromPartial(object) {
-        var _a, _b;
+        var _a;
         const message = createBaseSyncFlagsResponse();
         message.flagConfiguration = (_a = object.flagConfiguration) !== null && _a !== void 0 ? _a : "";
-        message.state = (_b = object.state) !== null && _b !== void 0 ? _b : 0;
         return message;
     },
 };
@@ -6330,9 +6240,160 @@ const FetchAllFlagsResponse = {
         return message;
     },
 };
+function createBaseGetMetadataRequest() {
+    return {};
+}
+const GetMetadataRequest = {
+    encode(_, writer = minimal.Writer.create()) {
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof minimal.Reader ? input : minimal.Reader.create(input);
+        let end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseGetMetadataRequest();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skipType(tag & 7);
+        }
+        return message;
+    },
+    fromJSON(_) {
+        return {};
+    },
+    toJSON(_) {
+        const obj = {};
+        return obj;
+    },
+    create(base) {
+        return GetMetadataRequest.fromPartial(base !== null && base !== void 0 ? base : {});
+    },
+    fromPartial(_) {
+        const message = createBaseGetMetadataRequest();
+        return message;
+    },
+};
+function createBaseGetMetadataResponse() {
+    return { metadata: [] };
+}
+const GetMetadataResponse = {
+    encode(message, writer = minimal.Writer.create()) {
+        for (const v of message.metadata) {
+            KeyValue.encode(v, writer.uint32(10).fork()).ldelim();
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof minimal.Reader ? input : minimal.Reader.create(input);
+        let end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseGetMetadataResponse();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1:
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.metadata.push(KeyValue.decode(reader, reader.uint32()));
+                    continue;
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skipType(tag & 7);
+        }
+        return message;
+    },
+    fromJSON(object) {
+        return { metadata: Array.isArray(object === null || object === void 0 ? void 0 : object.metadata) ? object.metadata.map((e) => KeyValue.fromJSON(e)) : [] };
+    },
+    toJSON(message) {
+        var _a;
+        const obj = {};
+        if ((_a = message.metadata) === null || _a === void 0 ? void 0 : _a.length) {
+            obj.metadata = message.metadata.map((e) => KeyValue.toJSON(e));
+        }
+        return obj;
+    },
+    create(base) {
+        return GetMetadataResponse.fromPartial(base !== null && base !== void 0 ? base : {});
+    },
+    fromPartial(object) {
+        var _a;
+        const message = createBaseGetMetadataResponse();
+        message.metadata = ((_a = object.metadata) === null || _a === void 0 ? void 0 : _a.map((e) => KeyValue.fromPartial(e))) || [];
+        return message;
+    },
+};
+function createBaseKeyValue() {
+    return { key: "", value: "" };
+}
+const KeyValue = {
+    encode(message, writer = minimal.Writer.create()) {
+        if (message.key !== "") {
+            writer.uint32(10).string(message.key);
+        }
+        if (message.value !== "") {
+            writer.uint32(18).string(message.value);
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof minimal.Reader ? input : minimal.Reader.create(input);
+        let end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseKeyValue();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1:
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.key = reader.string();
+                    continue;
+                case 2:
+                    if (tag !== 18) {
+                        break;
+                    }
+                    message.value = reader.string();
+                    continue;
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skipType(tag & 7);
+        }
+        return message;
+    },
+    fromJSON(object) {
+        return { key: isSet(object.key) ? String(object.key) : "", value: isSet(object.value) ? String(object.value) : "" };
+    },
+    toJSON(message) {
+        const obj = {};
+        if (message.key !== "") {
+            obj.key = message.key;
+        }
+        if (message.value !== "") {
+            obj.value = message.value;
+        }
+        return obj;
+    },
+    create(base) {
+        return KeyValue.fromPartial(base !== null && base !== void 0 ? base : {});
+    },
+    fromPartial(object) {
+        var _a, _b;
+        const message = createBaseKeyValue();
+        message.key = (_a = object.key) !== null && _a !== void 0 ? _a : "";
+        message.value = (_b = object.value) !== null && _b !== void 0 ? _b : "";
+        return message;
+    },
+};
 const FlagSyncServiceService = {
     syncFlags: {
-        path: "/sync.v1.FlagSyncService/SyncFlags",
+        path: "/flagd.sync.v1.FlagSyncService/SyncFlags",
         requestStream: false,
         responseStream: true,
         requestSerialize: (value) => Buffer.from(SyncFlagsRequest.encode(value).finish()),
@@ -6341,7 +6402,7 @@ const FlagSyncServiceService = {
         responseDeserialize: (value) => SyncFlagsResponse.decode(value),
     },
     fetchAllFlags: {
-        path: "/sync.v1.FlagSyncService/FetchAllFlags",
+        path: "/flagd.sync.v1.FlagSyncService/FetchAllFlags",
         requestStream: false,
         responseStream: false,
         requestSerialize: (value) => Buffer.from(FetchAllFlagsRequest.encode(value).finish()),
@@ -6349,8 +6410,17 @@ const FlagSyncServiceService = {
         responseSerialize: (value) => Buffer.from(FetchAllFlagsResponse.encode(value).finish()),
         responseDeserialize: (value) => FetchAllFlagsResponse.decode(value),
     },
+    getMetadata: {
+        path: "/flagd.sync.v1.FlagSyncService/GetMetadata",
+        requestStream: false,
+        responseStream: false,
+        requestSerialize: (value) => Buffer.from(GetMetadataRequest.encode(value).finish()),
+        requestDeserialize: (value) => GetMetadataRequest.decode(value),
+        responseSerialize: (value) => Buffer.from(GetMetadataResponse.encode(value).finish()),
+        responseDeserialize: (value) => GetMetadataResponse.decode(value),
+    },
 };
-const FlagSyncServiceClient = grpcJs.makeGenericClientConstructor(FlagSyncServiceService, "sync.v1.FlagSyncService");
+const FlagSyncServiceClient = grpcJs.makeGenericClientConstructor(FlagSyncServiceService, "flagd.sync.v1.FlagSyncService");
 function isSet(value) {
     return value !== null && value !== undefined;
 }
@@ -6396,39 +6466,47 @@ class GrpcFetch {
         var _a;
         (_a = this._logger) === null || _a === void 0 ? void 0 : _a.debug('Starting gRPC sync connection');
         closeStreamIfDefined(this._syncStream);
-        this._syncStream = this._syncClient.syncFlags(this._request);
-        this._syncStream.on('data', (data) => {
-            var _a, _b, _c, _d;
-            (_a = this._logger) === null || _a === void 0 ? void 0 : _a.debug(`Received sync payload`);
-            try {
-                const changes = dataCallback(data.flagConfiguration);
-                if (this._initialized && changes.length > 0) {
-                    changedCallback(changes);
+        try {
+            this._syncStream = this._syncClient.syncFlags(this._request);
+            this._syncStream.on('data', (data) => {
+                var _a, _b, _c, _d;
+                (_a = this._logger) === null || _a === void 0 ? void 0 : _a.debug(`Received sync payload`);
+                try {
+                    const changes = dataCallback(data.flagConfiguration);
+                    if (this._initialized && changes.length > 0) {
+                        changedCallback(changes);
+                    }
                 }
-            }
-            catch (err) {
-                (_b = this._logger) === null || _b === void 0 ? void 0 : _b.debug('Error processing sync payload: ', (_c = err === null || err === void 0 ? void 0 : err.message) !== null && _c !== void 0 ? _c : 'unknown error');
-            }
-            if (resolveConnect) {
-                resolveConnect();
-            }
-            else if (!this._isConnected) {
-                // Not the first connection and there's no active connection.
-                (_d = this._logger) === null || _d === void 0 ? void 0 : _d.debug('Reconnected to gRPC sync');
-                reconnectCallback();
-            }
-            this._isConnected = true;
-        });
-        this._syncStream.on('error', (err) => {
-            var _a, _b, _c;
-            (_a = this._logger) === null || _a === void 0 ? void 0 : _a.error('Connection error, attempting to reconnect');
-            (_b = this._logger) === null || _b === void 0 ? void 0 : _b.debug(err);
-            this._isConnected = false;
-            const errorMessage = (_c = err === null || err === void 0 ? void 0 : err.message) !== null && _c !== void 0 ? _c : 'Failed to connect to syncFlags stream';
-            disconnectCallback(errorMessage);
-            rejectConnect === null || rejectConnect === void 0 ? void 0 : rejectConnect(new serverSdk.GeneralError(errorMessage));
-            this.reconnect(dataCallback, reconnectCallback, changedCallback, disconnectCallback);
-        });
+                catch (err) {
+                    (_b = this._logger) === null || _b === void 0 ? void 0 : _b.debug('Error processing sync payload: ', (_c = err === null || err === void 0 ? void 0 : err.message) !== null && _c !== void 0 ? _c : 'unknown error');
+                }
+                if (resolveConnect) {
+                    resolveConnect();
+                }
+                else if (!this._isConnected) {
+                    // Not the first connection and there's no active connection.
+                    (_d = this._logger) === null || _d === void 0 ? void 0 : _d.debug('Reconnected to gRPC sync');
+                    reconnectCallback();
+                }
+                this._isConnected = true;
+            });
+            this._syncStream.on('error', (err) => {
+                this.handleError(err, dataCallback, reconnectCallback, changedCallback, disconnectCallback, rejectConnect);
+            });
+        }
+        catch (err) {
+            this.handleError(err, dataCallback, reconnectCallback, changedCallback, disconnectCallback, rejectConnect);
+        }
+    }
+    handleError(err, dataCallback, reconnectCallback, changedCallback, disconnectCallback, rejectConnect) {
+        var _a, _b, _c;
+        (_a = this._logger) === null || _a === void 0 ? void 0 : _a.error('Connection error, attempting to reconnect');
+        (_b = this._logger) === null || _b === void 0 ? void 0 : _b.debug(err);
+        this._isConnected = false;
+        const errorMessage = (_c = err === null || err === void 0 ? void 0 : err.message) !== null && _c !== void 0 ? _c : 'Failed to connect to syncFlags stream';
+        disconnectCallback(errorMessage);
+        rejectConnect === null || rejectConnect === void 0 ? void 0 : rejectConnect(new serverSdk.GeneralError(errorMessage));
+        this.reconnect(dataCallback, reconnectCallback, changedCallback, disconnectCallback);
     }
     reconnect(dataCallback, reconnectCallback, changedCallback, disconnectCallback) {
         const channel = this._syncClient.getChannel();

package/index.esm.js

@@ -30,10 +30,11 @@ var ENV_VAR;
     ENV_VAR["FLAGD_MAX_CACHE_SIZE"] = "FLAGD_MAX_CACHE_SIZE";
     ENV_VAR["FLAGD_SOURCE_SELECTOR"] = "FLAGD_SOURCE_SELECTOR";
     ENV_VAR["FLAGD_RESOLVER"] = "FLAGD_RESOLVER";
+    ENV_VAR["FLAGD_OFFLINE_FLAG_SOURCE_PATH"] = "FLAGD_OFFLINE_FLAG_SOURCE_PATH";
 })(ENV_VAR || (ENV_VAR = {}));
 const getEnvVarConfig = () => {
     var _a;
-    return (Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, (process.env[ENV_VAR.FLAGD_HOST] && {
+    return (Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, (process.env[ENV_VAR.FLAGD_HOST] && {
         host: process.env[ENV_VAR.FLAGD_HOST],
     })), (Number(process.env[ENV_VAR.FLAGD_PORT]) && {
         port: Number(process.env[ENV_VAR.FLAGD_PORT]),
@@ -49,6 +50,8 @@ const getEnvVarConfig = () => {
         selector: process.env[ENV_VAR.FLAGD_SOURCE_SELECTOR],
     })), ((process.env[ENV_VAR.FLAGD_RESOLVER] === 'rpc' || process.env[ENV_VAR.FLAGD_RESOLVER] === 'in-process') && {
         resolverType: process.env[ENV_VAR.FLAGD_RESOLVER],
+    })), (process.env[ENV_VAR.FLAGD_OFFLINE_FLAG_SOURCE_PATH] && {
+        offlineFlagSourcePath: process.env[ENV_VAR.FLAGD_OFFLINE_FLAG_SOURCE_PATH],
     })));
 };
 function getConfig(options = {}) {
@@ -5749,7 +5752,7 @@ const EventStreamRequest = {
 };
 const ServiceService = {
     resolveAll: {
-        path: "/schema.v1.Service/ResolveAll",
+        path: "/flagd.evaluation.v1.Service/ResolveAll",
         requestStream: false,
         responseStream: false,
         requestSerialize: (value) => Buffer.from(ResolveAllRequest.encode(value).finish()),
@@ -5758,7 +5761,7 @@ const ServiceService = {
         responseDeserialize: (value) => ResolveAllResponse.decode(value),
     },
     resolveBoolean: {
-        path: "/schema.v1.Service/ResolveBoolean",
+        path: "/flagd.evaluation.v1.Service/ResolveBoolean",
         requestStream: false,
         responseStream: false,
         requestSerialize: (value) => Buffer.from(ResolveBooleanRequest.encode(value).finish()),
@@ -5767,7 +5770,7 @@ const ServiceService = {
         responseDeserialize: (value) => ResolveBooleanResponse.decode(value),
     },
     resolveString: {
-        path: "/schema.v1.Service/ResolveString",
+        path: "/flagd.evaluation.v1.Service/ResolveString",
         requestStream: false,
         responseStream: false,
         requestSerialize: (value) => Buffer.from(ResolveStringRequest.encode(value).finish()),
@@ -5776,7 +5779,7 @@ const ServiceService = {
         responseDeserialize: (value) => ResolveStringResponse.decode(value),
     },
     resolveFloat: {
-        path: "/schema.v1.Service/ResolveFloat",
+        path: "/flagd.evaluation.v1.Service/ResolveFloat",
         requestStream: false,
         responseStream: false,
         requestSerialize: (value) => Buffer.from(ResolveFloatRequest.encode(value).finish()),
@@ -5785,7 +5788,7 @@ const ServiceService = {
         responseDeserialize: (value) => ResolveFloatResponse.decode(value),
     },
     resolveInt: {
-        path: "/schema.v1.Service/ResolveInt",
+        path: "/flagd.evaluation.v1.Service/ResolveInt",
         requestStream: false,
         responseStream: false,
         requestSerialize: (value) => Buffer.from(ResolveIntRequest.encode(value).finish()),
@@ -5794,7 +5797,7 @@ const ServiceService = {
         responseDeserialize: (value) => ResolveIntResponse.decode(value),
     },
     resolveObject: {
-        path: "/schema.v1.Service/ResolveObject",
+        path: "/flagd.evaluation.v1.Service/ResolveObject",
         requestStream: false,
         responseStream: false,
         requestSerialize: (value) => Buffer.from(ResolveObjectRequest.encode(value).finish()),
@@ -5803,7 +5806,7 @@ const ServiceService = {
         responseDeserialize: (value) => ResolveObjectResponse.decode(value),
     },
     eventStream: {
-        path: "/schema.v1.Service/EventStream",
+        path: "/flagd.evaluation.v1.Service/EventStream",
         requestStream: false,
         responseStream: true,
         requestSerialize: (value) => Buffer.from(EventStreamRequest.encode(value).finish()),
@@ -5812,7 +5815,7 @@ const ServiceService = {
         responseDeserialize: (value) => EventStreamResponse.decode(value),
     },
 };
-const ServiceClient = makeGenericClientConstructor(ServiceService, "schema.v1.Service");
+const ServiceClient = makeGenericClientConstructor(ServiceService, "flagd.evaluation.v1.Service");
 function longToString(long) {
     return long.toString();
 }
@@ -5997,83 +6000,6 @@ class GRPCService {
 }
 
 /* eslint-disable */
-/**
- * Flag definition sync API
- *
- * This proto defines a simple API to synchronize a feature flag definition.
- * It supports establishing a stream for getting notifications about changes in a flag definition.
- */
-/**
- * SyncState conveys the state of the payload. These states are related to flagd isync.go type definitions but
- * contains extras to optimize grpc use case. Refer - https://github.com/open-feature/flagd/blob/main/pkg/sync/isync.go
- */
-var SyncState;
-(function (SyncState) {
-    /** SYNC_STATE_UNSPECIFIED - Value is ignored by the listening flagd */
-    SyncState[SyncState["SYNC_STATE_UNSPECIFIED"] = 0] = "SYNC_STATE_UNSPECIFIED";
-    /**
-     * SYNC_STATE_ALL - All the flags matching the request. This is the default response and other states can be ignored
-     * by the implementation. Flagd internally replaces all existing flags for this response state.
-     */
-    SyncState[SyncState["SYNC_STATE_ALL"] = 1] = "SYNC_STATE_ALL";
-    /** SYNC_STATE_ADD - Convey an addition of a flag. Flagd internally handles this by combining new flags with existing ones */
-    SyncState[SyncState["SYNC_STATE_ADD"] = 2] = "SYNC_STATE_ADD";
-    /**
-     * SYNC_STATE_UPDATE - Convey an update of a flag. Flagd internally attempts to update if the updated flag already exist OR if it does not,
-     * it will get added
-     */
-    SyncState[SyncState["SYNC_STATE_UPDATE"] = 3] = "SYNC_STATE_UPDATE";
-    /** SYNC_STATE_DELETE - Convey a deletion of a flag. Flagd internally removes the flag */
-    SyncState[SyncState["SYNC_STATE_DELETE"] = 4] = "SYNC_STATE_DELETE";
-    /** SYNC_STATE_PING - Optional server ping to check client connectivity. Handling is ignored by flagd and is to merely support live check */
-    SyncState[SyncState["SYNC_STATE_PING"] = 5] = "SYNC_STATE_PING";
-    SyncState[SyncState["UNRECOGNIZED"] = -1] = "UNRECOGNIZED";
-})(SyncState || (SyncState = {}));
-function syncStateFromJSON(object) {
-    switch (object) {
-        case 0:
-        case "SYNC_STATE_UNSPECIFIED":
-            return SyncState.SYNC_STATE_UNSPECIFIED;
-        case 1:
-        case "SYNC_STATE_ALL":
-            return SyncState.SYNC_STATE_ALL;
-        case 2:
-        case "SYNC_STATE_ADD":
-            return SyncState.SYNC_STATE_ADD;
-        case 3:
-        case "SYNC_STATE_UPDATE":
-            return SyncState.SYNC_STATE_UPDATE;
-        case 4:
-        case "SYNC_STATE_DELETE":
-            return SyncState.SYNC_STATE_DELETE;
-        case 5:
-        case "SYNC_STATE_PING":
-            return SyncState.SYNC_STATE_PING;
-        case -1:
-        case "UNRECOGNIZED":
-        default:
-            return SyncState.UNRECOGNIZED;
-    }
-}
-function syncStateToJSON(object) {
-    switch (object) {
-        case SyncState.SYNC_STATE_UNSPECIFIED:
-            return "SYNC_STATE_UNSPECIFIED";
-        case SyncState.SYNC_STATE_ALL:
-            return "SYNC_STATE_ALL";
-        case SyncState.SYNC_STATE_ADD:
-            return "SYNC_STATE_ADD";
-        case SyncState.SYNC_STATE_UPDATE:
-            return "SYNC_STATE_UPDATE";
-        case SyncState.SYNC_STATE_DELETE:
-            return "SYNC_STATE_DELETE";
-        case SyncState.SYNC_STATE_PING:
-            return "SYNC_STATE_PING";
-        case SyncState.UNRECOGNIZED:
-        default:
-            return "UNRECOGNIZED";
-    }
-}
 function createBaseSyncFlagsRequest() {
     return { providerId: "", selector: "" };
 }
@@ -6142,16 +6068,13 @@ const SyncFlagsRequest = {
     },
 };
 function createBaseSyncFlagsResponse() {
-    return { flagConfiguration: "", state: 0 };
+    return { flagConfiguration: "" };
 }
 const SyncFlagsResponse = {
     encode(message, writer = minimal.Writer.create()) {
         if (message.flagConfiguration !== "") {
             writer.uint32(10).string(message.flagConfiguration);
         }
-        if (message.state !== 0) {
-            writer.uint32(16).int32(message.state);
-        }
         return writer;
     },
     decode(input, length) {
@@ -6167,12 +6090,6 @@ const SyncFlagsResponse = {
                     }
                     message.flagConfiguration = reader.string();
                     continue;
-                case 2:
-                    if (tag !== 16) {
-                        break;
-                    }
-                    message.state = reader.int32();
-                    continue;
             }
             if ((tag & 7) === 4 || tag === 0) {
                 break;
@@ -6182,29 +6099,22 @@ const SyncFlagsResponse = {
         return message;
     },
     fromJSON(object) {
-        return {
-            flagConfiguration: isSet(object.flagConfiguration) ? String(object.flagConfiguration) : "",
-            state: isSet(object.state) ? syncStateFromJSON(object.state) : 0,
-        };
+        return { flagConfiguration: isSet(object.flagConfiguration) ? String(object.flagConfiguration) : "" };
     },
     toJSON(message) {
         const obj = {};
         if (message.flagConfiguration !== "") {
             obj.flagConfiguration = message.flagConfiguration;
         }
-        if (message.state !== 0) {
-            obj.state = syncStateToJSON(message.state);
-        }
         return obj;
     },
     create(base) {
         return SyncFlagsResponse.fromPartial(base !== null && base !== void 0 ? base : {});
     },
     fromPartial(object) {
-        var _a, _b;
+        var _a;
         const message = createBaseSyncFlagsResponse();
         message.flagConfiguration = (_a = object.flagConfiguration) !== null && _a !== void 0 ? _a : "";
-        message.state = (_b = object.state) !== null && _b !== void 0 ? _b : 0;
         return message;
     },
 };
@@ -6326,9 +6236,160 @@ const FetchAllFlagsResponse = {
         return message;
     },
 };
+function createBaseGetMetadataRequest() {
+    return {};
+}
+const GetMetadataRequest = {
+    encode(_, writer = minimal.Writer.create()) {
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof minimal.Reader ? input : minimal.Reader.create(input);
+        let end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseGetMetadataRequest();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skipType(tag & 7);
+        }
+        return message;
+    },
+    fromJSON(_) {
+        return {};
+    },
+    toJSON(_) {
+        const obj = {};
+        return obj;
+    },
+    create(base) {
+        return GetMetadataRequest.fromPartial(base !== null && base !== void 0 ? base : {});
+    },
+    fromPartial(_) {
+        const message = createBaseGetMetadataRequest();
+        return message;
+    },
+};
+function createBaseGetMetadataResponse() {
+    return { metadata: [] };
+}
+const GetMetadataResponse = {
+    encode(message, writer = minimal.Writer.create()) {
+        for (const v of message.metadata) {
+            KeyValue.encode(v, writer.uint32(10).fork()).ldelim();
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof minimal.Reader ? input : minimal.Reader.create(input);
+        let end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseGetMetadataResponse();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1:
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.metadata.push(KeyValue.decode(reader, reader.uint32()));
+                    continue;
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skipType(tag & 7);
+        }
+        return message;
+    },
+    fromJSON(object) {
+        return { metadata: Array.isArray(object === null || object === void 0 ? void 0 : object.metadata) ? object.metadata.map((e) => KeyValue.fromJSON(e)) : [] };
+    },
+    toJSON(message) {
+        var _a;
+        const obj = {};
+        if ((_a = message.metadata) === null || _a === void 0 ? void 0 : _a.length) {
+            obj.metadata = message.metadata.map((e) => KeyValue.toJSON(e));
+        }
+        return obj;
+    },
+    create(base) {
+        return GetMetadataResponse.fromPartial(base !== null && base !== void 0 ? base : {});
+    },
+    fromPartial(object) {
+        var _a;
+        const message = createBaseGetMetadataResponse();
+        message.metadata = ((_a = object.metadata) === null || _a === void 0 ? void 0 : _a.map((e) => KeyValue.fromPartial(e))) || [];
+        return message;
+    },
+};
+function createBaseKeyValue() {
+    return { key: "", value: "" };
+}
+const KeyValue = {
+    encode(message, writer = minimal.Writer.create()) {
+        if (message.key !== "") {
+            writer.uint32(10).string(message.key);
+        }
+        if (message.value !== "") {
+            writer.uint32(18).string(message.value);
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof minimal.Reader ? input : minimal.Reader.create(input);
+        let end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseKeyValue();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1:
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.key = reader.string();
+                    continue;
+                case 2:
+                    if (tag !== 18) {
+                        break;
+                    }
+                    message.value = reader.string();
+                    continue;
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skipType(tag & 7);
+        }
+        return message;
+    },
+    fromJSON(object) {
+        return { key: isSet(object.key) ? String(object.key) : "", value: isSet(object.value) ? String(object.value) : "" };
+    },
+    toJSON(message) {
+        const obj = {};
+        if (message.key !== "") {
+            obj.key = message.key;
+        }
+        if (message.value !== "") {
+            obj.value = message.value;
+        }
+        return obj;
+    },
+    create(base) {
+        return KeyValue.fromPartial(base !== null && base !== void 0 ? base : {});
+    },
+    fromPartial(object) {
+        var _a, _b;
+        const message = createBaseKeyValue();
+        message.key = (_a = object.key) !== null && _a !== void 0 ? _a : "";
+        message.value = (_b = object.value) !== null && _b !== void 0 ? _b : "";
+        return message;
+    },
+};
 const FlagSyncServiceService = {
     syncFlags: {
-        path: "/sync.v1.FlagSyncService/SyncFlags",
+        path: "/flagd.sync.v1.FlagSyncService/SyncFlags",
         requestStream: false,
         responseStream: true,
         requestSerialize: (value) => Buffer.from(SyncFlagsRequest.encode(value).finish()),
@@ -6337,7 +6398,7 @@ const FlagSyncServiceService = {
         responseDeserialize: (value) => SyncFlagsResponse.decode(value),
     },
     fetchAllFlags: {
-        path: "/sync.v1.FlagSyncService/FetchAllFlags",
+        path: "/flagd.sync.v1.FlagSyncService/FetchAllFlags",
         requestStream: false,
         responseStream: false,
         requestSerialize: (value) => Buffer.from(FetchAllFlagsRequest.encode(value).finish()),
@@ -6345,8 +6406,17 @@ const FlagSyncServiceService = {
         responseSerialize: (value) => Buffer.from(FetchAllFlagsResponse.encode(value).finish()),
         responseDeserialize: (value) => FetchAllFlagsResponse.decode(value),
     },
+    getMetadata: {
+        path: "/flagd.sync.v1.FlagSyncService/GetMetadata",
+        requestStream: false,
+        responseStream: false,
+        requestSerialize: (value) => Buffer.from(GetMetadataRequest.encode(value).finish()),
+        requestDeserialize: (value) => GetMetadataRequest.decode(value),
+        responseSerialize: (value) => Buffer.from(GetMetadataResponse.encode(value).finish()),
+        responseDeserialize: (value) => GetMetadataResponse.decode(value),
+    },
 };
-const FlagSyncServiceClient = makeGenericClientConstructor(FlagSyncServiceService, "sync.v1.FlagSyncService");
+const FlagSyncServiceClient = makeGenericClientConstructor(FlagSyncServiceService, "flagd.sync.v1.FlagSyncService");
 function isSet(value) {
     return value !== null && value !== undefined;
 }
@@ -6392,39 +6462,47 @@ class GrpcFetch {
         var _a;
         (_a = this._logger) === null || _a === void 0 ? void 0 : _a.debug('Starting gRPC sync connection');
         closeStreamIfDefined(this._syncStream);
-        this._syncStream = this._syncClient.syncFlags(this._request);
-        this._syncStream.on('data', (data) => {
-            var _a, _b, _c, _d;
-            (_a = this._logger) === null || _a === void 0 ? void 0 : _a.debug(`Received sync payload`);
-            try {
-                const changes = dataCallback(data.flagConfiguration);
-                if (this._initialized && changes.length > 0) {
-                    changedCallback(changes);
+        try {
+            this._syncStream = this._syncClient.syncFlags(this._request);
+            this._syncStream.on('data', (data) => {
+                var _a, _b, _c, _d;
+                (_a = this._logger) === null || _a === void 0 ? void 0 : _a.debug(`Received sync payload`);
+                try {
+                    const changes = dataCallback(data.flagConfiguration);
+                    if (this._initialized && changes.length > 0) {
+                        changedCallback(changes);
+                    }
                 }
-            }
-            catch (err) {
-                (_b = this._logger) === null || _b === void 0 ? void 0 : _b.debug('Error processing sync payload: ', (_c = err === null || err === void 0 ? void 0 : err.message) !== null && _c !== void 0 ? _c : 'unknown error');
-            }
-            if (resolveConnect) {
-                resolveConnect();
-            }
-            else if (!this._isConnected) {
-                // Not the first connection and there's no active connection.
-                (_d = this._logger) === null || _d === void 0 ? void 0 : _d.debug('Reconnected to gRPC sync');
-                reconnectCallback();
-            }
-            this._isConnected = true;
-        });
-        this._syncStream.on('error', (err) => {
-            var _a, _b, _c;
-            (_a = this._logger) === null || _a === void 0 ? void 0 : _a.error('Connection error, attempting to reconnect');
-            (_b = this._logger) === null || _b === void 0 ? void 0 : _b.debug(err);
-            this._isConnected = false;
-            const errorMessage = (_c = err === null || err === void 0 ? void 0 : err.message) !== null && _c !== void 0 ? _c : 'Failed to connect to syncFlags stream';
-            disconnectCallback(errorMessage);
-            rejectConnect === null || rejectConnect === void 0 ? void 0 : rejectConnect(new GeneralError(errorMessage));
-            this.reconnect(dataCallback, reconnectCallback, changedCallback, disconnectCallback);
-        });
+                catch (err) {
+                    (_b = this._logger) === null || _b === void 0 ? void 0 : _b.debug('Error processing sync payload: ', (_c = err === null || err === void 0 ? void 0 : err.message) !== null && _c !== void 0 ? _c : 'unknown error');
+                }
+                if (resolveConnect) {
+                    resolveConnect();
+                }
+                else if (!this._isConnected) {
+                    // Not the first connection and there's no active connection.
+                    (_d = this._logger) === null || _d === void 0 ? void 0 : _d.debug('Reconnected to gRPC sync');
+                    reconnectCallback();
+                }
+                this._isConnected = true;
+            });
+            this._syncStream.on('error', (err) => {
+                this.handleError(err, dataCallback, reconnectCallback, changedCallback, disconnectCallback, rejectConnect);
+            });
+        }
+        catch (err) {
+            this.handleError(err, dataCallback, reconnectCallback, changedCallback, disconnectCallback, rejectConnect);
+        }
+    }
+    handleError(err, dataCallback, reconnectCallback, changedCallback, disconnectCallback, rejectConnect) {
+        var _a, _b, _c;
+        (_a = this._logger) === null || _a === void 0 ? void 0 : _a.error('Connection error, attempting to reconnect');
+        (_b = this._logger) === null || _b === void 0 ? void 0 : _b.debug(err);
+        this._isConnected = false;
+        const errorMessage = (_c = err === null || err === void 0 ? void 0 : err.message) !== null && _c !== void 0 ? _c : 'Failed to connect to syncFlags stream';
+        disconnectCallback(errorMessage);
+        rejectConnect === null || rejectConnect === void 0 ? void 0 : rejectConnect(new GeneralError(errorMessage));
+        this.reconnect(dataCallback, reconnectCallback, changedCallback, disconnectCallback);
     }
     reconnect(dataCallback, reconnectCallback, changedCallback, disconnectCallback) {
         const channel = this._syncClient.getChannel();

package/package.json

@@ -1,18 +1,18 @@
 {
   "name": "@openfeature/flagd-provider",
-  "version": "0.10.4",
+  "version": "0.11.0",
   "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"
   },
   "dependencies": {
-    "@openfeature/flagd-core": "~0.1.7",
+    "@openfeature/flagd-core": "~0.1.10",
     "@protobuf-ts/runtime-rpc": "2.9.0",
     "lru-cache": "10.0.1",
     "util": "0.12.5"
   },
   "peerDependencies": {
-    "@grpc/grpc-js": "~1.8.0 || ~1.9.0",
+    "@grpc/grpc-js": "~1.8.0 || ~1.9.0 || ~1.10.0",
     "@openfeature/server-sdk": ">=1.8.0"
   },
   "exports": {

package/src/e2e/constants.d.ts

@@ -0,0 +1,4 @@
+export declare const FLAGD_NAME = "flagd Provider";
+export declare const E2E_CLIENT_NAME = "e2e";
+export declare const UNSTABLE_CLIENT_NAME = "unstable";
+export declare const UNAVAILABLE_CLIENT_NAME = "unavailable";

package/src/lib/service/grpc/grpc-service.d.ts

@@ -1,5 +1,5 @@
 import { EvaluationContext, JsonValue, Logger, ResolutionDetails } from '@openfeature/server-sdk';
-import { ServiceClient } from '../../../proto/ts/schema/v1/schema';
+import { ServiceClient } from '../../../proto/ts/flagd/evaluation/v1/evaluation';
 import { Config } from '../../configuration';
 import { Service } from '../service';
 interface FlagChange {

package/src/lib/service/in-process/grpc/grpc-fetch.d.ts

@@ -1,5 +1,5 @@
 import { Logger } from '@openfeature/core';
-import { FlagSyncServiceClient } from '../../../../proto/ts/sync/v1/sync_service';
+import { FlagSyncServiceClient } from '../../../../proto/ts/flagd/sync/v1/sync';
 import { Config } from '../../../configuration';
 import { DataFetch } from '../data-fetch';
 /**
@@ -26,5 +26,6 @@ export declare class GrpcFetch implements DataFetch {
     connect(dataCallback: (flags: string) => string[], reconnectCallback: () => void, changedCallback: (flagsChanged: string[]) => void, disconnectCallback: (message: string) => void): Promise<void>;
     disconnect(): Promise<void>;
     private listen;
+    private handleError;
     private reconnect;
 }