@blindfold/sdk 1.0.1 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -164,6 +164,25 @@ const response = await client.encrypt(
164
164
  );
165
165
  ```
166
166
 
167
+ ## Batch Processing
168
+
169
+ Process multiple texts in a single request (max 100 texts):
170
+
171
+ ```typescript
172
+ const result = await client.tokenizeBatch(
173
+ ["Contact John Doe", "jane@example.com", "No PII here"],
174
+ { policy: "gdpr_eu" }
175
+ );
176
+
177
+ console.log(result.total); // 3
178
+ console.log(result.succeeded); // 3
179
+ console.log(result.failed); // 0
180
+
181
+ result.results.forEach(item => console.log(item.text));
182
+ ```
183
+
184
+ All methods have batch variants: `tokenizeBatch`, `detectBatch`, `redactBatch`, `maskBatch`, `synthesizeBatch`, `hashBatch`, `encryptBatch`.
185
+
167
186
  ## Configuration
168
187
 
169
188
  ### Entity Types
package/dist/index.d.mts CHANGED
@@ -4,10 +4,14 @@
4
4
  interface BlindfoldConfig {
5
5
  /** API key for authentication */
6
6
  apiKey: string;
7
- /** Base URL for the API (default: http://localhost:8000/api/public/v1) */
7
+ /** Base URL for the API (default: https://api.blindfold.dev/api/public/v1) */
8
8
  baseUrl?: string;
9
9
  /** Optional user ID to track who is making the request */
10
10
  userId?: string;
11
+ /** Maximum number of retries on transient errors (default: 2, 0 to disable) */
12
+ maxRetries?: number;
13
+ /** Initial delay in seconds before first retry (default: 0.5) */
14
+ retryDelay?: number;
11
15
  }
12
16
  /**
13
17
  * Configuration options for tokenization
@@ -45,7 +49,7 @@ interface DetectResponse {
45
49
  */
46
50
  interface DetectedEntity {
47
51
  /** Entity type (e.g., "person", "email address", "phone number") */
48
- entity_type: string;
52
+ type: string;
49
53
  /** Original text of the entity */
50
54
  text: string;
51
55
  /** Start index in text */
@@ -205,6 +209,19 @@ interface EncryptResponse {
205
209
  /** Number of entities encrypted */
206
210
  entities_count: number;
207
211
  }
212
+ /**
213
+ * Response wrapper for batch processing
214
+ */
215
+ interface BatchResponse {
216
+ /** Array of individual results (or { error: string } for failed items) */
217
+ results: (Record<string, unknown>)[];
218
+ /** Total number of texts submitted */
219
+ total: number;
220
+ /** Number of texts processed successfully */
221
+ succeeded: number;
222
+ /** Number of texts that failed processing */
223
+ failed: number;
224
+ }
208
225
  /**
209
226
  * Error response from API
210
227
  */
@@ -220,11 +237,14 @@ declare class Blindfold {
220
237
  private apiKey;
221
238
  private baseUrl;
222
239
  private userId?;
240
+ private maxRetries;
241
+ private retryDelay;
223
242
  /**
224
243
  * Create a new Blindfold client
225
244
  * @param config - Configuration options
226
245
  */
227
246
  constructor(config: BlindfoldConfig);
247
+ private retryWait;
228
248
  /**
229
249
  * Make an authenticated request to the API
230
250
  */
@@ -300,6 +320,55 @@ declare class Blindfold {
300
320
  * @returns Promise with encrypted text and detected entities
301
321
  */
302
322
  encrypt(text: string, config?: EncryptConfig): Promise<EncryptResponse>;
323
+ /**
324
+ * Tokenize multiple texts in a single request
325
+ * @param texts - Array of texts to tokenize (max 100)
326
+ * @param config - Optional configuration
327
+ * @returns Promise with batch results
328
+ */
329
+ tokenizeBatch(texts: string[], config?: TokenizeConfig): Promise<BatchResponse>;
330
+ /**
331
+ * Detect PII in multiple texts in a single request
332
+ * @param texts - Array of texts to analyze (max 100)
333
+ * @param config - Optional configuration
334
+ * @returns Promise with batch results
335
+ */
336
+ detectBatch(texts: string[], config?: DetectConfig): Promise<BatchResponse>;
337
+ /**
338
+ * Redact PII from multiple texts in a single request
339
+ * @param texts - Array of texts to redact (max 100)
340
+ * @param config - Optional configuration
341
+ * @returns Promise with batch results
342
+ */
343
+ redactBatch(texts: string[], config?: RedactConfig): Promise<BatchResponse>;
344
+ /**
345
+ * Mask PII in multiple texts in a single request
346
+ * @param texts - Array of texts to mask (max 100)
347
+ * @param config - Optional configuration
348
+ * @returns Promise with batch results
349
+ */
350
+ maskBatch(texts: string[], config?: MaskConfig): Promise<BatchResponse>;
351
+ /**
352
+ * Synthesize multiple texts in a single request
353
+ * @param texts - Array of texts to synthesize (max 100)
354
+ * @param config - Optional configuration
355
+ * @returns Promise with batch results
356
+ */
357
+ synthesizeBatch(texts: string[], config?: SynthesizeConfig): Promise<BatchResponse>;
358
+ /**
359
+ * Hash PII in multiple texts in a single request
360
+ * @param texts - Array of texts to hash (max 100)
361
+ * @param config - Optional configuration
362
+ * @returns Promise with batch results
363
+ */
364
+ hashBatch(texts: string[], config?: HashConfig): Promise<BatchResponse>;
365
+ /**
366
+ * Encrypt PII in multiple texts in a single request
367
+ * @param texts - Array of texts to encrypt (max 100)
368
+ * @param config - Optional configuration
369
+ * @returns Promise with batch results
370
+ */
371
+ encryptBatch(texts: string[], config?: EncryptConfig): Promise<BatchResponse>;
303
372
  }
304
373
 
305
374
  /**
@@ -329,4 +398,4 @@ declare class NetworkError extends BlindfoldError {
329
398
  constructor(message?: string);
330
399
  }
331
400
 
332
- export { APIError, type APIErrorResponse, AuthenticationError, Blindfold, type BlindfoldConfig, BlindfoldError, type DetectConfig, type DetectResponse, type DetectedEntity, type DetokenizeResponse, NetworkError, type TokenizeConfig, type TokenizeResponse };
401
+ export { APIError, type APIErrorResponse, AuthenticationError, type BatchResponse, Blindfold, type BlindfoldConfig, BlindfoldError, type DetectConfig, type DetectResponse, type DetectedEntity, type DetokenizeResponse, NetworkError, type TokenizeConfig, type TokenizeResponse };
package/dist/index.d.ts CHANGED
@@ -4,10 +4,14 @@
4
4
  interface BlindfoldConfig {
5
5
  /** API key for authentication */
6
6
  apiKey: string;
7
- /** Base URL for the API (default: http://localhost:8000/api/public/v1) */
7
+ /** Base URL for the API (default: https://api.blindfold.dev/api/public/v1) */
8
8
  baseUrl?: string;
9
9
  /** Optional user ID to track who is making the request */
10
10
  userId?: string;
11
+ /** Maximum number of retries on transient errors (default: 2, 0 to disable) */
12
+ maxRetries?: number;
13
+ /** Initial delay in seconds before first retry (default: 0.5) */
14
+ retryDelay?: number;
11
15
  }
12
16
  /**
13
17
  * Configuration options for tokenization
@@ -45,7 +49,7 @@ interface DetectResponse {
45
49
  */
46
50
  interface DetectedEntity {
47
51
  /** Entity type (e.g., "person", "email address", "phone number") */
48
- entity_type: string;
52
+ type: string;
49
53
  /** Original text of the entity */
50
54
  text: string;
51
55
  /** Start index in text */
@@ -205,6 +209,19 @@ interface EncryptResponse {
205
209
  /** Number of entities encrypted */
206
210
  entities_count: number;
207
211
  }
212
+ /**
213
+ * Response wrapper for batch processing
214
+ */
215
+ interface BatchResponse {
216
+ /** Array of individual results (or { error: string } for failed items) */
217
+ results: (Record<string, unknown>)[];
218
+ /** Total number of texts submitted */
219
+ total: number;
220
+ /** Number of texts processed successfully */
221
+ succeeded: number;
222
+ /** Number of texts that failed processing */
223
+ failed: number;
224
+ }
208
225
  /**
209
226
  * Error response from API
210
227
  */
@@ -220,11 +237,14 @@ declare class Blindfold {
220
237
  private apiKey;
221
238
  private baseUrl;
222
239
  private userId?;
240
+ private maxRetries;
241
+ private retryDelay;
223
242
  /**
224
243
  * Create a new Blindfold client
225
244
  * @param config - Configuration options
226
245
  */
227
246
  constructor(config: BlindfoldConfig);
247
+ private retryWait;
228
248
  /**
229
249
  * Make an authenticated request to the API
230
250
  */
@@ -300,6 +320,55 @@ declare class Blindfold {
300
320
  * @returns Promise with encrypted text and detected entities
301
321
  */
302
322
  encrypt(text: string, config?: EncryptConfig): Promise<EncryptResponse>;
323
+ /**
324
+ * Tokenize multiple texts in a single request
325
+ * @param texts - Array of texts to tokenize (max 100)
326
+ * @param config - Optional configuration
327
+ * @returns Promise with batch results
328
+ */
329
+ tokenizeBatch(texts: string[], config?: TokenizeConfig): Promise<BatchResponse>;
330
+ /**
331
+ * Detect PII in multiple texts in a single request
332
+ * @param texts - Array of texts to analyze (max 100)
333
+ * @param config - Optional configuration
334
+ * @returns Promise with batch results
335
+ */
336
+ detectBatch(texts: string[], config?: DetectConfig): Promise<BatchResponse>;
337
+ /**
338
+ * Redact PII from multiple texts in a single request
339
+ * @param texts - Array of texts to redact (max 100)
340
+ * @param config - Optional configuration
341
+ * @returns Promise with batch results
342
+ */
343
+ redactBatch(texts: string[], config?: RedactConfig): Promise<BatchResponse>;
344
+ /**
345
+ * Mask PII in multiple texts in a single request
346
+ * @param texts - Array of texts to mask (max 100)
347
+ * @param config - Optional configuration
348
+ * @returns Promise with batch results
349
+ */
350
+ maskBatch(texts: string[], config?: MaskConfig): Promise<BatchResponse>;
351
+ /**
352
+ * Synthesize multiple texts in a single request
353
+ * @param texts - Array of texts to synthesize (max 100)
354
+ * @param config - Optional configuration
355
+ * @returns Promise with batch results
356
+ */
357
+ synthesizeBatch(texts: string[], config?: SynthesizeConfig): Promise<BatchResponse>;
358
+ /**
359
+ * Hash PII in multiple texts in a single request
360
+ * @param texts - Array of texts to hash (max 100)
361
+ * @param config - Optional configuration
362
+ * @returns Promise with batch results
363
+ */
364
+ hashBatch(texts: string[], config?: HashConfig): Promise<BatchResponse>;
365
+ /**
366
+ * Encrypt PII in multiple texts in a single request
367
+ * @param texts - Array of texts to encrypt (max 100)
368
+ * @param config - Optional configuration
369
+ * @returns Promise with batch results
370
+ */
371
+ encryptBatch(texts: string[], config?: EncryptConfig): Promise<BatchResponse>;
303
372
  }
304
373
 
305
374
  /**
@@ -329,4 +398,4 @@ declare class NetworkError extends BlindfoldError {
329
398
  constructor(message?: string);
330
399
  }
331
400
 
332
- export { APIError, type APIErrorResponse, AuthenticationError, Blindfold, type BlindfoldConfig, BlindfoldError, type DetectConfig, type DetectResponse, type DetectedEntity, type DetokenizeResponse, NetworkError, type TokenizeConfig, type TokenizeResponse };
401
+ export { APIError, type APIErrorResponse, AuthenticationError, type BatchResponse, Blindfold, type BlindfoldConfig, BlindfoldError, type DetectConfig, type DetectResponse, type DetectedEntity, type DetokenizeResponse, NetworkError, type TokenizeConfig, type TokenizeResponse };
package/dist/index.js CHANGED
@@ -34,6 +34,10 @@ var NetworkError = class _NetworkError extends BlindfoldError {
34
34
 
35
35
  // src/client.ts
36
36
  var DEFAULT_BASE_URL = "https://api.blindfold.dev/api/public/v1";
37
+ var RETRYABLE_STATUS_CODES = /* @__PURE__ */ new Set([429, 500, 502, 503, 504]);
38
+ function sleep(ms) {
39
+ return new Promise((resolve) => setTimeout(resolve, ms));
40
+ }
37
41
  var Blindfold = class {
38
42
  /**
39
43
  * Create a new Blindfold client
@@ -43,6 +47,19 @@ var Blindfold = class {
43
47
  this.apiKey = config.apiKey;
44
48
  this.baseUrl = config.baseUrl || DEFAULT_BASE_URL;
45
49
  this.userId = config.userId;
50
+ this.maxRetries = config.maxRetries ?? 2;
51
+ this.retryDelay = config.retryDelay ?? 0.5;
52
+ }
53
+ retryWait(attempt, error) {
54
+ if (error && error.statusCode === 429) {
55
+ const body = error.responseBody;
56
+ if (body && typeof body.retry_after === "number") {
57
+ return body.retry_after * 1e3;
58
+ }
59
+ }
60
+ const delay = this.retryDelay * 2 ** attempt * 1e3;
61
+ const jitter = delay * 0.1 * Math.random();
62
+ return delay + jitter;
46
63
  }
47
64
  /**
48
65
  * Make an authenticated request to the API
@@ -56,39 +73,63 @@ var Blindfold = class {
56
73
  if (this.userId) {
57
74
  headers["X-Blindfold-User-Id"] = this.userId;
58
75
  }
59
- try {
60
- const response = await fetch(url, {
61
- method,
62
- headers,
63
- body: body ? JSON.stringify(body) : void 0
64
- });
65
- if (response.status === 401 || response.status === 403) {
66
- throw new AuthenticationError("Authentication failed. Please check your API key.");
67
- }
68
- if (!response.ok) {
69
- let errorMessage = `API request failed with status ${response.status}`;
70
- let responseBody;
71
- try {
72
- responseBody = await response.json();
73
- const errorData = responseBody;
74
- errorMessage = errorData.detail || errorData.message || errorMessage;
75
- } catch {
76
- errorMessage = `${errorMessage}: ${response.statusText}`;
76
+ let lastError = new NetworkError("Request failed");
77
+ for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
78
+ try {
79
+ const response = await fetch(url, {
80
+ method,
81
+ headers,
82
+ body: body ? JSON.stringify(body) : void 0
83
+ });
84
+ if (response.status === 401 || response.status === 403) {
85
+ throw new AuthenticationError("Authentication failed. Please check your API key.");
77
86
  }
78
- throw new APIError(errorMessage, response.status, responseBody);
79
- }
80
- return await response.json();
81
- } catch (error) {
82
- if (error instanceof AuthenticationError || error instanceof APIError) {
83
- throw error;
84
- }
85
- if (error instanceof TypeError && error.message.includes("fetch")) {
86
- throw new NetworkError(
87
- "Network request failed. Please check your connection and the API URL."
88
- );
87
+ if (!response.ok) {
88
+ let errorMessage = `API request failed with status ${response.status}`;
89
+ let responseBody;
90
+ try {
91
+ responseBody = await response.json();
92
+ const errorData = responseBody;
93
+ errorMessage = errorData.detail || errorData.message || errorMessage;
94
+ } catch {
95
+ errorMessage = `${errorMessage}: ${response.statusText}`;
96
+ }
97
+ throw new APIError(errorMessage, response.status, responseBody);
98
+ }
99
+ return await response.json();
100
+ } catch (error) {
101
+ if (error instanceof AuthenticationError) {
102
+ throw error;
103
+ }
104
+ if (error instanceof APIError) {
105
+ if (RETRYABLE_STATUS_CODES.has(error.statusCode) && attempt < this.maxRetries) {
106
+ await sleep(this.retryWait(attempt, error));
107
+ continue;
108
+ }
109
+ throw error;
110
+ }
111
+ if (error instanceof NetworkError) {
112
+ lastError = error;
113
+ if (attempt < this.maxRetries) {
114
+ await sleep(this.retryWait(attempt));
115
+ continue;
116
+ }
117
+ throw error;
118
+ }
119
+ if (error instanceof TypeError && error.message.includes("fetch")) {
120
+ lastError = new NetworkError(
121
+ "Network request failed. Please check your connection and the API URL."
122
+ );
123
+ if (attempt < this.maxRetries) {
124
+ await sleep(this.retryWait(attempt));
125
+ continue;
126
+ }
127
+ throw lastError;
128
+ }
129
+ throw new NetworkError(error instanceof Error ? error.message : "Unknown error occurred");
89
130
  }
90
- throw new NetworkError(error instanceof Error ? error.message : "Unknown error occurred");
91
131
  }
132
+ throw lastError;
92
133
  }
93
134
  /**
94
135
  * Tokenize text by replacing sensitive information with tokens
@@ -213,6 +254,91 @@ var Blindfold = class {
213
254
  ...config
214
255
  });
215
256
  }
257
+ // ===== Batch methods =====
258
+ /**
259
+ * Tokenize multiple texts in a single request
260
+ * @param texts - Array of texts to tokenize (max 100)
261
+ * @param config - Optional configuration
262
+ * @returns Promise with batch results
263
+ */
264
+ async tokenizeBatch(texts, config) {
265
+ return this.request("/tokenize", "POST", {
266
+ texts,
267
+ ...config
268
+ });
269
+ }
270
+ /**
271
+ * Detect PII in multiple texts in a single request
272
+ * @param texts - Array of texts to analyze (max 100)
273
+ * @param config - Optional configuration
274
+ * @returns Promise with batch results
275
+ */
276
+ async detectBatch(texts, config) {
277
+ return this.request("/detect", "POST", {
278
+ texts,
279
+ ...config
280
+ });
281
+ }
282
+ /**
283
+ * Redact PII from multiple texts in a single request
284
+ * @param texts - Array of texts to redact (max 100)
285
+ * @param config - Optional configuration
286
+ * @returns Promise with batch results
287
+ */
288
+ async redactBatch(texts, config) {
289
+ return this.request("/redact", "POST", {
290
+ texts,
291
+ ...config
292
+ });
293
+ }
294
+ /**
295
+ * Mask PII in multiple texts in a single request
296
+ * @param texts - Array of texts to mask (max 100)
297
+ * @param config - Optional configuration
298
+ * @returns Promise with batch results
299
+ */
300
+ async maskBatch(texts, config) {
301
+ return this.request("/mask", "POST", {
302
+ texts,
303
+ ...config
304
+ });
305
+ }
306
+ /**
307
+ * Synthesize multiple texts in a single request
308
+ * @param texts - Array of texts to synthesize (max 100)
309
+ * @param config - Optional configuration
310
+ * @returns Promise with batch results
311
+ */
312
+ async synthesizeBatch(texts, config) {
313
+ return this.request("/synthesize", "POST", {
314
+ texts,
315
+ ...config
316
+ });
317
+ }
318
+ /**
319
+ * Hash PII in multiple texts in a single request
320
+ * @param texts - Array of texts to hash (max 100)
321
+ * @param config - Optional configuration
322
+ * @returns Promise with batch results
323
+ */
324
+ async hashBatch(texts, config) {
325
+ return this.request("/hash", "POST", {
326
+ texts,
327
+ ...config
328
+ });
329
+ }
330
+ /**
331
+ * Encrypt PII in multiple texts in a single request
332
+ * @param texts - Array of texts to encrypt (max 100)
333
+ * @param config - Optional configuration
334
+ * @returns Promise with batch results
335
+ */
336
+ async encryptBatch(texts, config) {
337
+ return this.request("/encrypt", "POST", {
338
+ texts,
339
+ ...config
340
+ });
341
+ }
216
342
  };
217
343
 
218
344
  exports.APIError = APIError;
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/errors.ts","../src/client.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Base error class for Blindfold SDK\n */\nexport class BlindfoldError extends Error {\n constructor(message: string) {\n super(message)\n this.name = 'BlindfoldError'\n Object.setPrototypeOf(this, BlindfoldError.prototype)\n }\n}\n\n/**\n * Error thrown when authentication fails\n */\nexport class AuthenticationError extends BlindfoldError {\n constructor(message: string = 'Authentication failed. Please check your API key.') {\n super(message)\n this.name = 'AuthenticationError'\n Object.setPrototypeOf(this, AuthenticationError.prototype)\n }\n}\n\n/**\n * Error thrown when API request fails\n */\nexport class APIError extends BlindfoldError {\n statusCode: number\n responseBody?: unknown\n\n constructor(message: string, statusCode: number, responseBody?: unknown) {\n super(message)\n this.name = 'APIError'\n this.statusCode = statusCode\n this.responseBody = responseBody\n Object.setPrototypeOf(this, APIError.prototype)\n }\n}\n\n/**\n * Error thrown when network request fails\n */\nexport class NetworkError extends BlindfoldError {\n constructor(message: string = 'Network request failed. Please check your connection.') {\n super(message)\n this.name = 'NetworkError'\n Object.setPrototypeOf(this, NetworkError.prototype)\n }\n}\n","import type {\n BlindfoldConfig,\n DetectConfig,\n DetectResponse,\n TokenizeConfig,\n TokenizeResponse,\n DetokenizeResponse,\n RedactConfig,\n RedactResponse,\n MaskConfig,\n MaskResponse,\n SynthesizeConfig,\n SynthesizeResponse,\n HashConfig,\n HashResponse,\n EncryptConfig,\n EncryptResponse,\n APIErrorResponse,\n} from './types'\nimport { AuthenticationError, APIError, NetworkError } from './errors'\n\nconst DEFAULT_BASE_URL = 'https://api.blindfold.dev/api/public/v1'\n\n/**\n * Blindfold client for tokenization and detokenization\n */\nexport class Blindfold {\n private apiKey: string\n private baseUrl: string\n private userId?: string\n\n /**\n * Create a new Blindfold client\n * @param config - Configuration options\n */\n constructor(config: BlindfoldConfig) {\n this.apiKey = config.apiKey\n this.baseUrl = config.baseUrl || DEFAULT_BASE_URL\n this.userId = config.userId\n }\n\n /**\n * Make an authenticated request to the API\n */\n private async request<T>(\n endpoint: string,\n method: string,\n body?: Record<string, unknown>\n ): Promise<T> {\n const url = `${this.baseUrl}${endpoint}`\n\n const headers: Record<string, string> = {\n 'Content-Type': 'application/json',\n 'X-API-Key': this.apiKey,\n }\n\n if (this.userId) {\n headers['X-Blindfold-User-Id'] = this.userId\n }\n\n try {\n const response = await fetch(url, {\n method,\n headers,\n body: body ? JSON.stringify(body) : undefined,\n })\n\n // Handle authentication errors\n if (response.status === 401 || response.status === 403) {\n throw new AuthenticationError('Authentication failed. Please check your API key.')\n }\n\n // Handle other error responses\n if (!response.ok) {\n let errorMessage = `API request failed with status ${response.status}`\n let responseBody: unknown\n\n try {\n responseBody = await response.json()\n const errorData = responseBody as APIErrorResponse\n errorMessage = errorData.detail || errorData.message || errorMessage\n } catch {\n // If we can't parse the error response, use the status text\n errorMessage = `${errorMessage}: ${response.statusText}`\n }\n\n throw new APIError(errorMessage, response.status, responseBody)\n }\n\n return (await response.json()) as T\n } catch (error) {\n // Re-throw our custom errors\n if (error instanceof AuthenticationError || error instanceof APIError) {\n throw error\n }\n\n // Handle network errors\n if (error instanceof TypeError && error.message.includes('fetch')) {\n throw new NetworkError(\n 'Network request failed. Please check your connection and the API URL.'\n )\n }\n\n // Handle other errors\n throw new NetworkError(error instanceof Error ? error.message : 'Unknown error occurred')\n }\n }\n\n /**\n * Tokenize text by replacing sensitive information with tokens\n * @param text - Text to tokenize\n * @param config - Optional configuration\n * @returns Promise with tokenized text and mapping\n */\n async tokenize(text: string, config?: TokenizeConfig): Promise<TokenizeResponse> {\n return this.request<TokenizeResponse>('/tokenize', 'POST', {\n text,\n ...config,\n })\n }\n\n /**\n * Detect PII in text without modifying it\n *\n * Returns only the detected entities with their types, positions,\n * and confidence scores. The original text is not transformed.\n *\n * @param text - Text to analyze for PII\n * @param config - Optional configuration (entities, score_threshold, policy)\n * @returns Promise with detected entities\n */\n async detect(text: string, config?: DetectConfig): Promise<DetectResponse> {\n return this.request<DetectResponse>('/detect', 'POST', {\n text,\n ...config,\n })\n }\n\n /**\n * Detokenize text by replacing tokens with original values\n *\n * This method performs detokenization CLIENT-SIDE for better performance,\n * security, and to work offline. No API call is made.\n *\n * @param text - Tokenized text\n * @param mapping - Token mapping from tokenize response\n * @returns DetokenizeResponse with original text\n */\n detokenize(text: string, mapping: Record<string, string>): DetokenizeResponse {\n let result = text\n let replacements = 0\n\n // Sort tokens by length (longest first) to avoid partial replacements\n const sortedTokens = Object.keys(mapping).sort((a, b) => b.length - a.length)\n\n for (const token of sortedTokens) {\n const originalValue = mapping[token]\n const regex = new RegExp(token.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&'), 'g')\n const matches = result.match(regex)\n\n if (matches) {\n result = result.replace(regex, originalValue)\n replacements += matches.length\n }\n }\n\n return {\n text: result,\n replacements_made: replacements,\n }\n }\n\n /**\n * Redact (permanently remove) sensitive information from text\n *\n * WARNING: Redaction is irreversible - original data cannot be restored!\n *\n * @param text - Text to redact\n * @param config - Optional configuration (masking_char, entities)\n * @returns Promise with redacted text and detected entities\n */\n async redact(text: string, config?: RedactConfig): Promise<RedactResponse> {\n return this.request<RedactResponse>('/redact', 'POST', {\n text,\n ...config,\n })\n }\n\n /**\n * Mask (partially hide) sensitive information from text\n *\n * @param text - Text to mask\n * @param config - Optional configuration (chars_to_show, from_end, masking_char, entities)\n * @returns Promise with masked text and detected entities\n */\n async mask(text: string, config?: MaskConfig): Promise<MaskResponse> {\n return this.request<MaskResponse>('/mask', 'POST', {\n text,\n ...config,\n })\n }\n\n /**\n * Synthesize (replace real data with synthetic fake data)\n *\n * @param text - Text to synthesize\n * @param config - Optional configuration (language, entities)\n * @returns Promise with synthetic text and detected entities\n */\n async synthesize(text: string, config?: SynthesizeConfig): Promise<SynthesizeResponse> {\n return this.request<SynthesizeResponse>('/synthesize', 'POST', {\n text,\n ...config,\n })\n }\n\n /**\n * Hash (replace with deterministic hash values)\n *\n * @param text - Text to hash\n * @param config - Optional configuration (hash_type, hash_prefix, hash_length, entities)\n * @returns Promise with hashed text and detected entities\n */\n async hash(text: string, config?: HashConfig): Promise<HashResponse> {\n return this.request<HashResponse>('/hash', 'POST', {\n text,\n ...config,\n })\n }\n\n /**\n * Encrypt (reversibly protect) sensitive data in text using AES encryption\n *\n * @param text - Text to encrypt\n * @param config - Optional configuration (encryption_key, entities)\n * @returns Promise with encrypted text and detected entities\n */\n async encrypt(text: string, config?: EncryptConfig): Promise<EncryptResponse> {\n return this.request<EncryptResponse>('/encrypt', 'POST', {\n text,\n ...config,\n })\n }\n}\n"]}
1
+ {"version":3,"sources":["../src/errors.ts","../src/client.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Base error class for Blindfold SDK\n */\nexport class BlindfoldError extends Error {\n constructor(message: string) {\n super(message)\n this.name = 'BlindfoldError'\n Object.setPrototypeOf(this, BlindfoldError.prototype)\n }\n}\n\n/**\n * Error thrown when authentication fails\n */\nexport class AuthenticationError extends BlindfoldError {\n constructor(message: string = 'Authentication failed. Please check your API key.') {\n super(message)\n this.name = 'AuthenticationError'\n Object.setPrototypeOf(this, AuthenticationError.prototype)\n }\n}\n\n/**\n * Error thrown when API request fails\n */\nexport class APIError extends BlindfoldError {\n statusCode: number\n responseBody?: unknown\n\n constructor(message: string, statusCode: number, responseBody?: unknown) {\n super(message)\n this.name = 'APIError'\n this.statusCode = statusCode\n this.responseBody = responseBody\n Object.setPrototypeOf(this, APIError.prototype)\n }\n}\n\n/**\n * Error thrown when network request fails\n */\nexport class NetworkError extends BlindfoldError {\n constructor(message: string = 'Network request failed. Please check your connection.') {\n super(message)\n this.name = 'NetworkError'\n Object.setPrototypeOf(this, NetworkError.prototype)\n }\n}\n","import type {\n BlindfoldConfig,\n DetectConfig,\n DetectResponse,\n TokenizeConfig,\n TokenizeResponse,\n DetokenizeResponse,\n RedactConfig,\n RedactResponse,\n MaskConfig,\n MaskResponse,\n SynthesizeConfig,\n SynthesizeResponse,\n HashConfig,\n HashResponse,\n EncryptConfig,\n EncryptResponse,\n BatchResponse,\n APIErrorResponse,\n} from './types'\nimport { AuthenticationError, APIError, NetworkError } from './errors'\n\nconst DEFAULT_BASE_URL = 'https://api.blindfold.dev/api/public/v1'\nconst RETRYABLE_STATUS_CODES = new Set([429, 500, 502, 503, 504])\n\nfunction sleep(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms))\n}\n\n/**\n * Blindfold client for tokenization and detokenization\n */\nexport class Blindfold {\n private apiKey: string\n private baseUrl: string\n private userId?: string\n private maxRetries: number\n private retryDelay: number\n\n /**\n * Create a new Blindfold client\n * @param config - Configuration options\n */\n constructor(config: BlindfoldConfig) {\n this.apiKey = config.apiKey\n this.baseUrl = config.baseUrl || DEFAULT_BASE_URL\n this.userId = config.userId\n this.maxRetries = config.maxRetries ?? 2\n this.retryDelay = config.retryDelay ?? 0.5\n }\n\n private retryWait(attempt: number, error?: APIError): number {\n if (error && error.statusCode === 429) {\n const body = error.responseBody as Record<string, unknown> | undefined\n if (body && typeof body.retry_after === 'number') {\n return body.retry_after * 1000\n }\n }\n const delay = this.retryDelay * (2 ** attempt) * 1000\n const jitter = delay * 0.1 * Math.random()\n return delay + jitter\n }\n\n /**\n * Make an authenticated request to the API\n */\n private async request<T>(\n endpoint: string,\n method: string,\n body?: Record<string, unknown>\n ): Promise<T> {\n const url = `${this.baseUrl}${endpoint}`\n\n const headers: Record<string, string> = {\n 'Content-Type': 'application/json',\n 'X-API-Key': this.apiKey,\n }\n\n if (this.userId) {\n headers['X-Blindfold-User-Id'] = this.userId\n }\n\n let lastError: Error = new NetworkError('Request failed')\n\n for (let attempt = 0; attempt <= this.maxRetries; attempt++) {\n try {\n const response = await fetch(url, {\n method,\n headers,\n body: body ? JSON.stringify(body) : undefined,\n })\n\n // Handle authentication errors\n if (response.status === 401 || response.status === 403) {\n throw new AuthenticationError('Authentication failed. Please check your API key.')\n }\n\n // Handle other error responses\n if (!response.ok) {\n let errorMessage = `API request failed with status ${response.status}`\n let responseBody: unknown\n\n try {\n responseBody = await response.json()\n const errorData = responseBody as APIErrorResponse\n errorMessage = errorData.detail || errorData.message || errorMessage\n } catch {\n // If we can't parse the error response, use the status text\n errorMessage = `${errorMessage}: ${response.statusText}`\n }\n\n throw new APIError(errorMessage, response.status, responseBody)\n }\n\n return (await response.json()) as T\n } catch (error) {\n // Never retry auth errors\n if (error instanceof AuthenticationError) {\n throw error\n }\n\n // Retry retryable API errors\n if (error instanceof APIError) {\n if (RETRYABLE_STATUS_CODES.has(error.statusCode) && attempt < this.maxRetries) {\n await sleep(this.retryWait(attempt, error))\n continue\n }\n throw error\n }\n\n // Retry network errors\n if (error instanceof NetworkError) {\n lastError = error\n if (attempt < this.maxRetries) {\n await sleep(this.retryWait(attempt))\n continue\n }\n throw error\n }\n\n // Handle raw fetch errors (network failures)\n if (error instanceof TypeError && error.message.includes('fetch')) {\n lastError = new NetworkError(\n 'Network request failed. Please check your connection and the API URL.'\n )\n if (attempt < this.maxRetries) {\n await sleep(this.retryWait(attempt))\n continue\n }\n throw lastError\n }\n\n // Non-retryable unknown errors\n throw new NetworkError(error instanceof Error ? error.message : 'Unknown error occurred')\n }\n }\n\n throw lastError\n }\n\n /**\n * Tokenize text by replacing sensitive information with tokens\n * @param text - Text to tokenize\n * @param config - Optional configuration\n * @returns Promise with tokenized text and mapping\n */\n async tokenize(text: string, config?: TokenizeConfig): Promise<TokenizeResponse> {\n return this.request<TokenizeResponse>('/tokenize', 'POST', {\n text,\n ...config,\n })\n }\n\n /**\n * Detect PII in text without modifying it\n *\n * Returns only the detected entities with their types, positions,\n * and confidence scores. The original text is not transformed.\n *\n * @param text - Text to analyze for PII\n * @param config - Optional configuration (entities, score_threshold, policy)\n * @returns Promise with detected entities\n */\n async detect(text: string, config?: DetectConfig): Promise<DetectResponse> {\n return this.request<DetectResponse>('/detect', 'POST', {\n text,\n ...config,\n })\n }\n\n /**\n * Detokenize text by replacing tokens with original values\n *\n * This method performs detokenization CLIENT-SIDE for better performance,\n * security, and to work offline. No API call is made.\n *\n * @param text - Tokenized text\n * @param mapping - Token mapping from tokenize response\n * @returns DetokenizeResponse with original text\n */\n detokenize(text: string, mapping: Record<string, string>): DetokenizeResponse {\n let result = text\n let replacements = 0\n\n // Sort tokens by length (longest first) to avoid partial replacements\n const sortedTokens = Object.keys(mapping).sort((a, b) => b.length - a.length)\n\n for (const token of sortedTokens) {\n const originalValue = mapping[token]\n const regex = new RegExp(token.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&'), 'g')\n const matches = result.match(regex)\n\n if (matches) {\n result = result.replace(regex, originalValue)\n replacements += matches.length\n }\n }\n\n return {\n text: result,\n replacements_made: replacements,\n }\n }\n\n /**\n * Redact (permanently remove) sensitive information from text\n *\n * WARNING: Redaction is irreversible - original data cannot be restored!\n *\n * @param text - Text to redact\n * @param config - Optional configuration (masking_char, entities)\n * @returns Promise with redacted text and detected entities\n */\n async redact(text: string, config?: RedactConfig): Promise<RedactResponse> {\n return this.request<RedactResponse>('/redact', 'POST', {\n text,\n ...config,\n })\n }\n\n /**\n * Mask (partially hide) sensitive information from text\n *\n * @param text - Text to mask\n * @param config - Optional configuration (chars_to_show, from_end, masking_char, entities)\n * @returns Promise with masked text and detected entities\n */\n async mask(text: string, config?: MaskConfig): Promise<MaskResponse> {\n return this.request<MaskResponse>('/mask', 'POST', {\n text,\n ...config,\n })\n }\n\n /**\n * Synthesize (replace real data with synthetic fake data)\n *\n * @param text - Text to synthesize\n * @param config - Optional configuration (language, entities)\n * @returns Promise with synthetic text and detected entities\n */\n async synthesize(text: string, config?: SynthesizeConfig): Promise<SynthesizeResponse> {\n return this.request<SynthesizeResponse>('/synthesize', 'POST', {\n text,\n ...config,\n })\n }\n\n /**\n * Hash (replace with deterministic hash values)\n *\n * @param text - Text to hash\n * @param config - Optional configuration (hash_type, hash_prefix, hash_length, entities)\n * @returns Promise with hashed text and detected entities\n */\n async hash(text: string, config?: HashConfig): Promise<HashResponse> {\n return this.request<HashResponse>('/hash', 'POST', {\n text,\n ...config,\n })\n }\n\n /**\n * Encrypt (reversibly protect) sensitive data in text using AES encryption\n *\n * @param text - Text to encrypt\n * @param config - Optional configuration (encryption_key, entities)\n * @returns Promise with encrypted text and detected entities\n */\n async encrypt(text: string, config?: EncryptConfig): Promise<EncryptResponse> {\n return this.request<EncryptResponse>('/encrypt', 'POST', {\n text,\n ...config,\n })\n }\n\n // ===== Batch methods =====\n\n /**\n * Tokenize multiple texts in a single request\n * @param texts - Array of texts to tokenize (max 100)\n * @param config - Optional configuration\n * @returns Promise with batch results\n */\n async tokenizeBatch(texts: string[], config?: TokenizeConfig): Promise<BatchResponse> {\n return this.request<BatchResponse>('/tokenize', 'POST', {\n texts,\n ...config,\n })\n }\n\n /**\n * Detect PII in multiple texts in a single request\n * @param texts - Array of texts to analyze (max 100)\n * @param config - Optional configuration\n * @returns Promise with batch results\n */\n async detectBatch(texts: string[], config?: DetectConfig): Promise<BatchResponse> {\n return this.request<BatchResponse>('/detect', 'POST', {\n texts,\n ...config,\n })\n }\n\n /**\n * Redact PII from multiple texts in a single request\n * @param texts - Array of texts to redact (max 100)\n * @param config - Optional configuration\n * @returns Promise with batch results\n */\n async redactBatch(texts: string[], config?: RedactConfig): Promise<BatchResponse> {\n return this.request<BatchResponse>('/redact', 'POST', {\n texts,\n ...config,\n })\n }\n\n /**\n * Mask PII in multiple texts in a single request\n * @param texts - Array of texts to mask (max 100)\n * @param config - Optional configuration\n * @returns Promise with batch results\n */\n async maskBatch(texts: string[], config?: MaskConfig): Promise<BatchResponse> {\n return this.request<BatchResponse>('/mask', 'POST', {\n texts,\n ...config,\n })\n }\n\n /**\n * Synthesize multiple texts in a single request\n * @param texts - Array of texts to synthesize (max 100)\n * @param config - Optional configuration\n * @returns Promise with batch results\n */\n async synthesizeBatch(texts: string[], config?: SynthesizeConfig): Promise<BatchResponse> {\n return this.request<BatchResponse>('/synthesize', 'POST', {\n texts,\n ...config,\n })\n }\n\n /**\n * Hash PII in multiple texts in a single request\n * @param texts - Array of texts to hash (max 100)\n * @param config - Optional configuration\n * @returns Promise with batch results\n */\n async hashBatch(texts: string[], config?: HashConfig): Promise<BatchResponse> {\n return this.request<BatchResponse>('/hash', 'POST', {\n texts,\n ...config,\n })\n }\n\n /**\n * Encrypt PII in multiple texts in a single request\n * @param texts - Array of texts to encrypt (max 100)\n * @param config - Optional configuration\n * @returns Promise with batch results\n */\n async encryptBatch(texts: string[], config?: EncryptConfig): Promise<BatchResponse> {\n return this.request<BatchResponse>('/encrypt', 'POST', {\n texts,\n ...config,\n })\n }\n}\n"]}
package/dist/index.mjs CHANGED
@@ -32,6 +32,10 @@ var NetworkError = class _NetworkError extends BlindfoldError {
32
32
 
33
33
  // src/client.ts
34
34
  var DEFAULT_BASE_URL = "https://api.blindfold.dev/api/public/v1";
35
+ var RETRYABLE_STATUS_CODES = /* @__PURE__ */ new Set([429, 500, 502, 503, 504]);
36
+ function sleep(ms) {
37
+ return new Promise((resolve) => setTimeout(resolve, ms));
38
+ }
35
39
  var Blindfold = class {
36
40
  /**
37
41
  * Create a new Blindfold client
@@ -41,6 +45,19 @@ var Blindfold = class {
41
45
  this.apiKey = config.apiKey;
42
46
  this.baseUrl = config.baseUrl || DEFAULT_BASE_URL;
43
47
  this.userId = config.userId;
48
+ this.maxRetries = config.maxRetries ?? 2;
49
+ this.retryDelay = config.retryDelay ?? 0.5;
50
+ }
51
+ retryWait(attempt, error) {
52
+ if (error && error.statusCode === 429) {
53
+ const body = error.responseBody;
54
+ if (body && typeof body.retry_after === "number") {
55
+ return body.retry_after * 1e3;
56
+ }
57
+ }
58
+ const delay = this.retryDelay * 2 ** attempt * 1e3;
59
+ const jitter = delay * 0.1 * Math.random();
60
+ return delay + jitter;
44
61
  }
45
62
  /**
46
63
  * Make an authenticated request to the API
@@ -54,39 +71,63 @@ var Blindfold = class {
54
71
  if (this.userId) {
55
72
  headers["X-Blindfold-User-Id"] = this.userId;
56
73
  }
57
- try {
58
- const response = await fetch(url, {
59
- method,
60
- headers,
61
- body: body ? JSON.stringify(body) : void 0
62
- });
63
- if (response.status === 401 || response.status === 403) {
64
- throw new AuthenticationError("Authentication failed. Please check your API key.");
65
- }
66
- if (!response.ok) {
67
- let errorMessage = `API request failed with status ${response.status}`;
68
- let responseBody;
69
- try {
70
- responseBody = await response.json();
71
- const errorData = responseBody;
72
- errorMessage = errorData.detail || errorData.message || errorMessage;
73
- } catch {
74
- errorMessage = `${errorMessage}: ${response.statusText}`;
74
+ let lastError = new NetworkError("Request failed");
75
+ for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
76
+ try {
77
+ const response = await fetch(url, {
78
+ method,
79
+ headers,
80
+ body: body ? JSON.stringify(body) : void 0
81
+ });
82
+ if (response.status === 401 || response.status === 403) {
83
+ throw new AuthenticationError("Authentication failed. Please check your API key.");
75
84
  }
76
- throw new APIError(errorMessage, response.status, responseBody);
77
- }
78
- return await response.json();
79
- } catch (error) {
80
- if (error instanceof AuthenticationError || error instanceof APIError) {
81
- throw error;
82
- }
83
- if (error instanceof TypeError && error.message.includes("fetch")) {
84
- throw new NetworkError(
85
- "Network request failed. Please check your connection and the API URL."
86
- );
85
+ if (!response.ok) {
86
+ let errorMessage = `API request failed with status ${response.status}`;
87
+ let responseBody;
88
+ try {
89
+ responseBody = await response.json();
90
+ const errorData = responseBody;
91
+ errorMessage = errorData.detail || errorData.message || errorMessage;
92
+ } catch {
93
+ errorMessage = `${errorMessage}: ${response.statusText}`;
94
+ }
95
+ throw new APIError(errorMessage, response.status, responseBody);
96
+ }
97
+ return await response.json();
98
+ } catch (error) {
99
+ if (error instanceof AuthenticationError) {
100
+ throw error;
101
+ }
102
+ if (error instanceof APIError) {
103
+ if (RETRYABLE_STATUS_CODES.has(error.statusCode) && attempt < this.maxRetries) {
104
+ await sleep(this.retryWait(attempt, error));
105
+ continue;
106
+ }
107
+ throw error;
108
+ }
109
+ if (error instanceof NetworkError) {
110
+ lastError = error;
111
+ if (attempt < this.maxRetries) {
112
+ await sleep(this.retryWait(attempt));
113
+ continue;
114
+ }
115
+ throw error;
116
+ }
117
+ if (error instanceof TypeError && error.message.includes("fetch")) {
118
+ lastError = new NetworkError(
119
+ "Network request failed. Please check your connection and the API URL."
120
+ );
121
+ if (attempt < this.maxRetries) {
122
+ await sleep(this.retryWait(attempt));
123
+ continue;
124
+ }
125
+ throw lastError;
126
+ }
127
+ throw new NetworkError(error instanceof Error ? error.message : "Unknown error occurred");
87
128
  }
88
- throw new NetworkError(error instanceof Error ? error.message : "Unknown error occurred");
89
129
  }
130
+ throw lastError;
90
131
  }
91
132
  /**
92
133
  * Tokenize text by replacing sensitive information with tokens
@@ -211,6 +252,91 @@ var Blindfold = class {
211
252
  ...config
212
253
  });
213
254
  }
255
+ // ===== Batch methods =====
256
+ /**
257
+ * Tokenize multiple texts in a single request
258
+ * @param texts - Array of texts to tokenize (max 100)
259
+ * @param config - Optional configuration
260
+ * @returns Promise with batch results
261
+ */
262
+ async tokenizeBatch(texts, config) {
263
+ return this.request("/tokenize", "POST", {
264
+ texts,
265
+ ...config
266
+ });
267
+ }
268
+ /**
269
+ * Detect PII in multiple texts in a single request
270
+ * @param texts - Array of texts to analyze (max 100)
271
+ * @param config - Optional configuration
272
+ * @returns Promise with batch results
273
+ */
274
+ async detectBatch(texts, config) {
275
+ return this.request("/detect", "POST", {
276
+ texts,
277
+ ...config
278
+ });
279
+ }
280
+ /**
281
+ * Redact PII from multiple texts in a single request
282
+ * @param texts - Array of texts to redact (max 100)
283
+ * @param config - Optional configuration
284
+ * @returns Promise with batch results
285
+ */
286
+ async redactBatch(texts, config) {
287
+ return this.request("/redact", "POST", {
288
+ texts,
289
+ ...config
290
+ });
291
+ }
292
+ /**
293
+ * Mask PII in multiple texts in a single request
294
+ * @param texts - Array of texts to mask (max 100)
295
+ * @param config - Optional configuration
296
+ * @returns Promise with batch results
297
+ */
298
+ async maskBatch(texts, config) {
299
+ return this.request("/mask", "POST", {
300
+ texts,
301
+ ...config
302
+ });
303
+ }
304
+ /**
305
+ * Synthesize multiple texts in a single request
306
+ * @param texts - Array of texts to synthesize (max 100)
307
+ * @param config - Optional configuration
308
+ * @returns Promise with batch results
309
+ */
310
+ async synthesizeBatch(texts, config) {
311
+ return this.request("/synthesize", "POST", {
312
+ texts,
313
+ ...config
314
+ });
315
+ }
316
+ /**
317
+ * Hash PII in multiple texts in a single request
318
+ * @param texts - Array of texts to hash (max 100)
319
+ * @param config - Optional configuration
320
+ * @returns Promise with batch results
321
+ */
322
+ async hashBatch(texts, config) {
323
+ return this.request("/hash", "POST", {
324
+ texts,
325
+ ...config
326
+ });
327
+ }
328
+ /**
329
+ * Encrypt PII in multiple texts in a single request
330
+ * @param texts - Array of texts to encrypt (max 100)
331
+ * @param config - Optional configuration
332
+ * @returns Promise with batch results
333
+ */
334
+ async encryptBatch(texts, config) {
335
+ return this.request("/encrypt", "POST", {
336
+ texts,
337
+ ...config
338
+ });
339
+ }
214
340
  };
215
341
 
216
342
  export { APIError, AuthenticationError, Blindfold, BlindfoldError, NetworkError };
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/errors.ts","../src/client.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * Base error class for Blindfold SDK\n */\nexport class BlindfoldError extends Error {\n constructor(message: string) {\n super(message)\n this.name = 'BlindfoldError'\n Object.setPrototypeOf(this, BlindfoldError.prototype)\n }\n}\n\n/**\n * Error thrown when authentication fails\n */\nexport class AuthenticationError extends BlindfoldError {\n constructor(message: string = 'Authentication failed. Please check your API key.') {\n super(message)\n this.name = 'AuthenticationError'\n Object.setPrototypeOf(this, AuthenticationError.prototype)\n }\n}\n\n/**\n * Error thrown when API request fails\n */\nexport class APIError extends BlindfoldError {\n statusCode: number\n responseBody?: unknown\n\n constructor(message: string, statusCode: number, responseBody?: unknown) {\n super(message)\n this.name = 'APIError'\n this.statusCode = statusCode\n this.responseBody = responseBody\n Object.setPrototypeOf(this, APIError.prototype)\n }\n}\n\n/**\n * Error thrown when network request fails\n */\nexport class NetworkError extends BlindfoldError {\n constructor(message: string = 'Network request failed. Please check your connection.') {\n super(message)\n this.name = 'NetworkError'\n Object.setPrototypeOf(this, NetworkError.prototype)\n }\n}\n","import type {\n BlindfoldConfig,\n DetectConfig,\n DetectResponse,\n TokenizeConfig,\n TokenizeResponse,\n DetokenizeResponse,\n RedactConfig,\n RedactResponse,\n MaskConfig,\n MaskResponse,\n SynthesizeConfig,\n SynthesizeResponse,\n HashConfig,\n HashResponse,\n EncryptConfig,\n EncryptResponse,\n APIErrorResponse,\n} from './types'\nimport { AuthenticationError, APIError, NetworkError } from './errors'\n\nconst DEFAULT_BASE_URL = 'https://api.blindfold.dev/api/public/v1'\n\n/**\n * Blindfold client for tokenization and detokenization\n */\nexport class Blindfold {\n private apiKey: string\n private baseUrl: string\n private userId?: string\n\n /**\n * Create a new Blindfold client\n * @param config - Configuration options\n */\n constructor(config: BlindfoldConfig) {\n this.apiKey = config.apiKey\n this.baseUrl = config.baseUrl || DEFAULT_BASE_URL\n this.userId = config.userId\n }\n\n /**\n * Make an authenticated request to the API\n */\n private async request<T>(\n endpoint: string,\n method: string,\n body?: Record<string, unknown>\n ): Promise<T> {\n const url = `${this.baseUrl}${endpoint}`\n\n const headers: Record<string, string> = {\n 'Content-Type': 'application/json',\n 'X-API-Key': this.apiKey,\n }\n\n if (this.userId) {\n headers['X-Blindfold-User-Id'] = this.userId\n }\n\n try {\n const response = await fetch(url, {\n method,\n headers,\n body: body ? JSON.stringify(body) : undefined,\n })\n\n // Handle authentication errors\n if (response.status === 401 || response.status === 403) {\n throw new AuthenticationError('Authentication failed. Please check your API key.')\n }\n\n // Handle other error responses\n if (!response.ok) {\n let errorMessage = `API request failed with status ${response.status}`\n let responseBody: unknown\n\n try {\n responseBody = await response.json()\n const errorData = responseBody as APIErrorResponse\n errorMessage = errorData.detail || errorData.message || errorMessage\n } catch {\n // If we can't parse the error response, use the status text\n errorMessage = `${errorMessage}: ${response.statusText}`\n }\n\n throw new APIError(errorMessage, response.status, responseBody)\n }\n\n return (await response.json()) as T\n } catch (error) {\n // Re-throw our custom errors\n if (error instanceof AuthenticationError || error instanceof APIError) {\n throw error\n }\n\n // Handle network errors\n if (error instanceof TypeError && error.message.includes('fetch')) {\n throw new NetworkError(\n 'Network request failed. Please check your connection and the API URL.'\n )\n }\n\n // Handle other errors\n throw new NetworkError(error instanceof Error ? error.message : 'Unknown error occurred')\n }\n }\n\n /**\n * Tokenize text by replacing sensitive information with tokens\n * @param text - Text to tokenize\n * @param config - Optional configuration\n * @returns Promise with tokenized text and mapping\n */\n async tokenize(text: string, config?: TokenizeConfig): Promise<TokenizeResponse> {\n return this.request<TokenizeResponse>('/tokenize', 'POST', {\n text,\n ...config,\n })\n }\n\n /**\n * Detect PII in text without modifying it\n *\n * Returns only the detected entities with their types, positions,\n * and confidence scores. The original text is not transformed.\n *\n * @param text - Text to analyze for PII\n * @param config - Optional configuration (entities, score_threshold, policy)\n * @returns Promise with detected entities\n */\n async detect(text: string, config?: DetectConfig): Promise<DetectResponse> {\n return this.request<DetectResponse>('/detect', 'POST', {\n text,\n ...config,\n })\n }\n\n /**\n * Detokenize text by replacing tokens with original values\n *\n * This method performs detokenization CLIENT-SIDE for better performance,\n * security, and to work offline. No API call is made.\n *\n * @param text - Tokenized text\n * @param mapping - Token mapping from tokenize response\n * @returns DetokenizeResponse with original text\n */\n detokenize(text: string, mapping: Record<string, string>): DetokenizeResponse {\n let result = text\n let replacements = 0\n\n // Sort tokens by length (longest first) to avoid partial replacements\n const sortedTokens = Object.keys(mapping).sort((a, b) => b.length - a.length)\n\n for (const token of sortedTokens) {\n const originalValue = mapping[token]\n const regex = new RegExp(token.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&'), 'g')\n const matches = result.match(regex)\n\n if (matches) {\n result = result.replace(regex, originalValue)\n replacements += matches.length\n }\n }\n\n return {\n text: result,\n replacements_made: replacements,\n }\n }\n\n /**\n * Redact (permanently remove) sensitive information from text\n *\n * WARNING: Redaction is irreversible - original data cannot be restored!\n *\n * @param text - Text to redact\n * @param config - Optional configuration (masking_char, entities)\n * @returns Promise with redacted text and detected entities\n */\n async redact(text: string, config?: RedactConfig): Promise<RedactResponse> {\n return this.request<RedactResponse>('/redact', 'POST', {\n text,\n ...config,\n })\n }\n\n /**\n * Mask (partially hide) sensitive information from text\n *\n * @param text - Text to mask\n * @param config - Optional configuration (chars_to_show, from_end, masking_char, entities)\n * @returns Promise with masked text and detected entities\n */\n async mask(text: string, config?: MaskConfig): Promise<MaskResponse> {\n return this.request<MaskResponse>('/mask', 'POST', {\n text,\n ...config,\n })\n }\n\n /**\n * Synthesize (replace real data with synthetic fake data)\n *\n * @param text - Text to synthesize\n * @param config - Optional configuration (language, entities)\n * @returns Promise with synthetic text and detected entities\n */\n async synthesize(text: string, config?: SynthesizeConfig): Promise<SynthesizeResponse> {\n return this.request<SynthesizeResponse>('/synthesize', 'POST', {\n text,\n ...config,\n })\n }\n\n /**\n * Hash (replace with deterministic hash values)\n *\n * @param text - Text to hash\n * @param config - Optional configuration (hash_type, hash_prefix, hash_length, entities)\n * @returns Promise with hashed text and detected entities\n */\n async hash(text: string, config?: HashConfig): Promise<HashResponse> {\n return this.request<HashResponse>('/hash', 'POST', {\n text,\n ...config,\n })\n }\n\n /**\n * Encrypt (reversibly protect) sensitive data in text using AES encryption\n *\n * @param text - Text to encrypt\n * @param config - Optional configuration (encryption_key, entities)\n * @returns Promise with encrypted text and detected entities\n */\n async encrypt(text: string, config?: EncryptConfig): Promise<EncryptResponse> {\n return this.request<EncryptResponse>('/encrypt', 'POST', {\n text,\n ...config,\n })\n }\n}\n"]}
1
+ {"version":3,"sources":["../src/errors.ts","../src/client.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * Base error class for Blindfold SDK\n */\nexport class BlindfoldError extends Error {\n constructor(message: string) {\n super(message)\n this.name = 'BlindfoldError'\n Object.setPrototypeOf(this, BlindfoldError.prototype)\n }\n}\n\n/**\n * Error thrown when authentication fails\n */\nexport class AuthenticationError extends BlindfoldError {\n constructor(message: string = 'Authentication failed. Please check your API key.') {\n super(message)\n this.name = 'AuthenticationError'\n Object.setPrototypeOf(this, AuthenticationError.prototype)\n }\n}\n\n/**\n * Error thrown when API request fails\n */\nexport class APIError extends BlindfoldError {\n statusCode: number\n responseBody?: unknown\n\n constructor(message: string, statusCode: number, responseBody?: unknown) {\n super(message)\n this.name = 'APIError'\n this.statusCode = statusCode\n this.responseBody = responseBody\n Object.setPrototypeOf(this, APIError.prototype)\n }\n}\n\n/**\n * Error thrown when network request fails\n */\nexport class NetworkError extends BlindfoldError {\n constructor(message: string = 'Network request failed. Please check your connection.') {\n super(message)\n this.name = 'NetworkError'\n Object.setPrototypeOf(this, NetworkError.prototype)\n }\n}\n","import type {\n BlindfoldConfig,\n DetectConfig,\n DetectResponse,\n TokenizeConfig,\n TokenizeResponse,\n DetokenizeResponse,\n RedactConfig,\n RedactResponse,\n MaskConfig,\n MaskResponse,\n SynthesizeConfig,\n SynthesizeResponse,\n HashConfig,\n HashResponse,\n EncryptConfig,\n EncryptResponse,\n BatchResponse,\n APIErrorResponse,\n} from './types'\nimport { AuthenticationError, APIError, NetworkError } from './errors'\n\nconst DEFAULT_BASE_URL = 'https://api.blindfold.dev/api/public/v1'\nconst RETRYABLE_STATUS_CODES = new Set([429, 500, 502, 503, 504])\n\nfunction sleep(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms))\n}\n\n/**\n * Blindfold client for tokenization and detokenization\n */\nexport class Blindfold {\n private apiKey: string\n private baseUrl: string\n private userId?: string\n private maxRetries: number\n private retryDelay: number\n\n /**\n * Create a new Blindfold client\n * @param config - Configuration options\n */\n constructor(config: BlindfoldConfig) {\n this.apiKey = config.apiKey\n this.baseUrl = config.baseUrl || DEFAULT_BASE_URL\n this.userId = config.userId\n this.maxRetries = config.maxRetries ?? 2\n this.retryDelay = config.retryDelay ?? 0.5\n }\n\n private retryWait(attempt: number, error?: APIError): number {\n if (error && error.statusCode === 429) {\n const body = error.responseBody as Record<string, unknown> | undefined\n if (body && typeof body.retry_after === 'number') {\n return body.retry_after * 1000\n }\n }\n const delay = this.retryDelay * (2 ** attempt) * 1000\n const jitter = delay * 0.1 * Math.random()\n return delay + jitter\n }\n\n /**\n * Make an authenticated request to the API\n */\n private async request<T>(\n endpoint: string,\n method: string,\n body?: Record<string, unknown>\n ): Promise<T> {\n const url = `${this.baseUrl}${endpoint}`\n\n const headers: Record<string, string> = {\n 'Content-Type': 'application/json',\n 'X-API-Key': this.apiKey,\n }\n\n if (this.userId) {\n headers['X-Blindfold-User-Id'] = this.userId\n }\n\n let lastError: Error = new NetworkError('Request failed')\n\n for (let attempt = 0; attempt <= this.maxRetries; attempt++) {\n try {\n const response = await fetch(url, {\n method,\n headers,\n body: body ? JSON.stringify(body) : undefined,\n })\n\n // Handle authentication errors\n if (response.status === 401 || response.status === 403) {\n throw new AuthenticationError('Authentication failed. Please check your API key.')\n }\n\n // Handle other error responses\n if (!response.ok) {\n let errorMessage = `API request failed with status ${response.status}`\n let responseBody: unknown\n\n try {\n responseBody = await response.json()\n const errorData = responseBody as APIErrorResponse\n errorMessage = errorData.detail || errorData.message || errorMessage\n } catch {\n // If we can't parse the error response, use the status text\n errorMessage = `${errorMessage}: ${response.statusText}`\n }\n\n throw new APIError(errorMessage, response.status, responseBody)\n }\n\n return (await response.json()) as T\n } catch (error) {\n // Never retry auth errors\n if (error instanceof AuthenticationError) {\n throw error\n }\n\n // Retry retryable API errors\n if (error instanceof APIError) {\n if (RETRYABLE_STATUS_CODES.has(error.statusCode) && attempt < this.maxRetries) {\n await sleep(this.retryWait(attempt, error))\n continue\n }\n throw error\n }\n\n // Retry network errors\n if (error instanceof NetworkError) {\n lastError = error\n if (attempt < this.maxRetries) {\n await sleep(this.retryWait(attempt))\n continue\n }\n throw error\n }\n\n // Handle raw fetch errors (network failures)\n if (error instanceof TypeError && error.message.includes('fetch')) {\n lastError = new NetworkError(\n 'Network request failed. Please check your connection and the API URL.'\n )\n if (attempt < this.maxRetries) {\n await sleep(this.retryWait(attempt))\n continue\n }\n throw lastError\n }\n\n // Non-retryable unknown errors\n throw new NetworkError(error instanceof Error ? error.message : 'Unknown error occurred')\n }\n }\n\n throw lastError\n }\n\n /**\n * Tokenize text by replacing sensitive information with tokens\n * @param text - Text to tokenize\n * @param config - Optional configuration\n * @returns Promise with tokenized text and mapping\n */\n async tokenize(text: string, config?: TokenizeConfig): Promise<TokenizeResponse> {\n return this.request<TokenizeResponse>('/tokenize', 'POST', {\n text,\n ...config,\n })\n }\n\n /**\n * Detect PII in text without modifying it\n *\n * Returns only the detected entities with their types, positions,\n * and confidence scores. The original text is not transformed.\n *\n * @param text - Text to analyze for PII\n * @param config - Optional configuration (entities, score_threshold, policy)\n * @returns Promise with detected entities\n */\n async detect(text: string, config?: DetectConfig): Promise<DetectResponse> {\n return this.request<DetectResponse>('/detect', 'POST', {\n text,\n ...config,\n })\n }\n\n /**\n * Detokenize text by replacing tokens with original values\n *\n * This method performs detokenization CLIENT-SIDE for better performance,\n * security, and to work offline. No API call is made.\n *\n * @param text - Tokenized text\n * @param mapping - Token mapping from tokenize response\n * @returns DetokenizeResponse with original text\n */\n detokenize(text: string, mapping: Record<string, string>): DetokenizeResponse {\n let result = text\n let replacements = 0\n\n // Sort tokens by length (longest first) to avoid partial replacements\n const sortedTokens = Object.keys(mapping).sort((a, b) => b.length - a.length)\n\n for (const token of sortedTokens) {\n const originalValue = mapping[token]\n const regex = new RegExp(token.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&'), 'g')\n const matches = result.match(regex)\n\n if (matches) {\n result = result.replace(regex, originalValue)\n replacements += matches.length\n }\n }\n\n return {\n text: result,\n replacements_made: replacements,\n }\n }\n\n /**\n * Redact (permanently remove) sensitive information from text\n *\n * WARNING: Redaction is irreversible - original data cannot be restored!\n *\n * @param text - Text to redact\n * @param config - Optional configuration (masking_char, entities)\n * @returns Promise with redacted text and detected entities\n */\n async redact(text: string, config?: RedactConfig): Promise<RedactResponse> {\n return this.request<RedactResponse>('/redact', 'POST', {\n text,\n ...config,\n })\n }\n\n /**\n * Mask (partially hide) sensitive information from text\n *\n * @param text - Text to mask\n * @param config - Optional configuration (chars_to_show, from_end, masking_char, entities)\n * @returns Promise with masked text and detected entities\n */\n async mask(text: string, config?: MaskConfig): Promise<MaskResponse> {\n return this.request<MaskResponse>('/mask', 'POST', {\n text,\n ...config,\n })\n }\n\n /**\n * Synthesize (replace real data with synthetic fake data)\n *\n * @param text - Text to synthesize\n * @param config - Optional configuration (language, entities)\n * @returns Promise with synthetic text and detected entities\n */\n async synthesize(text: string, config?: SynthesizeConfig): Promise<SynthesizeResponse> {\n return this.request<SynthesizeResponse>('/synthesize', 'POST', {\n text,\n ...config,\n })\n }\n\n /**\n * Hash (replace with deterministic hash values)\n *\n * @param text - Text to hash\n * @param config - Optional configuration (hash_type, hash_prefix, hash_length, entities)\n * @returns Promise with hashed text and detected entities\n */\n async hash(text: string, config?: HashConfig): Promise<HashResponse> {\n return this.request<HashResponse>('/hash', 'POST', {\n text,\n ...config,\n })\n }\n\n /**\n * Encrypt (reversibly protect) sensitive data in text using AES encryption\n *\n * @param text - Text to encrypt\n * @param config - Optional configuration (encryption_key, entities)\n * @returns Promise with encrypted text and detected entities\n */\n async encrypt(text: string, config?: EncryptConfig): Promise<EncryptResponse> {\n return this.request<EncryptResponse>('/encrypt', 'POST', {\n text,\n ...config,\n })\n }\n\n // ===== Batch methods =====\n\n /**\n * Tokenize multiple texts in a single request\n * @param texts - Array of texts to tokenize (max 100)\n * @param config - Optional configuration\n * @returns Promise with batch results\n */\n async tokenizeBatch(texts: string[], config?: TokenizeConfig): Promise<BatchResponse> {\n return this.request<BatchResponse>('/tokenize', 'POST', {\n texts,\n ...config,\n })\n }\n\n /**\n * Detect PII in multiple texts in a single request\n * @param texts - Array of texts to analyze (max 100)\n * @param config - Optional configuration\n * @returns Promise with batch results\n */\n async detectBatch(texts: string[], config?: DetectConfig): Promise<BatchResponse> {\n return this.request<BatchResponse>('/detect', 'POST', {\n texts,\n ...config,\n })\n }\n\n /**\n * Redact PII from multiple texts in a single request\n * @param texts - Array of texts to redact (max 100)\n * @param config - Optional configuration\n * @returns Promise with batch results\n */\n async redactBatch(texts: string[], config?: RedactConfig): Promise<BatchResponse> {\n return this.request<BatchResponse>('/redact', 'POST', {\n texts,\n ...config,\n })\n }\n\n /**\n * Mask PII in multiple texts in a single request\n * @param texts - Array of texts to mask (max 100)\n * @param config - Optional configuration\n * @returns Promise with batch results\n */\n async maskBatch(texts: string[], config?: MaskConfig): Promise<BatchResponse> {\n return this.request<BatchResponse>('/mask', 'POST', {\n texts,\n ...config,\n })\n }\n\n /**\n * Synthesize multiple texts in a single request\n * @param texts - Array of texts to synthesize (max 100)\n * @param config - Optional configuration\n * @returns Promise with batch results\n */\n async synthesizeBatch(texts: string[], config?: SynthesizeConfig): Promise<BatchResponse> {\n return this.request<BatchResponse>('/synthesize', 'POST', {\n texts,\n ...config,\n })\n }\n\n /**\n * Hash PII in multiple texts in a single request\n * @param texts - Array of texts to hash (max 100)\n * @param config - Optional configuration\n * @returns Promise with batch results\n */\n async hashBatch(texts: string[], config?: HashConfig): Promise<BatchResponse> {\n return this.request<BatchResponse>('/hash', 'POST', {\n texts,\n ...config,\n })\n }\n\n /**\n * Encrypt PII in multiple texts in a single request\n * @param texts - Array of texts to encrypt (max 100)\n * @param config - Optional configuration\n * @returns Promise with batch results\n */\n async encryptBatch(texts: string[], config?: EncryptConfig): Promise<BatchResponse> {\n return this.request<BatchResponse>('/encrypt', 'POST', {\n texts,\n ...config,\n })\n }\n}\n"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@blindfold/sdk",
3
- "version": "1.0.1",
3
+ "version": "1.2.0",
4
4
  "description": "JavaScript/TypeScript SDK for Blindfold Gateway",
5
5
  "main": "./dist/index.js",
6
6
  "module": "./dist/index.mjs",