@stigg/node-server-sdk 4.15.0 → 4.16.0

package/dist/utils/entitlementFallbackUtils.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEntitlementV2FallbackFromOptions = exports.getFeatureFallbackFromOptions = exports.buildCreditFallbackEntitlement = exports.isNumericEntitlementOptions = exports.isEnumEntitlementOptions = exports.isMeteredEntitlementOptions = void 0;
+const models_1 = require("../models");
+const cache_1 = require("../services/cache");
+function isMeteredEntitlementOptions(options) {
+    return options != null && 'requestedUsage' in options;
+}
+exports.isMeteredEntitlementOptions = isMeteredEntitlementOptions;
+function isEnumEntitlementOptions(options) {
+    return options != null && 'requestedValues' in options;
+}
+exports.isEnumEntitlementOptions = isEnumEntitlementOptions;
+/**
+ * True when options indicate a numeric (limit-based) feature fallback.
+ */
+function isNumericEntitlementOptions(options) {
+    const fallback = options === null || options === void 0 ? void 0 : options.fallback;
+    return options != null && fallback != null && 'value' in fallback;
+}
+exports.isNumericEntitlementOptions = isNumericEntitlementOptions;
+/** Builds a credit fallback entitlement; remaining = max(usageLimit - currentUsage, 0) when both are set in fallback. */
+function buildCreditFallbackEntitlement(params) {
+    const { currencyId, accessDeniedReason, fallback = {} } = params;
+    const base = Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, models_1.CREDIT_DEFAULT_FALLBACK_ENTITLEMENT), { currency: { currencyId } }), (accessDeniedReason !== undefined && { accessDeniedReason })), fallback), { isFallback: true });
+    const { usageLimit, currentUsage, remaining } = base;
+    const normalizedAccessDeniedReason = base.hasAccess ? undefined : base.accessDeniedReason;
+    return Object.assign(Object.assign({}, base), { accessDeniedReason: normalizedAccessDeniedReason, remaining: typeof usageLimit === 'number' && typeof currentUsage === 'number'
+            ? Math.max(usageLimit - currentUsage, 0)
+            : remaining });
+}
+exports.buildCreditFallbackEntitlement = buildCreditFallbackEntitlement;
+/**
+ * Returns the appropriate default fallback entitlement for a feature (regular/getEntitlement path).
+ */
+function getFeatureFallbackFromOptions(options) {
+    var _a;
+    const fallbackOverrides = (_a = options === null || options === void 0 ? void 0 : options.fallback) !== null && _a !== void 0 ? _a : {};
+    if (isMeteredEntitlementOptions(options)) {
+        return Object.assign(Object.assign({}, models_1.METERED_DEFAULT_FALLBACK_ENTITLEMENT), fallbackOverrides);
+    }
+    if (isEnumEntitlementOptions(options)) {
+        return Object.assign(Object.assign({}, models_1.ENUM_DEFAULT_FALLBACK_ENTITLEMENT), fallbackOverrides);
+    }
+    if (isNumericEntitlementOptions(options)) {
+        return Object.assign(Object.assign({}, models_1.NUMERIC_DEFAULT_FALLBACK_ENTITLEMENT), fallbackOverrides);
+    }
+    return Object.assign(Object.assign({}, models_1.BOOLEAN_DEFAULT_FALLBACK_ENTITLEMENT), fallbackOverrides);
+}
+exports.getFeatureFallbackFromOptions = getFeatureFallbackFromOptions;
+/**
+ * Returns the appropriate fallback for getEntitlementV2: feature or credit, based on entitlementReference.type.
+ */
+function getEntitlementV2FallbackFromOptions(entitlementReference, options, accessDeniedReason) {
+    if (entitlementReference.type === cache_1.EntitlementType.Credit) {
+        return buildCreditFallbackEntitlement({
+            currencyId: entitlementReference.id,
+            accessDeniedReason,
+            fallback: options === null || options === void 0 ? void 0 : options.fallback,
+        });
+    }
+    const base = getFeatureFallbackFromOptions(options);
+    const featureAccessDeniedReason = base.hasAccess ? undefined : accessDeniedReason !== null && accessDeniedReason !== void 0 ? accessDeniedReason : base.accessDeniedReason;
+    return Object.assign(Object.assign({}, base), { accessDeniedReason: featureAccessDeniedReason, isFallback: true });
+}
+exports.getEntitlementV2FallbackFromOptions = getEntitlementV2FallbackFromOptions;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZW50aXRsZW1lbnRGYWxsYmFja1V0aWxzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3V0aWxzL2VudGl0bGVtZW50RmFsbGJhY2tVdGlscy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFBQSxzQ0FXbUI7QUFPbkIsNkNBQXNFO0FBRXRFLFNBQWdCLDJCQUEyQixDQUN6QyxPQUF5QztJQUV6QyxPQUFPLE9BQU8sSUFBSSxJQUFJLElBQUksZ0JBQWdCLElBQUksT0FBTyxDQUFDO0FBQ3hELENBQUM7QUFKRCxrRUFJQztBQUVELFNBQWdCLHdCQUF3QixDQUFDLE9BQXlDO0lBQ2hGLE9BQU8sT0FBTyxJQUFJLElBQUksSUFBSSxpQkFBaUIsSUFBSSxPQUFPLENBQUM7QUFDekQsQ0FBQztBQUZELDREQUVDO0FBRUQ7O0dBRUc7QUFDSCxTQUFnQiwyQkFBMkIsQ0FDekMsT0FBeUM7SUFFekMsTUFBTSxRQUFRLEdBQUcsT0FBTyxhQUFQLE9BQU8sdUJBQVAsT0FBTyxDQUFFLFFBQVEsQ0FBQztJQUNuQyxPQUFPLE9BQU8sSUFBSSxJQUFJLElBQUksUUFBUSxJQUFJLElBQUksSUFBSSxPQUFPLElBQUksUUFBUSxDQUFDO0FBQ3BFLENBQUM7QUFMRCxrRUFLQztBQUVELHlIQUF5SDtBQUN6SCxTQUFnQiw4QkFBOEIsQ0FBQyxNQUk5QztJQUNDLE1BQU0sRUFBRSxVQUFVLEVBQUUsa0JBQWtCLEVBQUUsUUFBUSxHQUFHLEVBQUUsRUFBRSxHQUFHLE1BQU0sQ0FBQztJQUNqRSxNQUFNLElBQUksNkVBQ0wsNENBQW1DLEtBQ3RDLFFBQVEsRUFBRSxFQUFFLFVBQVUsRUFBRSxLQUNyQixDQUFDLGtCQUFrQixLQUFLLFNBQVMsSUFBSSxFQUFFLGtCQUFrQixFQUFFLENBQUMsR0FDNUQsUUFBUSxLQUNYLFVBQVUsRUFBRSxJQUFJLEdBQ2pCLENBQUM7SUFDRixNQUFNLEVBQUUsVUFBVSxFQUFFLFlBQVksRUFBRSxTQUFTLEVBQUUsR0FBRyxJQUFJLENBQUM7SUFDckQsTUFBTSw0QkFBNEIsR0FBRyxJQUFJLENBQUMsU0FBUyxDQUFDLENBQUMsQ0FBQyxTQUFTLENBQUMsQ0FBQyxDQUFDLElBQUksQ0FBQyxrQkFBa0IsQ0FBQztJQUMxRix1Q0FDSyxJQUFJLEtBQ1Asa0JBQWtCLEVBQUUsNEJBQTRCLEVBQ2hELFNBQVMsRUFDUCxPQUFPLFVBQVUsS0FBSyxRQUFRLElBQUksT0FBTyxZQUFZLEtBQUssUUFBUTtZQUNoRSxDQUFDLENBQUMsSUFBSSxDQUFDLEdBQUcsQ0FBQyxVQUFVLEdBQUcsWUFBWSxFQUFFLENBQUMsQ0FBQztZQUN4QyxDQUFDLENBQUMsU0FBUyxJQUNmO0FBQ0osQ0FBQztBQXZCRCx3RUF1QkM7QUFFRDs7R0FFRztBQUNILFNBQWdCLDZCQUE2QixDQUFDLE9BQThCOztJQUMxRSxNQUFNLGlCQUFpQixHQUFHLE1BQUEsT0FBTyxhQUFQLE9BQU8sdUJBQVAsT0FBTyxDQUFFLFFBQVEsbUNBQUksRUFBRSxDQUFDO0lBQ2xELElBQUksMkJBQTJCLENBQUMsT0FBTyxDQUFDLEVBQUU7UUFDeEMsdUNBQVksNkNBQW9DLEdBQUssaUJBQWlCLEVBQUc7S0FDMUU7SUFDRCxJQUFJLHdCQUF3QixDQUFDLE9BQU8sQ0FBQyxFQUFFO1FBQ3JDLHVDQUFZLDBDQUFpQyxHQUFLLGlCQUFpQixFQUFHO0tBQ3ZFO0lBQ0QsSUFBSSwyQkFBMkIsQ0FBQyxPQUFPLENBQUMsRUFBRTtRQUN4Qyx1Q0FBWSw2Q0FBb0MsR0FBSyxpQkFBaUIsRUFBRztLQUMxRTtJQUNELHVDQUFZLDZDQUFvQyxHQUFLLGlCQUFpQixFQUFHO0FBQzNFLENBQUM7QUFaRCxzRUFZQztBQUVEOztHQUVHO0FBQ0gsU0FBZ0IsbUNBQW1DLENBQ2pELG9CQUFzQyxFQUN0QyxPQUE4QixFQUM5QixrQkFBdUM7SUFFdkMsSUFBSSxvQkFBb0IsQ0FBQyxJQUFJLEtBQUssdUJBQWUsQ0FBQyxNQUFNLEVBQUU7UUFDeEQsT0FBTyw4QkFBOEIsQ0FBQztZQUNwQyxVQUFVLEVBQUUsb0JBQW9CLENBQUMsRUFBRTtZQUNuQyxrQkFBa0I7WUFDbEIsUUFBUSxFQUFFLE9BQU8sYUFBUCxPQUFPLHVCQUFQLE9BQU8sQ0FBRSxRQUFRO1NBQzVCLENBQUMsQ0FBQztLQUNKO0lBQ0QsTUFBTSxJQUFJLEdBQUcsNkJBQTZCLENBQUMsT0FBTyxDQUFDLENBQUM7SUFDcEQsTUFBTSx5QkFBeUIsR0FBRyxJQUFJLENBQUMsU0FBUyxDQUFDLENBQUMsQ0FBQyxTQUFTLENBQUMsQ0FBQyxDQUFDLGtCQUFrQixhQUFsQixrQkFBa0IsY0FBbEIsa0JBQWtCLEdBQUksSUFBSSxDQUFDLGtCQUFrQixDQUFDO0lBQzdHLHVDQUFZLElBQUksS0FBRSxrQkFBa0IsRUFBRSx5QkFBeUIsRUFBRSxVQUFVLEVBQUUsSUFBSSxJQUFHO0FBQ3RGLENBQUM7QUFmRCxrRkFlQyJ9

package/dist/utils/entitlementTypeGuards.d.ts

@@ -0,0 +1,6 @@
+import { EntitlementUnionFragment, FeatureEntitlementFragment } from '@stigg/api-client-js/src/generated/sdk';
+/**
+ * Type guard to check if an entitlement is a FeatureEntitlement.
+ * Uses __typename which is a standard GraphQL field for union type discrimination.
+ */
+export declare function isFeatureEntitlementFragment(entitlement: EntitlementUnionFragment): entitlement is FeatureEntitlementFragment;

package/dist/utils/entitlementTypeGuards.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isFeatureEntitlementFragment = void 0;
+/**
+ * Type guard to check if an entitlement is a FeatureEntitlement.
+ * Uses __typename which is a standard GraphQL field for union type discrimination.
+ */
+function isFeatureEntitlementFragment(entitlement) {
+    // eslint-disable-next-line no-underscore-dangle -- __typename is a standard GraphQL field for union type discrimination
+    return entitlement.__typename === 'FeatureEntitlement';
+}
+exports.isFeatureEntitlementFragment = isFeatureEntitlementFragment;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZW50aXRsZW1lbnRUeXBlR3VhcmRzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3V0aWxzL2VudGl0bGVtZW50VHlwZUd1YXJkcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFFQTs7O0dBR0c7QUFDSCxTQUFnQiw0QkFBNEIsQ0FDMUMsV0FBcUM7SUFFckMsd0hBQXdIO0lBQ3hILE9BQU8sV0FBVyxDQUFDLFVBQVUsS0FBSyxvQkFBb0IsQ0FBQztBQUN6RCxDQUFDO0FBTEQsb0VBS0MifQ==

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stigg/node-server-sdk",
-  "version": "4.15.0",
+  "version": "4.16.0",
   "description": "Stigg server-side node SDK",
   "main": "dist/index.js",
   "typings": "dist/index.d.ts",
@@ -34,7 +34,7 @@
     "@apollo/client": "~3.14.0",
     "@bitauth/libauth": "^1.17.1",
     "@graphql-codegen/fragment-matcher": "^3.2.1",
-    "@stigg/api-client-js": "5.224.1",
+    "@stigg/api-client-js": "5.225.0",
     "@types/ws": "^8.2.3",
     "axios": "^1.8.2",
     "axios-retry": "^4.0.0",