@useflagly/sdk-javascript 0.2.1 → 0.2.3

package/README.md

@@ -11,9 +11,9 @@ npm install @useflagly/sdk-javascript
 ## Uso
 
 ```js
-import { SystemSDK } from '@useflagly/sdk-javascript';
+import { UseFlaglyClient } from '@useflagly/sdk-javascript';
 
-const sdk = new SystemSDK({ token: 'seu-api-token' });
+const sdk = new UseFlaglyClient({ token: 'seu-api-token' });
 // A URL padrão é https://api.useflagly.com.br — pode ser sobrescrita com { baseUrl: '...' }
 
 // Validar flag

package/dist/index.d.ts

@@ -13,20 +13,27 @@ export type SDKOptions = {
     token?: string;
     timeoutMs?: number;
 };
-export declare class SystemSDK {
+export declare class FlaglyError extends Error {
+    readonly statusCode: number;
+    readonly body: string;
+    constructor(statusCode: number, body: string);
+    get isSubscriptionError(): boolean;
+    get isUnauthorized(): boolean;
+}
+export declare class UseFlaglyClient {
     private baseUrl;
     private token?;
     constructor(opts?: SDKOptions);
     private headers;
     private request;
-    validateFlag(slug: string, body: ValidateBody, environment?: string): Promise<any>;
-    getFlagCache(slug: string, identifier?: string): Promise<any>;
-    validateFlow(slug: string, body: ValidateBody, environment?: string): Promise<any>;
-    getFlowCache(slug: string, identifier?: string): Promise<any>;
-    validateFlowPart(slug: string, body: ValidateBody, environment?: string): Promise<any>;
-    getFlowPartCache(slug: string, identifier?: string): Promise<any>;
-    validateScenario(slug: string, body: ValidateBody, environment?: string): Promise<any>;
-    getScenarioCache(slug: string, identifier?: string): Promise<any>;
-    initializeFlags(payload: ReceiveMessage, environment?: string): Promise<any>;
-    getResult(cpf: string): Promise<any>;
+    validateFlag<T = unknown>(slug: string, body: ValidateBody, environment?: string): Promise<T | null>;
+    getFlagCache<T = unknown>(slug: string, identifier?: string): Promise<T | null>;
+    validateFlow<T = unknown>(slug: string, body: ValidateBody, environment?: string): Promise<T | null>;
+    getFlowCache<T = unknown>(slug: string, identifier?: string): Promise<T | null>;
+    validateFlowPart<T = unknown>(slug: string, body: ValidateBody, environment?: string): Promise<T | null>;
+    getFlowPartCache<T = unknown>(slug: string, identifier?: string): Promise<T | null>;
+    validateScenario<T = unknown>(slug: string, body: ValidateBody, environment?: string): Promise<T | null>;
+    getScenarioCache<T = unknown>(slug: string, identifier?: string): Promise<T | null>;
+    initializeFlags<T = unknown>(payload: ReceiveMessage, environment?: string): Promise<T | null>;
+    getResult<T = unknown>(cpf: string): Promise<T | null>;
 }

package/dist/index.js

@@ -3,10 +3,25 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SystemSDK = void 0;
+exports.UseFlaglyClient = exports.FlaglyError = void 0;
 const cross_fetch_1 = __importDefault(require("cross-fetch"));
+class FlaglyError extends Error {
+    constructor(statusCode, body) {
+        super(`UseFlagly error ${statusCode}: ${body}`);
+        this.statusCode = statusCode;
+        this.body = body;
+        this.name = 'FlaglyError';
+    }
+    get isSubscriptionError() {
+        return this.statusCode === 403;
+    }
+    get isUnauthorized() {
+        return this.statusCode === 401;
+    }
+}
+exports.FlaglyError = FlaglyError;
 const DEFAULT_BASE_URL = 'https://api.useflagly.com.br';
-class SystemSDK {
+class UseFlaglyClient {
     constructor(opts = {}) {
         var _a;
         this.baseUrl = ((_a = opts.baseUrl) !== null && _a !== void 0 ? _a : DEFAULT_BASE_URL).replace(/\/+$/, '');
@@ -31,6 +46,9 @@ class SystemSDK {
         if (res.status === 204)
             return null;
         const text = await res.text();
+        if (res.status >= 400) {
+            throw new FlaglyError(res.status, text);
+        }
         try {
             return JSON.parse(text);
         }
@@ -79,4 +97,4 @@ class SystemSDK {
         return this.request(`/validate/result/${encodeURIComponent(cpf)}`, 'GET');
     }
 }
-exports.SystemSDK = SystemSDK;
+exports.UseFlaglyClient = UseFlaglyClient;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@useflagly/sdk-javascript",
-  "version": "0.2.1",
-  "description": "JavaScript SDK para SystemModule (FeatureFlag API)",
+  "version": "0.2.3",
+  "description": "JavaScript SDK para UseFlagly API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [
@@ -23,7 +23,8 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "cross-fetch": "^3.1.8"
+    "cross-fetch": "^3.1.8",
+    "express-basic-auth": "^1.2.1"
   },
   "devDependencies": {
     "typescript": "^5.9.3"