anonyma 1.1.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.
Files changed (171) hide show
  1. package/CHANGELOG.md +109 -1
  2. package/README.md +125 -7
  3. package/dist/ai/index.cjs +31 -20
  4. package/dist/ai/index.cjs.map +1 -1
  5. package/dist/ai/index.d.cts +5 -5
  6. package/dist/ai/index.d.ts +5 -5
  7. package/dist/ai/index.js +24 -13
  8. package/dist/ai/index.js.map +1 -1
  9. package/dist/audit/index.cjs +14 -14
  10. package/dist/audit/index.d.cts +2 -2
  11. package/dist/audit/index.d.ts +2 -2
  12. package/dist/audit/index.js +9 -9
  13. package/dist/{chunk-YMLR375Z.js → chunk-264R3VFP.js} +4 -3
  14. package/dist/chunk-264R3VFP.js.map +1 -0
  15. package/dist/{chunk-ISL5B4LU.cjs → chunk-32U3DM7M.cjs} +11 -11
  16. package/dist/{chunk-ISL5B4LU.cjs.map → chunk-32U3DM7M.cjs.map} +1 -1
  17. package/dist/{chunk-ZXPZ7W37.cjs → chunk-42ZZZUMO.cjs} +231 -60
  18. package/dist/chunk-42ZZZUMO.cjs.map +1 -0
  19. package/dist/chunk-4BYN6GVK.js +213 -0
  20. package/dist/chunk-4BYN6GVK.js.map +1 -0
  21. package/dist/{chunk-JKW36IPT.js → chunk-A2OMTO3L.js} +4 -4
  22. package/dist/{chunk-JKW36IPT.js.map → chunk-A2OMTO3L.js.map} +1 -1
  23. package/dist/{chunk-TW7PM3UJ.cjs → chunk-AITKBKQX.cjs} +2 -2
  24. package/dist/{chunk-TW7PM3UJ.cjs.map → chunk-AITKBKQX.cjs.map} +1 -1
  25. package/dist/{chunk-G4AN7FND.js → chunk-BWE4O2ES.js} +23 -9
  26. package/dist/chunk-BWE4O2ES.js.map +1 -0
  27. package/dist/{chunk-GS3FRH4K.js → chunk-CMJXIEBA.js} +2 -2
  28. package/dist/chunk-CMJXIEBA.js.map +1 -0
  29. package/dist/{chunk-GYMG5OI3.cjs → chunk-ESVFPMG4.cjs} +2 -2
  30. package/dist/{chunk-GYMG5OI3.cjs.map → chunk-ESVFPMG4.cjs.map} +1 -1
  31. package/dist/{chunk-2YG7R4KJ.cjs → chunk-EUNLKSYP.cjs} +5 -5
  32. package/dist/{chunk-2YG7R4KJ.cjs.map → chunk-EUNLKSYP.cjs.map} +1 -1
  33. package/dist/{chunk-S7NH6CHY.cjs → chunk-F3BYJFUM.cjs} +5 -3
  34. package/dist/chunk-F3BYJFUM.cjs.map +1 -0
  35. package/dist/{chunk-IJAMLYOT.cjs → chunk-HDHQXVUM.cjs} +50 -36
  36. package/dist/chunk-HDHQXVUM.cjs.map +1 -0
  37. package/dist/{chunk-OGNLB2KA.js → chunk-HFAIBE3T.js} +3 -3
  38. package/dist/{chunk-OGNLB2KA.js.map → chunk-HFAIBE3T.js.map} +1 -1
  39. package/dist/{chunk-PKHZ7CVI.js → chunk-IBDFBUFZ.js} +2 -2
  40. package/dist/chunk-IBDFBUFZ.js.map +1 -0
  41. package/dist/{chunk-3CY6ATKS.cjs → chunk-JBH2EFFF.cjs} +36 -36
  42. package/dist/{chunk-3CY6ATKS.cjs.map → chunk-JBH2EFFF.cjs.map} +1 -1
  43. package/dist/chunk-JPU7KQZX.cjs +82 -0
  44. package/dist/{chunk-CRXRJZEV.cjs.map → chunk-JPU7KQZX.cjs.map} +1 -1
  45. package/dist/{chunk-E3PICZYI.js → chunk-KHT23UVV.js} +3 -3
  46. package/dist/{chunk-E3PICZYI.js.map → chunk-KHT23UVV.js.map} +1 -1
  47. package/dist/{chunk-2ZZHLCEJ.js → chunk-LAZIR73I.js} +18 -87
  48. package/dist/chunk-LAZIR73I.js.map +1 -0
  49. package/dist/{chunk-FB56NAAH.cjs → chunk-NO4ZCIM6.cjs} +19 -92
  50. package/dist/chunk-NO4ZCIM6.cjs.map +1 -0
  51. package/dist/{chunk-S4BJ2ADB.cjs → chunk-PCU6AG7H.cjs} +4 -4
  52. package/dist/{chunk-S4BJ2ADB.cjs.map → chunk-PCU6AG7H.cjs.map} +1 -1
  53. package/dist/{chunk-GBYHQQUY.js → chunk-PSZHBY5V.js} +221 -50
  54. package/dist/chunk-PSZHBY5V.js.map +1 -0
  55. package/dist/{chunk-6LDAIJBL.js → chunk-QBBJR7DZ.js} +2 -2
  56. package/dist/{chunk-6LDAIJBL.js.map → chunk-QBBJR7DZ.js.map} +1 -1
  57. package/dist/{chunk-3D5ZCJ7R.js → chunk-QHQ2AU45.js} +3 -3
  58. package/dist/{chunk-3D5ZCJ7R.js.map → chunk-QHQ2AU45.js.map} +1 -1
  59. package/dist/{chunk-IHEIYZPL.cjs → chunk-RJX27YEX.cjs} +2 -2
  60. package/dist/chunk-RJX27YEX.cjs.map +1 -0
  61. package/dist/{chunk-QYD4F6T7.cjs → chunk-ROXNQKOA.cjs} +2 -2
  62. package/dist/{chunk-QYD4F6T7.cjs.map → chunk-ROXNQKOA.cjs.map} +1 -1
  63. package/dist/chunk-SHEXFU6T.js +107 -0
  64. package/dist/chunk-SHEXFU6T.js.map +1 -0
  65. package/dist/chunk-T2KIN6VL.cjs +218 -0
  66. package/dist/chunk-T2KIN6VL.cjs.map +1 -0
  67. package/dist/{chunk-RCW5IPPR.js → chunk-UCT6HDUD.js} +3 -3
  68. package/dist/{chunk-RCW5IPPR.js.map → chunk-UCT6HDUD.js.map} +1 -1
  69. package/dist/chunk-UN74SYHV.cjs +115 -0
  70. package/dist/chunk-UN74SYHV.cjs.map +1 -0
  71. package/dist/{chunk-F7O2FA3F.cjs → chunk-VAO3Y3HZ.cjs} +7 -6
  72. package/dist/chunk-VAO3Y3HZ.cjs.map +1 -0
  73. package/dist/{chunk-BBJPQPGP.js → chunk-VE3OSDM7.js} +5 -3
  74. package/dist/chunk-VE3OSDM7.js.map +1 -0
  75. package/dist/{chunk-7HK2V5Q4.js → chunk-X7IVXKDE.js} +3 -3
  76. package/dist/{chunk-7HK2V5Q4.js.map → chunk-X7IVXKDE.js.map} +1 -1
  77. package/dist/{chunk-UA3EOFBS.cjs → chunk-XVCVIUZS.cjs} +8 -8
  78. package/dist/{chunk-UA3EOFBS.cjs.map → chunk-XVCVIUZS.cjs.map} +1 -1
  79. package/dist/{chunk-SIHPDZXA.js → chunk-YSTC7WRF.js} +2 -2
  80. package/dist/{chunk-SIHPDZXA.js.map → chunk-YSTC7WRF.js.map} +1 -1
  81. package/dist/compliance/index.cjs +15 -15
  82. package/dist/compliance/index.d.cts +4 -4
  83. package/dist/compliance/index.d.ts +4 -4
  84. package/dist/compliance/index.js +5 -5
  85. package/dist/crypto.cjs +4 -4
  86. package/dist/crypto.d.cts +1 -1
  87. package/dist/crypto.d.ts +1 -1
  88. package/dist/crypto.js +2 -2
  89. package/dist/detectors/index.cjs +38 -38
  90. package/dist/detectors/index.d.cts +1 -1
  91. package/dist/detectors/index.d.ts +1 -1
  92. package/dist/detectors/index.js +3 -3
  93. package/dist/engine/index.cjs +70 -70
  94. package/dist/engine/index.d.cts +3 -3
  95. package/dist/engine/index.d.ts +3 -3
  96. package/dist/engine/index.js +8 -8
  97. package/dist/hash-P2VGKVFP.cjs +14 -0
  98. package/dist/{hash-2PSYNDMM.cjs.map → hash-P2VGKVFP.cjs.map} +1 -1
  99. package/dist/hash-T6YJG3DU.js +5 -0
  100. package/dist/{hash-CELLDNKN.js.map → hash-T6YJG3DU.js.map} +1 -1
  101. package/dist/index.cjs +44 -34
  102. package/dist/index.cjs.map +1 -1
  103. package/dist/index.d.cts +23 -5
  104. package/dist/index.d.ts +23 -5
  105. package/dist/index.js +11 -9
  106. package/dist/index.js.map +1 -1
  107. package/dist/{json-CvKtPL8l.d.cts → json-BXN577tt.d.cts} +3 -2
  108. package/dist/{json-BruY_-tV.d.ts → json-BudrzkOQ.d.ts} +3 -2
  109. package/dist/mcp/index.cjs +29 -28
  110. package/dist/mcp/index.cjs.map +1 -1
  111. package/dist/mcp/index.js +14 -13
  112. package/dist/mcp/index.js.map +1 -1
  113. package/dist/middleware/express.cjs +11 -11
  114. package/dist/middleware/express.d.cts +3 -3
  115. package/dist/middleware/express.d.ts +3 -3
  116. package/dist/middleware/express.js +10 -10
  117. package/dist/middleware/hono.cjs +11 -11
  118. package/dist/middleware/hono.d.cts +3 -3
  119. package/dist/middleware/hono.d.ts +3 -3
  120. package/dist/middleware/hono.js +10 -10
  121. package/dist/middleware/index.cjs +11 -11
  122. package/dist/middleware/index.d.cts +3 -3
  123. package/dist/middleware/index.d.ts +3 -3
  124. package/dist/middleware/index.js +10 -10
  125. package/dist/schemas.cjs +47 -47
  126. package/dist/schemas.cjs.map +1 -1
  127. package/dist/schemas.d.cts +2 -2
  128. package/dist/schemas.d.ts +2 -2
  129. package/dist/schemas.js +2 -2
  130. package/dist/schemas.js.map +1 -1
  131. package/dist/{session-CEFGgjFV.d.ts → session-CPXEQ2uC.d.cts} +18 -5
  132. package/dist/{session-DEQrPea7.d.cts → session-D3WMN6fE.d.ts} +18 -5
  133. package/dist/stream.cjs +10 -8
  134. package/dist/stream.cjs.map +1 -1
  135. package/dist/stream.d.cts +1 -1
  136. package/dist/stream.d.ts +1 -1
  137. package/dist/stream.js +7 -5
  138. package/dist/stream.js.map +1 -1
  139. package/dist/{types-oxllMFYF.d.ts → types-B3VjDuP8.d.cts} +2 -282
  140. package/dist/{types-D5BeXwnX.d.ts → types-DHAVKfzT.d.ts} +2 -2
  141. package/dist/types-LZHFEgx5.d.cts +1083 -0
  142. package/dist/types-LZHFEgx5.d.ts +1083 -0
  143. package/dist/{types-BtvX8QTd.d.cts → types-vmONSbz4.d.cts} +2 -2
  144. package/dist/{types-BL5UWH0y.d.cts → types-yZHnS7yv.d.ts} +2 -282
  145. package/dist/validators.cjs +10 -10
  146. package/dist/validators.js +1 -1
  147. package/dist/vault/index.cjs +65 -46
  148. package/dist/vault/index.cjs.map +1 -1
  149. package/dist/vault/index.d.cts +98 -5
  150. package/dist/vault/index.d.ts +98 -5
  151. package/dist/vault/index.js +11 -5
  152. package/dist/vault/index.js.map +1 -1
  153. package/package.json +16 -7
  154. package/dist/chunk-2ZZHLCEJ.js.map +0 -1
  155. package/dist/chunk-BBJPQPGP.js.map +0 -1
  156. package/dist/chunk-CRXRJZEV.cjs +0 -82
  157. package/dist/chunk-F7O2FA3F.cjs.map +0 -1
  158. package/dist/chunk-FB56NAAH.cjs.map +0 -1
  159. package/dist/chunk-G4AN7FND.js.map +0 -1
  160. package/dist/chunk-GBYHQQUY.js.map +0 -1
  161. package/dist/chunk-GS3FRH4K.js.map +0 -1
  162. package/dist/chunk-IHEIYZPL.cjs.map +0 -1
  163. package/dist/chunk-IJAMLYOT.cjs.map +0 -1
  164. package/dist/chunk-PKHZ7CVI.js.map +0 -1
  165. package/dist/chunk-S7NH6CHY.cjs.map +0 -1
  166. package/dist/chunk-YMLR375Z.js.map +0 -1
  167. package/dist/chunk-ZXPZ7W37.cjs.map +0 -1
  168. package/dist/hash-2PSYNDMM.cjs +0 -14
  169. package/dist/hash-CELLDNKN.js +0 -5
  170. package/dist/types-cbGVW8cD.d.cts +0 -592
  171. package/dist/types-cbGVW8cD.d.ts +0 -592
package/dist/schemas.cjs CHANGED
@@ -1,9 +1,9 @@
1
1
  'use strict';
2
2
 
3
- var zod = require('zod');
3
+ var v3 = require('zod/v3');
4
4
 
5
5
  // src/schemas.ts
6
- var PiiCategorySchema = zod.z.enum([
6
+ var PiiCategorySchema = v3.z.enum([
7
7
  "email",
8
8
  "phone",
9
9
  "ssn",
@@ -32,72 +32,72 @@ var PiiCategorySchema = zod.z.enum([
32
32
  "case-number",
33
33
  "company-registration"
34
34
  ]);
35
- var MaskOptionsSchema = zod.z.object({
36
- strategy: zod.z.literal("mask"),
37
- maskChar: zod.z.string().length(1, "maskChar must be exactly one character").default("*").optional(),
38
- keepLeading: zod.z.number().int().nonnegative().default(0).optional(),
39
- keepTrailing: zod.z.number().int().nonnegative().default(0).optional()
35
+ var MaskOptionsSchema = v3.z.object({
36
+ strategy: v3.z.literal("mask"),
37
+ maskChar: v3.z.string().length(1, "maskChar must be exactly one character").default("*").optional(),
38
+ keepLeading: v3.z.number().int().nonnegative().default(0).optional(),
39
+ keepTrailing: v3.z.number().int().nonnegative().default(0).optional()
40
40
  });
41
- var RedactOptionsSchema = zod.z.object({
42
- strategy: zod.z.literal("redact"),
43
- label: zod.z.string().min(1, "label must not be empty").default("[REDACTED]").optional()
41
+ var RedactOptionsSchema = v3.z.object({
42
+ strategy: v3.z.literal("redact"),
43
+ label: v3.z.string().min(1, "label must not be empty").default("[REDACTED]").optional()
44
44
  });
45
- var PseudonymizeOptionsSchema = zod.z.object({
46
- strategy: zod.z.literal("pseudonymize"),
47
- seed: zod.z.string().optional(),
48
- prefix: zod.z.string().regex(/^\S+$/, "prefix must not contain whitespace").default("id_").optional()
45
+ var PseudonymizeOptionsSchema = v3.z.object({
46
+ strategy: v3.z.literal("pseudonymize"),
47
+ seed: v3.z.string().optional(),
48
+ prefix: v3.z.string().regex(/^\S+$/, "prefix must not contain whitespace").default("id_").optional()
49
49
  });
50
- var HashOptionsSchema = zod.z.object({
51
- strategy: zod.z.literal("hash"),
52
- truncate: zod.z.number().int().min(1).max(64).default(16).optional(),
53
- pepper: zod.z.string().optional()
50
+ var HashOptionsSchema = v3.z.object({
51
+ strategy: v3.z.literal("hash"),
52
+ truncate: v3.z.number().int().min(1).max(64).default(16).optional(),
53
+ pepper: v3.z.string().optional()
54
54
  });
55
- var GeneralizeOptionsSchema = zod.z.object({
56
- strategy: zod.z.literal("generalize"),
57
- bucketSize: zod.z.number().int().positive().default(10).optional()
55
+ var GeneralizeOptionsSchema = v3.z.object({
56
+ strategy: v3.z.literal("generalize"),
57
+ bucketSize: v3.z.number().int().positive().default(10).optional()
58
58
  });
59
- var StrategyOptionsSchema = zod.z.discriminatedUnion("strategy", [
59
+ var StrategyOptionsSchema = v3.z.discriminatedUnion("strategy", [
60
60
  MaskOptionsSchema,
61
61
  RedactOptionsSchema,
62
62
  PseudonymizeOptionsSchema,
63
63
  HashOptionsSchema,
64
64
  GeneralizeOptionsSchema
65
65
  ]);
66
- var PiiMatchSchema = zod.z.object({
66
+ var PiiMatchSchema = v3.z.object({
67
67
  category: PiiCategorySchema,
68
- value: zod.z.string(),
69
- start: zod.z.number().int().nonnegative(),
70
- end: zod.z.number().int().positive(),
71
- confidence: zod.z.number().min(0).max(1)
68
+ value: v3.z.string(),
69
+ start: v3.z.number().int().nonnegative(),
70
+ end: v3.z.number().int().positive(),
71
+ confidence: v3.z.number().min(0).max(1)
72
72
  });
73
- var AnonymizeResultSchema = zod.z.object({
74
- text: zod.z.string(),
75
- matches: zod.z.array(PiiMatchSchema)
73
+ var AnonymizeResultSchema = v3.z.object({
74
+ text: v3.z.string(),
75
+ matches: v3.z.array(PiiMatchSchema)
76
76
  });
77
- var AnonymizationRuleSchema = zod.z.object({
77
+ var AnonymizationRuleSchema = v3.z.object({
78
78
  category: PiiCategorySchema,
79
79
  strategy: StrategyOptionsSchema
80
80
  });
81
- var CustomPatternSchema = zod.z.object({
82
- pattern: zod.z.instanceof(RegExp, { message: "pattern must be a RegExp instance" }),
83
- category: zod.z.string().min(1).optional(),
84
- confidence: zod.z.number().min(0).max(1).optional(),
85
- label: zod.z.string().min(1, "label must not be empty").optional()
81
+ var CustomPatternSchema = v3.z.object({
82
+ pattern: v3.z.instanceof(RegExp, { message: "pattern must be a RegExp instance" }),
83
+ category: v3.z.string().min(1).optional(),
84
+ confidence: v3.z.number().min(0).max(1).optional(),
85
+ label: v3.z.string().min(1, "label must not be empty").optional()
86
86
  });
87
- var AnonymizeOptionsSchema = zod.z.object({
88
- rules: zod.z.array(AnonymizationRuleSchema).optional(),
87
+ var AnonymizeOptionsSchema = v3.z.object({
88
+ rules: v3.z.array(AnonymizationRuleSchema).optional(),
89
89
  defaultStrategy: StrategyOptionsSchema.optional(),
90
- includeMatches: zod.z.boolean().default(false).optional(),
91
- customPatterns: zod.z.array(CustomPatternSchema).optional(),
92
- globalReplacement: zod.z.string().min(1, "globalReplacement must not be empty").optional(),
93
- consistentTokens: zod.z.boolean().default(false).optional(),
94
- aggressive: zod.z.boolean().default(false).optional(),
95
- enabledCategories: zod.z.record(PiiCategorySchema, zod.z.boolean()).optional()
90
+ includeMatches: v3.z.boolean().default(false).optional(),
91
+ customPatterns: v3.z.array(CustomPatternSchema).optional(),
92
+ globalReplacement: v3.z.string().min(1, "globalReplacement must not be empty").optional(),
93
+ consistentTokens: v3.z.boolean().default(false).optional(),
94
+ aggressive: v3.z.boolean().default(false).optional(),
95
+ enabledCategories: v3.z.record(PiiCategorySchema, v3.z.boolean()).optional()
96
96
  });
97
- var FieldRuleSchema = zod.z.object({
97
+ var FieldRuleSchema = v3.z.object({
98
98
  strategy: StrategyOptionsSchema
99
99
  });
100
- var FieldRuleMapSchema = zod.z.record(zod.z.string(), FieldRuleSchema);
100
+ var FieldRuleMapSchema = v3.z.record(v3.z.string(), FieldRuleSchema);
101
101
  var ANONYMIZE_TOOL_DEFINITION = {
102
102
  name: "anonymize",
103
103
  description: "Detect and anonymize PII (personally identifiable information) in a text string. Returns the anonymized text and, optionally, a list of detected PII matches.",
@@ -239,7 +239,7 @@ var ANONYMIZE_OBJECT_TOOL_DEFINITION = {
239
239
  };
240
240
  var ANONYMA_MANIFEST = {
241
241
  name: "anonyma",
242
- version: "1.1.1",
242
+ version: "1.2.0",
243
243
  description: "TypeScript-first PII detection & anonymization \u2014 27 built-in detectors (email, SSN, IBAN, passport, credit card, and more), 8 strategies (mask, redact, hash, AES-256 encrypt, tokenize, pseudonymize, generalize, synthesize), 8 compliance presets (GDPR, LGPD, PIPEDA, HIPAA, CCPA, PCI-DSS, SOX, FERPA), reversible tokenization, LLM/AI pipeline helpers, WHATWG streaming, batch processing, checksum validators, and optional Zod/MCP schemas. Zero runtime dependencies.",
244
244
  capabilities: {
245
245
  detect: {
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/schemas.ts"],"names":["z"],"mappings":";;;;;AAqCO,IAAM,iBAAA,GAAoBA,MAAE,IAAA,CAAK;AAAA,EACtC,OAAA;AAAA,EACA,OAAA;AAAA,EACA,KAAA;AAAA,EACA,aAAA;AAAA,EACA,MAAA;AAAA,EACA,MAAA;AAAA,EACA,KAAA;AAAA,EACA,MAAA;AAAA,EACA,eAAA;AAAA,EACA,MAAA;AAAA,EACA,SAAA;AAAA,EACA,UAAA;AAAA,EACA,iBAAA;AAAA,EACA,aAAA;AAAA,EACA,cAAA;AAAA,EACA,gBAAA;AAAA,EACA,QAAA;AAAA,EACA,gBAAA;AAAA,EACA,kBAAA;AAAA,EACA,cAAA;AAAA,EACA,SAAA;AAAA,EACA,cAAA;AAAA,EACA,KAAA;AAAA,EACA,eAAA;AAAA,EACA,iBAAA;AAAA,EACA,aAAA;AAAA,EACA;AACF,CAAC;AAKM,IAAM,iBAAA,GAAoBA,MAAE,MAAA,CAAO;AAAA,EACxC,QAAA,EAAUA,KAAA,CAAE,OAAA,CAAQ,MAAM,CAAA;AAAA,EAC1B,QAAA,EAAUA,KAAA,CAAE,MAAA,EAAO,CAAE,MAAA,CAAO,CAAA,EAAG,wCAAwC,CAAA,CAAE,OAAA,CAAQ,GAAG,CAAA,CAAE,QAAA,EAAS;AAAA,EAC/F,WAAA,EAAaA,KAAA,CAAE,MAAA,EAAO,CAAE,GAAA,EAAI,CAAE,WAAA,EAAY,CAAE,OAAA,CAAQ,CAAC,CAAA,CAAE,QAAA,EAAS;AAAA,EAChE,YAAA,EAAcA,KAAA,CAAE,MAAA,EAAO,CAAE,GAAA,EAAI,CAAE,WAAA,EAAY,CAAE,OAAA,CAAQ,CAAC,CAAA,CAAE,QAAA;AAC1D,CAAC;AAKM,IAAM,mBAAA,GAAsBA,MAAE,MAAA,CAAO;AAAA,EAC1C,QAAA,EAAUA,KAAA,CAAE,OAAA,CAAQ,QAAQ,CAAA;AAAA,EAC5B,KAAA,EAAOA,KAAA,CAAE,MAAA,EAAO,CAAE,GAAA,CAAI,CAAA,EAAG,yBAAyB,CAAA,CAAE,OAAA,CAAQ,YAAY,CAAA,CAAE,QAAA;AAC5E,CAAC;AAKM,IAAM,yBAAA,GAA4BA,MAAE,MAAA,CAAO;AAAA,EAChD,QAAA,EAAUA,KAAA,CAAE,OAAA,CAAQ,cAAc,CAAA;AAAA,EAClC,IAAA,EAAMA,KAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAC1B,MAAA,EAAQA,KAAA,CAAE,MAAA,EAAO,CAAE,KAAA,CAAM,OAAA,EAAS,oCAAoC,CAAA,CAAE,OAAA,CAAQ,KAAK,CAAA,CAAE,QAAA;AACzF,CAAC;AAKM,IAAM,iBAAA,GAAoBA,MAAE,MAAA,CAAO;AAAA,EACxC,QAAA,EAAUA,KAAA,CAAE,OAAA,CAAQ,MAAM,CAAA;AAAA,EAC1B,QAAA,EAAUA,KAAA,CAAE,MAAA,EAAO,CAAE,KAAI,CAAE,GAAA,CAAI,CAAC,CAAA,CAAE,IAAI,EAAE,CAAA,CAAE,OAAA,CAAQ,EAAE,EAAE,QAAA,EAAS;AAAA,EAC/D,MAAA,EAAQA,KAAA,CAAE,MAAA,EAAO,CAAE,QAAA;AACrB,CAAC;AAKM,IAAM,uBAAA,GAA0BA,MAAE,MAAA,CAAO;AAAA,EAC9C,QAAA,EAAUA,KAAA,CAAE,OAAA,CAAQ,YAAY,CAAA;AAAA,EAChC,UAAA,EAAYA,KAAA,CAAE,MAAA,EAAO,CAAE,GAAA,EAAI,CAAE,QAAA,EAAS,CAAE,OAAA,CAAQ,EAAE,CAAA,CAAE,QAAA;AACtD,CAAC;AAKM,IAAM,qBAAA,GAAwBA,KAAA,CAAE,kBAAA,CAAmB,UAAA,EAAY;AAAA,EACpE,iBAAA;AAAA,EACA,mBAAA;AAAA,EACA,yBAAA;AAAA,EACA,iBAAA;AAAA,EACA;AACF,CAAC;AASM,IAAM,cAAA,GAAiBA,MAAE,MAAA,CAAO;AAAA,EACrC,QAAA,EAAU,iBAAA;AAAA,EACV,KAAA,EAAOA,MAAE,MAAA,EAAO;AAAA,EAChB,OAAOA,KAAA,CAAE,MAAA,EAAO,CAAE,GAAA,GAAM,WAAA,EAAY;AAAA,EACpC,KAAKA,KAAA,CAAE,MAAA,EAAO,CAAE,GAAA,GAAM,QAAA,EAAS;AAAA,EAC/B,UAAA,EAAYA,MAAE,MAAA,EAAO,CAAE,IAAI,CAAC,CAAA,CAAE,IAAI,CAAC;AACrC,CAAC;AAKM,IAAM,qBAAA,GAAwBA,MAAE,MAAA,CAAO;AAAA,EAC5C,IAAA,EAAMA,MAAE,MAAA,EAAO;AAAA,EACf,OAAA,EAASA,KAAA,CAAE,KAAA,CAAM,cAAc;AACjC,CAAC;AASM,IAAM,uBAAA,GAA0BA,MAAE,MAAA,CAAO;AAAA,EAC9C,QAAA,EAAU,iBAAA;AAAA,EACV,QAAA,EAAU;AACZ,CAAC;AAKM,IAAM,mBAAA,GAAsBA,MAAE,MAAA,CAAO;AAAA,EAC1C,SAASA,KAAA,CAAE,UAAA,CAAW,QAAQ,EAAE,OAAA,EAAS,qCAAqC,CAAA;AAAA,EAC9E,UAAUA,KAAA,CAAE,MAAA,GAAS,GAAA,CAAI,CAAC,EAAE,QAAA,EAAS;AAAA,EACrC,UAAA,EAAYA,KAAA,CAAE,MAAA,EAAO,CAAE,GAAA,CAAI,CAAC,CAAA,CAAE,GAAA,CAAI,CAAC,CAAA,CAAE,QAAA,EAAS;AAAA,EAC9C,KAAA,EAAOA,MAAE,MAAA,EAAO,CAAE,IAAI,CAAA,EAAG,yBAAyB,EAAE,QAAA;AACtD,CAAC;AAKM,IAAM,sBAAA,GAAyBA,MAAE,MAAA,CAAO;AAAA,EAC7C,KAAA,EAAOA,KAAA,CAAE,KAAA,CAAM,uBAAuB,EAAE,QAAA,EAAS;AAAA,EACjD,eAAA,EAAiB,sBAAsB,QAAA,EAAS;AAAA,EAChD,gBAAgBA,KAAA,CAAE,OAAA,GAAU,OAAA,CAAQ,KAAK,EAAE,QAAA,EAAS;AAAA,EACpD,cAAA,EAAgBA,KAAA,CAAE,KAAA,CAAM,mBAAmB,EAAE,QAAA,EAAS;AAAA,EACtD,iBAAA,EAAmBA,MAAE,MAAA,EAAO,CAAE,IAAI,CAAA,EAAG,qCAAqC,EAAE,QAAA,EAAS;AAAA,EACrF,kBAAkBA,KAAA,CAAE,OAAA,GAAU,OAAA,CAAQ,KAAK,EAAE,QAAA,EAAS;AAAA,EACtD,YAAYA,KAAA,CAAE,OAAA,GAAU,OAAA,CAAQ,KAAK,EAAE,QAAA,EAAS;AAAA,EAChD,iBAAA,EAAmBA,MAAE,MAAA,CAAO,iBAAA,EAAmBA,MAAE,OAAA,EAAS,EAAE,QAAA;AAC9D,CAAC;AASM,IAAM,eAAA,GAAkBA,MAAE,MAAA,CAAO;AAAA,EACtC,QAAA,EAAU;AACZ,CAAC;AAKM,IAAM,qBAAqBA,KAAA,CAAE,MAAA,CAAOA,KAAA,CAAE,MAAA,IAAU,eAAe;AAiD/D,IAAM,yBAAA,GAAsD;AAAA,EACjE,IAAA,EAAM,WAAA;AAAA,EACN,WAAA,EACE,+JAAA;AAAA,EAEF,UAAA,EAAY;AAAA,IACV,IAAA,EAAM,QAAA;AAAA,IACN,UAAA,EAAY;AAAA,MACV,IAAA,EAAM;AAAA,QACJ,IAAA,EAAM,QAAA;AAAA,QACN,WAAA,EAAa;AAAA,OACf;AAAA,MACA,eAAA,EAAiB;AAAA,QACf,IAAA,EAAM,QAAA;AAAA,QACN,WAAA,EACE,gGAAA;AAAA,QAEF,UAAA,EAAY;AAAA,UACV,QAAA,EAAU;AAAA,YACR,IAAA,EAAM,QAAA;AAAA,YACN,MAAM,CAAC,MAAA,EAAQ,QAAA,EAAU,cAAA,EAAgB,QAAQ,YAAY;AAAA;AAC/D,SACF;AAAA,QACA,QAAA,EAAU,CAAC,UAAU;AAAA,OACvB;AAAA,MACA,cAAA,EAAgB;AAAA,QACd,IAAA,EAAM,SAAA;AAAA,QACN,WAAA,EAAa;AAAA,OACf;AAAA,MACA,iBAAA,EAAmB;AAAA,QACjB,IAAA,EAAM,QAAA;AAAA,QACN,WAAA,EACE;AAAA,OAEJ;AAAA,MACA,gBAAA,EAAkB;AAAA,QAChB,IAAA,EAAM,SAAA;AAAA,QACN,WAAA,EACE;AAAA,OAEJ;AAAA,MACA,UAAA,EAAY;AAAA,QACV,IAAA,EAAM,SAAA;AAAA,QACN,WAAA,EACE;AAAA;AAEJ,KACF;AAAA,IACA,QAAA,EAAU,CAAC,MAAM;AAAA;AAErB;AAKO,IAAM,sBAAA,GAAmD;AAAA,EAC9D,IAAA,EAAM,QAAA;AAAA,EACN,WAAA,EACE,uJAAA;AAAA,EAEF,UAAA,EAAY;AAAA,IACV,IAAA,EAAM,QAAA;AAAA,IACN,UAAA,EAAY;AAAA,MACV,IAAA,EAAM;AAAA,QACJ,IAAA,EAAM,QAAA;AAAA,QACN,WAAA,EAAa;AAAA,OACf;AAAA,MACA,UAAA,EAAY;AAAA,QACV,IAAA,EAAM,OAAA;AAAA,QACN,WAAA,EACE,oFAAA;AAAA,QACF,KAAA,EAAO;AAAA,UACL,IAAA,EAAM,QAAA;AAAA,UACN,IAAA,EAAM;AAAA,YACJ,OAAA;AAAA,YACA,OAAA;AAAA,YACA,KAAA;AAAA,YACA,aAAA;AAAA,YACA,MAAA;AAAA,YACA,MAAA;AAAA,YACA,KAAA;AAAA,YACA,MAAA;AAAA,YACA,eAAA;AAAA,YACA;AAAA;AACF;AACF;AACF,KACF;AAAA,IACA,QAAA,EAAU,CAAC,MAAM;AAAA;AAErB;AAeO,IAAM,uBAAA,GAAoD;AAAA,EAC/D,IAAA,EAAM,QAAA;AAAA,EACN,WAAA,EACE,6KAAA;AAAA,EAEF,UAAA,EAAY;AAAA,IACV,IAAA,EAAM,QAAA;AAAA,IACN,UAAA,EAAY;AAAA,MACV,IAAA,EAAM;AAAA,QACJ,IAAA,EAAM,QAAA;AAAA,QACN,WAAA,EAAa;AAAA,OACf;AAAA,MACA,UAAA,EAAY;AAAA,QACV,IAAA,EAAM,OAAA;AAAA,QACN,WAAA,EAAa,8DAAA;AAAA,QACb,KAAA,EAAO;AAAA,UACL,IAAA,EAAM,QAAA;AAAA,UACN,IAAA,EAAM;AAAA,YACJ,OAAA;AAAA,YACA,OAAA;AAAA,YACA,KAAA;AAAA,YACA,aAAA;AAAA,YACA,MAAA;AAAA,YACA,MAAA;AAAA,YACA,KAAA;AAAA,YACA,MAAA;AAAA,YACA,eAAA;AAAA,YACA;AAAA;AACF;AACF;AACF,KACF;AAAA,IACA,QAAA,EAAU,CAAC,MAAM;AAAA;AAErB;AAUO,IAAM,gCAAA,GAA6D;AAAA,EACxE,IAAA,EAAM,iBAAA;AAAA,EACN,WAAA,EACE,uOAAA;AAAA,EAGF,UAAA,EAAY;AAAA,IACV,IAAA,EAAM,QAAA;AAAA,IACN,UAAA,EAAY;AAAA,MACV,GAAA,EAAK;AAAA,QACH,IAAA,EAAM,QAAA;AAAA,QACN,WAAA,EAAa;AAAA,OACf;AAAA,MACA,OAAA,EAAS;AAAA,QACP,IAAA,EAAM,QAAA;AAAA,QACN,WAAA,EAAa,qEAAA;AAAA,QACb,UAAA,EAAY;AAAA,UACV,iBAAA,EAAmB;AAAA,YACjB,IAAA,EAAM,QAAA;AAAA,YACN,WAAA,EAAa;AAAA,WACf;AAAA,UACA,gBAAA,EAAkB;AAAA,YAChB,IAAA,EAAM,SAAA;AAAA,YACN,WAAA,EAAa;AAAA,WACf;AAAA,UACA,UAAA,EAAY;AAAA,YACV,IAAA,EAAM,SAAA;AAAA,YACN,WAAA,EAAa;AAAA;AACf;AACF;AACF,KACF;AAAA,IACA,QAAA,EAAU,CAAC,KAAK;AAAA;AAEpB;AAkBO,IAAM,gBAAA,GAAmB;AAAA,EAC9B,IAAA,EAAM,SAAA;AAAA,EACN,OAAA,EAAS,OAAA;AAAA,EACT,WAAA,EACE,udAAA;AAAA,EACF,YAAA,EAAc;AAAA,IACZ,MAAA,EAAQ;AAAA,MACN,WAAA,EAAa,+CAAA;AAAA,MACb,mBAAA,EAAqB;AAAA,QACnB,OAAA;AAAA,QACA,OAAA;AAAA,QACA,KAAA;AAAA,QACA,aAAA;AAAA,QACA,MAAA;AAAA,QACA,MAAA;AAAA,QACA,KAAA;AAAA,QACA,MAAA;AAAA,QACA,eAAA;AAAA,QACA,MAAA;AAAA,QACA,SAAA;AAAA,QACA,UAAA;AAAA,QACA,iBAAA;AAAA,QACA,aAAA;AAAA,QACA,cAAA;AAAA,QACA,gBAAA;AAAA,QACA,QAAA;AAAA,QACA,gBAAA;AAAA,QACA,kBAAA;AAAA,QACA,cAAA;AAAA,QACA,SAAA;AAAA,QACA,cAAA;AAAA,QACA,KAAA;AAAA,QACA,eAAA;AAAA,QACA,iBAAA;AAAA,QACA,aAAA;AAAA,QACA;AAAA,OACF;AAAA,MACA,KAAA,EAAO;AAAA,QACL,IAAA,EACE;AAAA,OAEJ;AAAA,MACA,OAAA,EAAS;AAAA,KACX;AAAA,IACA,MAAA,EAAQ;AAAA,MACN,WAAA,EACE,sHAAA;AAAA,MAEF,OAAA,EAAS;AAAA,KACX;AAAA,IACA,SAAA,EAAW;AAAA,MACT,WAAA,EAAa,oEAAA;AAAA,MACb,UAAA,EAAY;AAAA,QACV,IAAA,EAAM,+EAAA;AAAA,QACN,MAAA,EAAQ,2DAAA;AAAA,QACR,YAAA,EAAc,6EAAA;AAAA,QACd,IAAA,EAAM,mEAAA;AAAA,QACN,UAAA,EAAY,qEAAA;AAAA,QACZ,QAAA,EAAU,6EAAA;AAAA,QACV,OAAA,EAAS,gFAAA;AAAA,QACT,UAAA,EAAY;AAAA,OACd;AAAA,MACA,OAAA,EAAS;AAAA,QACP,iBAAA,EAAmB,iEAAA;AAAA,QACnB,gBAAA,EAAkB,0EAAA;AAAA,QAClB,UAAA,EAAY,uEAAA;AAAA,QACZ,iBAAA,EAAmB,4DAAA;AAAA,QACnB,cAAA,EAAgB,2DAAA;AAAA,QAChB,eAAA,EAAiB,sDAAA;AAAA,QACjB,MAAA,EACE,0FAAA;AAAA,QACF,SAAA,EAAW,0EAAA;AAAA,QACX,mBAAA,EAAqB;AAAA,OACvB;AAAA,MACA,OAAA,EAAS;AAAA,KACX;AAAA,IACA,QAAA,EAAU;AAAA,MACR,WAAA,EAAa,yEAAA;AAAA,MACb,OAAA,EAAS;AAAA,KACX;AAAA,IACA,eAAA,EAAiB;AAAA,MACf,WAAA,EACE,oJAAA;AAAA,MAEF,OAAA,EAAS;AAAA,KACX;AAAA,IACA,eAAA,EAAiB;AAAA,MACf,WAAA,EAAa,sEAAA;AAAA,MACb,OAAA,EAAS;AAAA,KACX;AAAA,IACA,KAAA,EAAO;AAAA,MACL,WAAA,EACE,mJAAA;AAAA,MAEF,OAAA,EAAS;AAAA,KACX;AAAA,IACA,OAAA,EAAS;AAAA,MACP,WAAA,EAAa,0EAAA;AAAA,MACb,SAAA,EAAW,CAAC,MAAA,EAAQ,MAAA,EAAQ,UAAU,OAAA,EAAS,MAAA,EAAQ,SAAA,EAAW,KAAA,EAAO,OAAO;AAAA;AAClF,GACF;AAAA,EACA,eAAA,EAAiB;AAAA,IACf,MAAA,EAAQ;AAAA,MACN,yBAAA;AAAA,MACA,sBAAA;AAAA,MACA,uBAAA;AAAA,MACA;AAAA;AACF;AAEJ","file":"schemas.cjs","sourcesContent":["/**\n * @module schemas\n * @description Optional Zod schemas and JSON Schema definitions for anonyma's\n * public API surface. Import from `\"anonyma/schemas\"`.\n *\n * These schemas enable:\n * - Runtime input validation\n * - Function-calling tool definitions (OpenAI format) and a capability manifest\n * - Automatic form generation\n *\n * The Model Context Protocol declarations and server are in `\"anonyma/mcp\"`.\n *\n * @example\n * ```ts\n * import { AnonymizeOptionsSchema, ANONYMIZE_TOOL_DEFINITION } from \"anonyma/schemas\";\n *\n * // Validate at runtime:\n * const opts = AnonymizeOptionsSchema.parse(unknownInput);\n *\n * // Offer anonymization to a model as a tool:\n * const tools = [{ type: \"function\", function: ANONYMIZE_TOOL_DEFINITION }];\n * ```\n *\n * @remarks\n * This module requires `zod` to be installed (`peerDependency`).\n * Import it only when you need runtime validation or AI schema generation.\n */\n\nimport { z } from \"zod\";\n\n// ---------------------------------------------------------------------------\n// Category & strategy schemas\n// ---------------------------------------------------------------------------\n\n/**\n * Zod schema for the {@link PiiCategory} union.\n */\nexport const PiiCategorySchema = z.enum([\n \"email\",\n \"phone\",\n \"ssn\",\n \"credit-card\",\n \"ipv4\",\n \"ipv6\",\n \"url\",\n \"iban\",\n \"date-of-birth\",\n \"name\",\n \"address\",\n \"passport\",\n \"drivers-license\",\n \"national-id\",\n \"bank-account\",\n \"cryptocurrency\",\n \"tax-id\",\n \"medical-record\",\n \"health-insurance\",\n \"prescription\",\n \"api-key\",\n \"social-media\",\n \"vin\",\n \"license-plate\",\n \"tracking-number\",\n \"case-number\",\n \"company-registration\",\n]);\n\n/**\n * Zod schema for {@link MaskOptions}.\n */\nexport const MaskOptionsSchema = z.object({\n strategy: z.literal(\"mask\"),\n maskChar: z.string().length(1, \"maskChar must be exactly one character\").default(\"*\").optional(),\n keepLeading: z.number().int().nonnegative().default(0).optional(),\n keepTrailing: z.number().int().nonnegative().default(0).optional(),\n});\n\n/**\n * Zod schema for {@link RedactOptions}.\n */\nexport const RedactOptionsSchema = z.object({\n strategy: z.literal(\"redact\"),\n label: z.string().min(1, \"label must not be empty\").default(\"[REDACTED]\").optional(),\n});\n\n/**\n * Zod schema for {@link PseudonymizeOptions}.\n */\nexport const PseudonymizeOptionsSchema = z.object({\n strategy: z.literal(\"pseudonymize\"),\n seed: z.string().optional(),\n prefix: z.string().regex(/^\\S+$/, \"prefix must not contain whitespace\").default(\"id_\").optional(),\n});\n\n/**\n * Zod schema for {@link HashOptions}.\n */\nexport const HashOptionsSchema = z.object({\n strategy: z.literal(\"hash\"),\n truncate: z.number().int().min(1).max(64).default(16).optional(),\n pepper: z.string().optional(),\n});\n\n/**\n * Zod schema for {@link GeneralizeOptions}.\n */\nexport const GeneralizeOptionsSchema = z.object({\n strategy: z.literal(\"generalize\"),\n bucketSize: z.number().int().positive().default(10).optional(),\n});\n\n/**\n * Discriminated union schema for {@link StrategyOptions}.\n */\nexport const StrategyOptionsSchema = z.discriminatedUnion(\"strategy\", [\n MaskOptionsSchema,\n RedactOptionsSchema,\n PseudonymizeOptionsSchema,\n HashOptionsSchema,\n GeneralizeOptionsSchema,\n]);\n\n// ---------------------------------------------------------------------------\n// Match & result schemas\n// ---------------------------------------------------------------------------\n\n/**\n * Zod schema for {@link PiiMatch}.\n */\nexport const PiiMatchSchema = z.object({\n category: PiiCategorySchema,\n value: z.string(),\n start: z.number().int().nonnegative(),\n end: z.number().int().positive(),\n confidence: z.number().min(0).max(1),\n});\n\n/**\n * Zod schema for {@link AnonymizeResult}.\n */\nexport const AnonymizeResultSchema = z.object({\n text: z.string(),\n matches: z.array(PiiMatchSchema),\n});\n\n// ---------------------------------------------------------------------------\n// Anonymize options schema\n// ---------------------------------------------------------------------------\n\n/**\n * Zod schema for a single {@link AnonymizationRule}.\n */\nexport const AnonymizationRuleSchema = z.object({\n category: PiiCategorySchema,\n strategy: StrategyOptionsSchema,\n});\n\n/**\n * Zod schema for a {@link CustomPattern}.\n */\nexport const CustomPatternSchema = z.object({\n pattern: z.instanceof(RegExp, { message: \"pattern must be a RegExp instance\" }),\n category: z.string().min(1).optional(),\n confidence: z.number().min(0).max(1).optional(),\n label: z.string().min(1, \"label must not be empty\").optional(),\n});\n\n/**\n * Zod schema for {@link AnonymizeOptions}.\n */\nexport const AnonymizeOptionsSchema = z.object({\n rules: z.array(AnonymizationRuleSchema).optional(),\n defaultStrategy: StrategyOptionsSchema.optional(),\n includeMatches: z.boolean().default(false).optional(),\n customPatterns: z.array(CustomPatternSchema).optional(),\n globalReplacement: z.string().min(1, \"globalReplacement must not be empty\").optional(),\n consistentTokens: z.boolean().default(false).optional(),\n aggressive: z.boolean().default(false).optional(),\n enabledCategories: z.record(PiiCategorySchema, z.boolean()).optional(),\n});\n\n// ---------------------------------------------------------------------------\n// Field-level anonymization schema\n// ---------------------------------------------------------------------------\n\n/**\n * Zod schema for a single field rule.\n */\nexport const FieldRuleSchema = z.object({\n strategy: StrategyOptionsSchema,\n});\n\n/**\n * Zod schema for a {@link FieldRuleMap}.\n */\nexport const FieldRuleMapSchema = z.record(z.string(), FieldRuleSchema);\n\n// ---------------------------------------------------------------------------\n// JSON Schema / OpenAI function-calling definitions\n// ---------------------------------------------------------------------------\n\n/**\n * A minimal JSON Schema representation extracted from a Zod schema.\n * Suitable for use in OpenAI function definitions, MCP tool definitions, etc.\n */\nexport interface JsonSchemaDefinition {\n readonly type: string;\n readonly description?: string;\n readonly properties?: Record<string, JsonSchemaDefinition>;\n readonly items?: JsonSchemaDefinition;\n readonly enum?: readonly string[];\n readonly required?: readonly string[];\n readonly anyOf?: readonly JsonSchemaDefinition[];\n readonly default?: unknown;\n}\n\n/**\n * OpenAI-compatible function definition shape.\n */\nexport interface OpenAiFunctionDefinition {\n readonly name: string;\n readonly description: string;\n readonly parameters: {\n readonly type: \"object\";\n readonly properties: Record<string, JsonSchemaDefinition>;\n readonly required?: readonly string[];\n };\n}\n\n/**\n * Pre-built OpenAI / MCP tool definition for the `anonymize` function.\n *\n * @example\n * ```ts\n * import { ANONYMIZE_TOOL_DEFINITION } from \"anonyma/schemas\";\n *\n * // Pass directly to OpenAI client tools array:\n * const response = await openai.chat.completions.create({\n * model: \"gpt-4o\",\n * tools: [{ type: \"function\", function: ANONYMIZE_TOOL_DEFINITION }],\n * messages: [...],\n * });\n * ```\n */\nexport const ANONYMIZE_TOOL_DEFINITION: OpenAiFunctionDefinition = {\n name: \"anonymize\",\n description:\n \"Detect and anonymize PII (personally identifiable information) in a text string. \" +\n \"Returns the anonymized text and, optionally, a list of detected PII matches.\",\n parameters: {\n type: \"object\",\n properties: {\n text: {\n type: \"string\",\n description: \"The input text to anonymize.\",\n },\n defaultStrategy: {\n type: \"object\",\n description:\n \"The anonymization strategy to apply to all detected PII. \" +\n \"Defaults to `{ strategy: 'redact' }`.\",\n properties: {\n strategy: {\n type: \"string\",\n enum: [\"mask\", \"redact\", \"pseudonymize\", \"hash\", \"generalize\"] as const,\n },\n },\n required: [\"strategy\"],\n },\n includeMatches: {\n type: \"boolean\",\n description: \"When true, include detected PII matches in the response.\",\n },\n globalReplacement: {\n type: \"string\",\n description:\n \"When set, every detected PII entity is replaced with this exact string, \" +\n \"overriding per-category rules and defaultStrategy.\",\n },\n consistentTokens: {\n type: \"boolean\",\n description:\n \"When true, identical PII values receive the same token (e.g. EMAIL_1) \" +\n \"across the entire call. Different values get different tokens.\",\n },\n aggressive: {\n type: \"boolean\",\n description:\n \"When true, detectors use expanded, more permissive patterns to catch \" +\n \"obfuscated PII at the cost of higher false-positive rates.\",\n },\n },\n required: [\"text\"],\n },\n};\n\n/**\n * Pre-built OpenAI / MCP tool definition for the `detect` function.\n */\nexport const DETECT_TOOL_DEFINITION: OpenAiFunctionDefinition = {\n name: \"detect\",\n description:\n \"Detect all PII (email, phone, SSN, credit card, IP, URL, IBAN, date-of-birth, name) \" +\n \"in a text string without modifying it. Returns a list of matches.\",\n parameters: {\n type: \"object\",\n properties: {\n text: {\n type: \"string\",\n description: \"The input text to scan for PII.\",\n },\n categories: {\n type: \"array\",\n description:\n \"Optional subset of PII categories to detect. \" + \"Defaults to all supported categories.\",\n items: {\n type: \"string\",\n enum: [\n \"email\",\n \"phone\",\n \"ssn\",\n \"credit-card\",\n \"ipv4\",\n \"ipv6\",\n \"url\",\n \"iban\",\n \"date-of-birth\",\n \"name\",\n ] as const,\n },\n },\n },\n required: [\"text\"],\n },\n};\n\n/**\n * Pre-built OpenAI / MCP tool definition for the `hasPII` function.\n *\n * @example\n * ```ts\n * import { HAS_PII_TOOL_DEFINITION } from \"anonyma/schemas\";\n *\n * const response = await openai.chat.completions.create({\n * tools: [{ type: \"function\", function: HAS_PII_TOOL_DEFINITION }],\n * messages: [...],\n * });\n * ```\n */\nexport const HAS_PII_TOOL_DEFINITION: OpenAiFunctionDefinition = {\n name: \"hasPII\",\n description:\n \"Check whether a text string contains any detectable PII without redacting it. \" +\n \"Returns true/false. Uses early-exit optimisation — stops scanning after the first match.\",\n parameters: {\n type: \"object\",\n properties: {\n text: {\n type: \"string\",\n description: \"The input text to check for PII.\",\n },\n categories: {\n type: \"array\",\n description: \"Optional subset of PII categories to check. Defaults to all.\",\n items: {\n type: \"string\",\n enum: [\n \"email\",\n \"phone\",\n \"ssn\",\n \"credit-card\",\n \"ipv4\",\n \"ipv6\",\n \"url\",\n \"iban\",\n \"date-of-birth\",\n \"name\",\n ] as const,\n },\n },\n },\n required: [\"text\"],\n },\n};\n\n/**\n * Pre-built OpenAI / MCP tool definition for the `anonymizeObject` function.\n *\n * @example\n * ```ts\n * import { ANONYMIZE_OBJECT_TOOL_DEFINITION } from \"anonyma/schemas\";\n * ```\n */\nexport const ANONYMIZE_OBJECT_TOOL_DEFINITION: OpenAiFunctionDefinition = {\n name: \"anonymizeObject\",\n description:\n \"Recursively anonymize all string values found in a JSON-serializable object tree. \" +\n \"Returns a deep clone with PII replaced. Arrays, nested objects, and mixed structures \" +\n \"are all handled. Non-string primitives pass through unchanged.\",\n parameters: {\n type: \"object\",\n properties: {\n obj: {\n type: \"object\",\n description: \"The JSON-serializable object to anonymize.\",\n },\n options: {\n type: \"object\",\n description: \"Optional anonymization configuration (same as anonymize() options).\",\n properties: {\n globalReplacement: {\n type: \"string\",\n description: \"Replace all PII with this exact string.\",\n },\n consistentTokens: {\n type: \"boolean\",\n description: \"Same PII value → same token across the entire object.\",\n },\n aggressive: {\n type: \"boolean\",\n description: \"Enable more permissive detection patterns.\",\n },\n },\n },\n },\n required: [\"obj\"],\n },\n};\n\n// ---------------------------------------------------------------------------\n// AI-readable capability manifest\n// ---------------------------------------------------------------------------\n\n/**\n * Machine-readable manifest describing anonyma's capabilities.\n * Useful for AI agents that need to discover and reason about available tools.\n *\n * @example\n * ```ts\n * import { ANONYMA_MANIFEST } from \"anonyma/schemas\";\n *\n * // Provide to an AI agent as system context:\n * const systemPrompt = `You have access to the following data privacy tool:\\n\\n${JSON.stringify(ANONYMA_MANIFEST, null, 2)}`;\n * ```\n */\nexport const ANONYMA_MANIFEST = {\n name: \"anonyma\",\n version: \"1.1.1\",\n description:\n \"TypeScript-first PII detection & anonymization — 27 built-in detectors (email, SSN, IBAN, passport, credit card, and more), 8 strategies (mask, redact, hash, AES-256 encrypt, tokenize, pseudonymize, generalize, synthesize), 8 compliance presets (GDPR, LGPD, PIPEDA, HIPAA, CCPA, PCI-DSS, SOX, FERPA), reversible tokenization, LLM/AI pipeline helpers, WHATWG streaming, batch processing, checksum validators, and optional Zod/MCP schemas. Zero runtime dependencies.\",\n capabilities: {\n detect: {\n description: \"Detect PII in free text without modifying it.\",\n supportedCategories: [\n \"email\",\n \"phone\",\n \"ssn\",\n \"credit-card\",\n \"ipv4\",\n \"ipv6\",\n \"url\",\n \"iban\",\n \"date-of-birth\",\n \"name\",\n \"address\",\n \"passport\",\n \"drivers-license\",\n \"national-id\",\n \"bank-account\",\n \"cryptocurrency\",\n \"tax-id\",\n \"medical-record\",\n \"health-insurance\",\n \"prescription\",\n \"api-key\",\n \"social-media\",\n \"vin\",\n \"license-plate\",\n \"tracking-number\",\n \"case-number\",\n \"company-registration\",\n ],\n notes: {\n name:\n \"Name detection is heuristic — only catches names preceded by greeting keywords \" +\n \"(e.g. 'Dear Alice'). Not an NLP-based named-entity recogniser.\",\n },\n returns: \"Array of PiiMatch objects with category, value, position, and confidence.\",\n },\n hasPII: {\n description:\n \"Return true/false indicating whether a string contains detectable PII. \" +\n \"Uses early-exit optimisation for performance.\",\n returns: \"boolean\",\n },\n anonymize: {\n description: \"Detect and replace PII in free text using a configurable strategy.\",\n strategies: {\n mask: \"Replace characters with a mask char, keeping optional leading/trailing chars.\",\n redact: \"Replace the entire value with a label such as [REDACTED].\",\n pseudonymize: \"Replace with a deterministic pseudonym (requires seed for reproducibility).\",\n hash: \"Replace with a one-way SHA-256 hash (requires Node.js ≥ 18).\",\n generalize: \"Replace a numeric value with a bucket range (e.g. 27 → 20-29).\",\n tokenize: \"Replace with a reversible opaque token ([CATEGORY_NNNN]) for LLM pipelines.\",\n encrypt: \"Replace with AES-GCM ciphertext (requires Node.js ≥ 18 + passphrase/key).\",\n synthesize: \"Replace with structurally-valid synthetic data (format-preserving).\",\n },\n options: {\n globalReplacement: \"Override ALL strategy outputs with a single replacement string.\",\n consistentTokens: \"Same PII value → same token (EMAIL_1, PHONE_2, etc.) within a call.\",\n aggressive: \"Use expanded, more permissive regex patterns to catch obfuscated PII.\",\n enabledCategories: \"Convenience boolean map for enabling/disabling categories.\",\n customPatterns: \"Ad-hoc regex patterns merged into the detection pipeline.\",\n customDetectors: \"Override built-in detectors on a per-category basis.\",\n preset:\n \"Apply a compliance preset (gdpr | lgpd | pipeda | hipaa | ccpa | pci-dss | sox | ferpa).\",\n allowlist: \"String values that should never be anonymized even when detected as PII.\",\n confidenceThreshold: \"Minimum confidence score (0-1) for a match to be anonymized.\",\n },\n returns: \"AnonymizeResult { text: string; matches: PiiMatch[] }\",\n },\n tokenize: {\n description: \"Replace PII with reversible opaque tokens. Use detokenize() to restore.\",\n returns: \"TokenizeResult { text: string; mapping: Map<string, string> }\",\n },\n anonymizeObject: {\n description:\n \"Recursively anonymize all string values in a JSON-serializable object tree. \" +\n \"Deep-clones the input — no mutation. Detects circular references.\",\n returns: \"A new object of the same shape with all string PII anonymized.\",\n },\n anonymizeRecord: {\n description: \"Anonymize specific fields in a JSON object using dot-notation paths.\",\n returns: \"A new object with the specified fields anonymized.\",\n },\n batch: {\n description:\n \"anonymizeBatch / tokenizeBatch / detectBatch — process arrays of text. \" +\n \"Per-item errors are collected without aborting the rest of the batch.\",\n returns: \"BatchResult<T>[] where ok/error per item is available.\",\n },\n presets: {\n description: \"GDPR, LGPD, PIPEDA, HIPAA, CCPA, PCI-DSS, SOX, FERPA compliance presets.\",\n available: [\"gdpr\", \"lgpd\", \"pipeda\", \"hipaa\", \"ccpa\", \"pci-dss\", \"sox\", \"ferpa\"],\n },\n },\n toolDefinitions: {\n openai: [\n ANONYMIZE_TOOL_DEFINITION,\n DETECT_TOOL_DEFINITION,\n HAS_PII_TOOL_DEFINITION,\n ANONYMIZE_OBJECT_TOOL_DEFINITION,\n ],\n },\n} as const;\n\n// ---------------------------------------------------------------------------\n// Inferred TypeScript types from Zod schemas\n// ---------------------------------------------------------------------------\n\n/** A PII category accepted by {@link PiiCategorySchema}. */\nexport type PiiCategoryInput = z.infer<typeof PiiCategorySchema>;\n/** Strategy options accepted by {@link StrategyOptionsSchema}. */\nexport type StrategyOptionsInput = z.infer<typeof StrategyOptionsSchema>;\n/** Anonymization options accepted by {@link AnonymizeOptionsSchema}. */\nexport type AnonymizeOptionsInput = z.infer<typeof AnonymizeOptionsSchema>;\n/** A per-category rule accepted by {@link AnonymizationRuleSchema}. */\nexport type AnonymizationRuleInput = z.infer<typeof AnonymizationRuleSchema>;\n/** A custom pattern accepted by {@link CustomPatternSchema}. */\nexport type CustomPatternInput = z.infer<typeof CustomPatternSchema>;\n/** A detected match as validated by {@link PiiMatchSchema}. */\nexport type PiiMatchOutput = z.infer<typeof PiiMatchSchema>;\n/** An anonymization result as validated by {@link AnonymizeResultSchema}. */\nexport type AnonymizeResultOutput = z.infer<typeof AnonymizeResultSchema>;\n/** A field rule accepted by {@link FieldRuleSchema}. */\nexport type FieldRuleInput = z.infer<typeof FieldRuleSchema>;\n/** A field rule map accepted by {@link FieldRuleMapSchema}. */\nexport type FieldRuleMapInput = z.infer<typeof FieldRuleMapSchema>;\n"]}
1
+ {"version":3,"sources":["../src/schemas.ts"],"names":["z"],"mappings":";;;;;AAqCO,IAAM,iBAAA,GAAoBA,KAAE,IAAA,CAAK;AAAA,EACtC,OAAA;AAAA,EACA,OAAA;AAAA,EACA,KAAA;AAAA,EACA,aAAA;AAAA,EACA,MAAA;AAAA,EACA,MAAA;AAAA,EACA,KAAA;AAAA,EACA,MAAA;AAAA,EACA,eAAA;AAAA,EACA,MAAA;AAAA,EACA,SAAA;AAAA,EACA,UAAA;AAAA,EACA,iBAAA;AAAA,EACA,aAAA;AAAA,EACA,cAAA;AAAA,EACA,gBAAA;AAAA,EACA,QAAA;AAAA,EACA,gBAAA;AAAA,EACA,kBAAA;AAAA,EACA,cAAA;AAAA,EACA,SAAA;AAAA,EACA,cAAA;AAAA,EACA,KAAA;AAAA,EACA,eAAA;AAAA,EACA,iBAAA;AAAA,EACA,aAAA;AAAA,EACA;AACF,CAAC;AAKM,IAAM,iBAAA,GAAoBA,KAAE,MAAA,CAAO;AAAA,EACxC,QAAA,EAAUA,IAAA,CAAE,OAAA,CAAQ,MAAM,CAAA;AAAA,EAC1B,QAAA,EAAUA,IAAA,CAAE,MAAA,EAAO,CAAE,MAAA,CAAO,CAAA,EAAG,wCAAwC,CAAA,CAAE,OAAA,CAAQ,GAAG,CAAA,CAAE,QAAA,EAAS;AAAA,EAC/F,WAAA,EAAaA,IAAA,CAAE,MAAA,EAAO,CAAE,GAAA,EAAI,CAAE,WAAA,EAAY,CAAE,OAAA,CAAQ,CAAC,CAAA,CAAE,QAAA,EAAS;AAAA,EAChE,YAAA,EAAcA,IAAA,CAAE,MAAA,EAAO,CAAE,GAAA,EAAI,CAAE,WAAA,EAAY,CAAE,OAAA,CAAQ,CAAC,CAAA,CAAE,QAAA;AAC1D,CAAC;AAKM,IAAM,mBAAA,GAAsBA,KAAE,MAAA,CAAO;AAAA,EAC1C,QAAA,EAAUA,IAAA,CAAE,OAAA,CAAQ,QAAQ,CAAA;AAAA,EAC5B,KAAA,EAAOA,IAAA,CAAE,MAAA,EAAO,CAAE,GAAA,CAAI,CAAA,EAAG,yBAAyB,CAAA,CAAE,OAAA,CAAQ,YAAY,CAAA,CAAE,QAAA;AAC5E,CAAC;AAKM,IAAM,yBAAA,GAA4BA,KAAE,MAAA,CAAO;AAAA,EAChD,QAAA,EAAUA,IAAA,CAAE,OAAA,CAAQ,cAAc,CAAA;AAAA,EAClC,IAAA,EAAMA,IAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAC1B,MAAA,EAAQA,IAAA,CAAE,MAAA,EAAO,CAAE,KAAA,CAAM,OAAA,EAAS,oCAAoC,CAAA,CAAE,OAAA,CAAQ,KAAK,CAAA,CAAE,QAAA;AACzF,CAAC;AAKM,IAAM,iBAAA,GAAoBA,KAAE,MAAA,CAAO;AAAA,EACxC,QAAA,EAAUA,IAAA,CAAE,OAAA,CAAQ,MAAM,CAAA;AAAA,EAC1B,QAAA,EAAUA,IAAA,CAAE,MAAA,EAAO,CAAE,KAAI,CAAE,GAAA,CAAI,CAAC,CAAA,CAAE,IAAI,EAAE,CAAA,CAAE,OAAA,CAAQ,EAAE,EAAE,QAAA,EAAS;AAAA,EAC/D,MAAA,EAAQA,IAAA,CAAE,MAAA,EAAO,CAAE,QAAA;AACrB,CAAC;AAKM,IAAM,uBAAA,GAA0BA,KAAE,MAAA,CAAO;AAAA,EAC9C,QAAA,EAAUA,IAAA,CAAE,OAAA,CAAQ,YAAY,CAAA;AAAA,EAChC,UAAA,EAAYA,IAAA,CAAE,MAAA,EAAO,CAAE,GAAA,EAAI,CAAE,QAAA,EAAS,CAAE,OAAA,CAAQ,EAAE,CAAA,CAAE,QAAA;AACtD,CAAC;AAKM,IAAM,qBAAA,GAAwBA,IAAA,CAAE,kBAAA,CAAmB,UAAA,EAAY;AAAA,EACpE,iBAAA;AAAA,EACA,mBAAA;AAAA,EACA,yBAAA;AAAA,EACA,iBAAA;AAAA,EACA;AACF,CAAC;AASM,IAAM,cAAA,GAAiBA,KAAE,MAAA,CAAO;AAAA,EACrC,QAAA,EAAU,iBAAA;AAAA,EACV,KAAA,EAAOA,KAAE,MAAA,EAAO;AAAA,EAChB,OAAOA,IAAA,CAAE,MAAA,EAAO,CAAE,GAAA,GAAM,WAAA,EAAY;AAAA,EACpC,KAAKA,IAAA,CAAE,MAAA,EAAO,CAAE,GAAA,GAAM,QAAA,EAAS;AAAA,EAC/B,UAAA,EAAYA,KAAE,MAAA,EAAO,CAAE,IAAI,CAAC,CAAA,CAAE,IAAI,CAAC;AACrC,CAAC;AAKM,IAAM,qBAAA,GAAwBA,KAAE,MAAA,CAAO;AAAA,EAC5C,IAAA,EAAMA,KAAE,MAAA,EAAO;AAAA,EACf,OAAA,EAASA,IAAA,CAAE,KAAA,CAAM,cAAc;AACjC,CAAC;AASM,IAAM,uBAAA,GAA0BA,KAAE,MAAA,CAAO;AAAA,EAC9C,QAAA,EAAU,iBAAA;AAAA,EACV,QAAA,EAAU;AACZ,CAAC;AAKM,IAAM,mBAAA,GAAsBA,KAAE,MAAA,CAAO;AAAA,EAC1C,SAASA,IAAA,CAAE,UAAA,CAAW,QAAQ,EAAE,OAAA,EAAS,qCAAqC,CAAA;AAAA,EAC9E,UAAUA,IAAA,CAAE,MAAA,GAAS,GAAA,CAAI,CAAC,EAAE,QAAA,EAAS;AAAA,EACrC,UAAA,EAAYA,IAAA,CAAE,MAAA,EAAO,CAAE,GAAA,CAAI,CAAC,CAAA,CAAE,GAAA,CAAI,CAAC,CAAA,CAAE,QAAA,EAAS;AAAA,EAC9C,KAAA,EAAOA,KAAE,MAAA,EAAO,CAAE,IAAI,CAAA,EAAG,yBAAyB,EAAE,QAAA;AACtD,CAAC;AAKM,IAAM,sBAAA,GAAyBA,KAAE,MAAA,CAAO;AAAA,EAC7C,KAAA,EAAOA,IAAA,CAAE,KAAA,CAAM,uBAAuB,EAAE,QAAA,EAAS;AAAA,EACjD,eAAA,EAAiB,sBAAsB,QAAA,EAAS;AAAA,EAChD,gBAAgBA,IAAA,CAAE,OAAA,GAAU,OAAA,CAAQ,KAAK,EAAE,QAAA,EAAS;AAAA,EACpD,cAAA,EAAgBA,IAAA,CAAE,KAAA,CAAM,mBAAmB,EAAE,QAAA,EAAS;AAAA,EACtD,iBAAA,EAAmBA,KAAE,MAAA,EAAO,CAAE,IAAI,CAAA,EAAG,qCAAqC,EAAE,QAAA,EAAS;AAAA,EACrF,kBAAkBA,IAAA,CAAE,OAAA,GAAU,OAAA,CAAQ,KAAK,EAAE,QAAA,EAAS;AAAA,EACtD,YAAYA,IAAA,CAAE,OAAA,GAAU,OAAA,CAAQ,KAAK,EAAE,QAAA,EAAS;AAAA,EAChD,iBAAA,EAAmBA,KAAE,MAAA,CAAO,iBAAA,EAAmBA,KAAE,OAAA,EAAS,EAAE,QAAA;AAC9D,CAAC;AASM,IAAM,eAAA,GAAkBA,KAAE,MAAA,CAAO;AAAA,EACtC,QAAA,EAAU;AACZ,CAAC;AAKM,IAAM,qBAAqBA,IAAA,CAAE,MAAA,CAAOA,IAAA,CAAE,MAAA,IAAU,eAAe;AAiD/D,IAAM,yBAAA,GAAsD;AAAA,EACjE,IAAA,EAAM,WAAA;AAAA,EACN,WAAA,EACE,+JAAA;AAAA,EAEF,UAAA,EAAY;AAAA,IACV,IAAA,EAAM,QAAA;AAAA,IACN,UAAA,EAAY;AAAA,MACV,IAAA,EAAM;AAAA,QACJ,IAAA,EAAM,QAAA;AAAA,QACN,WAAA,EAAa;AAAA,OACf;AAAA,MACA,eAAA,EAAiB;AAAA,QACf,IAAA,EAAM,QAAA;AAAA,QACN,WAAA,EACE,gGAAA;AAAA,QAEF,UAAA,EAAY;AAAA,UACV,QAAA,EAAU;AAAA,YACR,IAAA,EAAM,QAAA;AAAA,YACN,MAAM,CAAC,MAAA,EAAQ,QAAA,EAAU,cAAA,EAAgB,QAAQ,YAAY;AAAA;AAC/D,SACF;AAAA,QACA,QAAA,EAAU,CAAC,UAAU;AAAA,OACvB;AAAA,MACA,cAAA,EAAgB;AAAA,QACd,IAAA,EAAM,SAAA;AAAA,QACN,WAAA,EAAa;AAAA,OACf;AAAA,MACA,iBAAA,EAAmB;AAAA,QACjB,IAAA,EAAM,QAAA;AAAA,QACN,WAAA,EACE;AAAA,OAEJ;AAAA,MACA,gBAAA,EAAkB;AAAA,QAChB,IAAA,EAAM,SAAA;AAAA,QACN,WAAA,EACE;AAAA,OAEJ;AAAA,MACA,UAAA,EAAY;AAAA,QACV,IAAA,EAAM,SAAA;AAAA,QACN,WAAA,EACE;AAAA;AAEJ,KACF;AAAA,IACA,QAAA,EAAU,CAAC,MAAM;AAAA;AAErB;AAKO,IAAM,sBAAA,GAAmD;AAAA,EAC9D,IAAA,EAAM,QAAA;AAAA,EACN,WAAA,EACE,uJAAA;AAAA,EAEF,UAAA,EAAY;AAAA,IACV,IAAA,EAAM,QAAA;AAAA,IACN,UAAA,EAAY;AAAA,MACV,IAAA,EAAM;AAAA,QACJ,IAAA,EAAM,QAAA;AAAA,QACN,WAAA,EAAa;AAAA,OACf;AAAA,MACA,UAAA,EAAY;AAAA,QACV,IAAA,EAAM,OAAA;AAAA,QACN,WAAA,EACE,oFAAA;AAAA,QACF,KAAA,EAAO;AAAA,UACL,IAAA,EAAM,QAAA;AAAA,UACN,IAAA,EAAM;AAAA,YACJ,OAAA;AAAA,YACA,OAAA;AAAA,YACA,KAAA;AAAA,YACA,aAAA;AAAA,YACA,MAAA;AAAA,YACA,MAAA;AAAA,YACA,KAAA;AAAA,YACA,MAAA;AAAA,YACA,eAAA;AAAA,YACA;AAAA;AACF;AACF;AACF,KACF;AAAA,IACA,QAAA,EAAU,CAAC,MAAM;AAAA;AAErB;AAeO,IAAM,uBAAA,GAAoD;AAAA,EAC/D,IAAA,EAAM,QAAA;AAAA,EACN,WAAA,EACE,6KAAA;AAAA,EAEF,UAAA,EAAY;AAAA,IACV,IAAA,EAAM,QAAA;AAAA,IACN,UAAA,EAAY;AAAA,MACV,IAAA,EAAM;AAAA,QACJ,IAAA,EAAM,QAAA;AAAA,QACN,WAAA,EAAa;AAAA,OACf;AAAA,MACA,UAAA,EAAY;AAAA,QACV,IAAA,EAAM,OAAA;AAAA,QACN,WAAA,EAAa,8DAAA;AAAA,QACb,KAAA,EAAO;AAAA,UACL,IAAA,EAAM,QAAA;AAAA,UACN,IAAA,EAAM;AAAA,YACJ,OAAA;AAAA,YACA,OAAA;AAAA,YACA,KAAA;AAAA,YACA,aAAA;AAAA,YACA,MAAA;AAAA,YACA,MAAA;AAAA,YACA,KAAA;AAAA,YACA,MAAA;AAAA,YACA,eAAA;AAAA,YACA;AAAA;AACF;AACF;AACF,KACF;AAAA,IACA,QAAA,EAAU,CAAC,MAAM;AAAA;AAErB;AAUO,IAAM,gCAAA,GAA6D;AAAA,EACxE,IAAA,EAAM,iBAAA;AAAA,EACN,WAAA,EACE,uOAAA;AAAA,EAGF,UAAA,EAAY;AAAA,IACV,IAAA,EAAM,QAAA;AAAA,IACN,UAAA,EAAY;AAAA,MACV,GAAA,EAAK;AAAA,QACH,IAAA,EAAM,QAAA;AAAA,QACN,WAAA,EAAa;AAAA,OACf;AAAA,MACA,OAAA,EAAS;AAAA,QACP,IAAA,EAAM,QAAA;AAAA,QACN,WAAA,EAAa,qEAAA;AAAA,QACb,UAAA,EAAY;AAAA,UACV,iBAAA,EAAmB;AAAA,YACjB,IAAA,EAAM,QAAA;AAAA,YACN,WAAA,EAAa;AAAA,WACf;AAAA,UACA,gBAAA,EAAkB;AAAA,YAChB,IAAA,EAAM,SAAA;AAAA,YACN,WAAA,EAAa;AAAA,WACf;AAAA,UACA,UAAA,EAAY;AAAA,YACV,IAAA,EAAM,SAAA;AAAA,YACN,WAAA,EAAa;AAAA;AACf;AACF;AACF,KACF;AAAA,IACA,QAAA,EAAU,CAAC,KAAK;AAAA;AAEpB;AAkBO,IAAM,gBAAA,GAAmB;AAAA,EAC9B,IAAA,EAAM,SAAA;AAAA,EACN,OAAA,EAAS,OAAA;AAAA,EACT,WAAA,EACE,udAAA;AAAA,EACF,YAAA,EAAc;AAAA,IACZ,MAAA,EAAQ;AAAA,MACN,WAAA,EAAa,+CAAA;AAAA,MACb,mBAAA,EAAqB;AAAA,QACnB,OAAA;AAAA,QACA,OAAA;AAAA,QACA,KAAA;AAAA,QACA,aAAA;AAAA,QACA,MAAA;AAAA,QACA,MAAA;AAAA,QACA,KAAA;AAAA,QACA,MAAA;AAAA,QACA,eAAA;AAAA,QACA,MAAA;AAAA,QACA,SAAA;AAAA,QACA,UAAA;AAAA,QACA,iBAAA;AAAA,QACA,aAAA;AAAA,QACA,cAAA;AAAA,QACA,gBAAA;AAAA,QACA,QAAA;AAAA,QACA,gBAAA;AAAA,QACA,kBAAA;AAAA,QACA,cAAA;AAAA,QACA,SAAA;AAAA,QACA,cAAA;AAAA,QACA,KAAA;AAAA,QACA,eAAA;AAAA,QACA,iBAAA;AAAA,QACA,aAAA;AAAA,QACA;AAAA,OACF;AAAA,MACA,KAAA,EAAO;AAAA,QACL,IAAA,EACE;AAAA,OAEJ;AAAA,MACA,OAAA,EAAS;AAAA,KACX;AAAA,IACA,MAAA,EAAQ;AAAA,MACN,WAAA,EACE,sHAAA;AAAA,MAEF,OAAA,EAAS;AAAA,KACX;AAAA,IACA,SAAA,EAAW;AAAA,MACT,WAAA,EAAa,oEAAA;AAAA,MACb,UAAA,EAAY;AAAA,QACV,IAAA,EAAM,+EAAA;AAAA,QACN,MAAA,EAAQ,2DAAA;AAAA,QACR,YAAA,EAAc,6EAAA;AAAA,QACd,IAAA,EAAM,mEAAA;AAAA,QACN,UAAA,EAAY,qEAAA;AAAA,QACZ,QAAA,EAAU,6EAAA;AAAA,QACV,OAAA,EAAS,gFAAA;AAAA,QACT,UAAA,EAAY;AAAA,OACd;AAAA,MACA,OAAA,EAAS;AAAA,QACP,iBAAA,EAAmB,iEAAA;AAAA,QACnB,gBAAA,EAAkB,0EAAA;AAAA,QAClB,UAAA,EAAY,uEAAA;AAAA,QACZ,iBAAA,EAAmB,4DAAA;AAAA,QACnB,cAAA,EAAgB,2DAAA;AAAA,QAChB,eAAA,EAAiB,sDAAA;AAAA,QACjB,MAAA,EACE,0FAAA;AAAA,QACF,SAAA,EAAW,0EAAA;AAAA,QACX,mBAAA,EAAqB;AAAA,OACvB;AAAA,MACA,OAAA,EAAS;AAAA,KACX;AAAA,IACA,QAAA,EAAU;AAAA,MACR,WAAA,EAAa,yEAAA;AAAA,MACb,OAAA,EAAS;AAAA,KACX;AAAA,IACA,eAAA,EAAiB;AAAA,MACf,WAAA,EACE,oJAAA;AAAA,MAEF,OAAA,EAAS;AAAA,KACX;AAAA,IACA,eAAA,EAAiB;AAAA,MACf,WAAA,EAAa,sEAAA;AAAA,MACb,OAAA,EAAS;AAAA,KACX;AAAA,IACA,KAAA,EAAO;AAAA,MACL,WAAA,EACE,mJAAA;AAAA,MAEF,OAAA,EAAS;AAAA,KACX;AAAA,IACA,OAAA,EAAS;AAAA,MACP,WAAA,EAAa,0EAAA;AAAA,MACb,SAAA,EAAW,CAAC,MAAA,EAAQ,MAAA,EAAQ,UAAU,OAAA,EAAS,MAAA,EAAQ,SAAA,EAAW,KAAA,EAAO,OAAO;AAAA;AAClF,GACF;AAAA,EACA,eAAA,EAAiB;AAAA,IACf,MAAA,EAAQ;AAAA,MACN,yBAAA;AAAA,MACA,sBAAA;AAAA,MACA,uBAAA;AAAA,MACA;AAAA;AACF;AAEJ","file":"schemas.cjs","sourcesContent":["/**\n * @module schemas\n * @description Optional Zod schemas and JSON Schema definitions for anonyma's\n * public API surface. Import from `\"anonyma/schemas\"`.\n *\n * These schemas enable:\n * - Runtime input validation\n * - Function-calling tool definitions (OpenAI format) and a capability manifest\n * - Automatic form generation\n *\n * The Model Context Protocol declarations and server are in `\"anonyma/mcp\"`.\n *\n * @example\n * ```ts\n * import { AnonymizeOptionsSchema, ANONYMIZE_TOOL_DEFINITION } from \"anonyma/schemas\";\n *\n * // Validate at runtime:\n * const opts = AnonymizeOptionsSchema.parse(unknownInput);\n *\n * // Offer anonymization to a model as a tool:\n * const tools = [{ type: \"function\", function: ANONYMIZE_TOOL_DEFINITION }];\n * ```\n *\n * @remarks\n * This module requires `zod` to be installed (`peerDependency`).\n * Import it only when you need runtime validation or AI schema generation.\n */\n\nimport { z } from \"zod/v3\";\n\n// ---------------------------------------------------------------------------\n// Category & strategy schemas\n// ---------------------------------------------------------------------------\n\n/**\n * Zod schema for the {@link PiiCategory} union.\n */\nexport const PiiCategorySchema = z.enum([\n \"email\",\n \"phone\",\n \"ssn\",\n \"credit-card\",\n \"ipv4\",\n \"ipv6\",\n \"url\",\n \"iban\",\n \"date-of-birth\",\n \"name\",\n \"address\",\n \"passport\",\n \"drivers-license\",\n \"national-id\",\n \"bank-account\",\n \"cryptocurrency\",\n \"tax-id\",\n \"medical-record\",\n \"health-insurance\",\n \"prescription\",\n \"api-key\",\n \"social-media\",\n \"vin\",\n \"license-plate\",\n \"tracking-number\",\n \"case-number\",\n \"company-registration\",\n]);\n\n/**\n * Zod schema for {@link MaskOptions}.\n */\nexport const MaskOptionsSchema = z.object({\n strategy: z.literal(\"mask\"),\n maskChar: z.string().length(1, \"maskChar must be exactly one character\").default(\"*\").optional(),\n keepLeading: z.number().int().nonnegative().default(0).optional(),\n keepTrailing: z.number().int().nonnegative().default(0).optional(),\n});\n\n/**\n * Zod schema for {@link RedactOptions}.\n */\nexport const RedactOptionsSchema = z.object({\n strategy: z.literal(\"redact\"),\n label: z.string().min(1, \"label must not be empty\").default(\"[REDACTED]\").optional(),\n});\n\n/**\n * Zod schema for {@link PseudonymizeOptions}.\n */\nexport const PseudonymizeOptionsSchema = z.object({\n strategy: z.literal(\"pseudonymize\"),\n seed: z.string().optional(),\n prefix: z.string().regex(/^\\S+$/, \"prefix must not contain whitespace\").default(\"id_\").optional(),\n});\n\n/**\n * Zod schema for {@link HashOptions}.\n */\nexport const HashOptionsSchema = z.object({\n strategy: z.literal(\"hash\"),\n truncate: z.number().int().min(1).max(64).default(16).optional(),\n pepper: z.string().optional(),\n});\n\n/**\n * Zod schema for {@link GeneralizeOptions}.\n */\nexport const GeneralizeOptionsSchema = z.object({\n strategy: z.literal(\"generalize\"),\n bucketSize: z.number().int().positive().default(10).optional(),\n});\n\n/**\n * Discriminated union schema for {@link StrategyOptions}.\n */\nexport const StrategyOptionsSchema = z.discriminatedUnion(\"strategy\", [\n MaskOptionsSchema,\n RedactOptionsSchema,\n PseudonymizeOptionsSchema,\n HashOptionsSchema,\n GeneralizeOptionsSchema,\n]);\n\n// ---------------------------------------------------------------------------\n// Match & result schemas\n// ---------------------------------------------------------------------------\n\n/**\n * Zod schema for {@link PiiMatch}.\n */\nexport const PiiMatchSchema = z.object({\n category: PiiCategorySchema,\n value: z.string(),\n start: z.number().int().nonnegative(),\n end: z.number().int().positive(),\n confidence: z.number().min(0).max(1),\n});\n\n/**\n * Zod schema for {@link AnonymizeResult}.\n */\nexport const AnonymizeResultSchema = z.object({\n text: z.string(),\n matches: z.array(PiiMatchSchema),\n});\n\n// ---------------------------------------------------------------------------\n// Anonymize options schema\n// ---------------------------------------------------------------------------\n\n/**\n * Zod schema for a single {@link AnonymizationRule}.\n */\nexport const AnonymizationRuleSchema = z.object({\n category: PiiCategorySchema,\n strategy: StrategyOptionsSchema,\n});\n\n/**\n * Zod schema for a {@link CustomPattern}.\n */\nexport const CustomPatternSchema = z.object({\n pattern: z.instanceof(RegExp, { message: \"pattern must be a RegExp instance\" }),\n category: z.string().min(1).optional(),\n confidence: z.number().min(0).max(1).optional(),\n label: z.string().min(1, \"label must not be empty\").optional(),\n});\n\n/**\n * Zod schema for {@link AnonymizeOptions}.\n */\nexport const AnonymizeOptionsSchema = z.object({\n rules: z.array(AnonymizationRuleSchema).optional(),\n defaultStrategy: StrategyOptionsSchema.optional(),\n includeMatches: z.boolean().default(false).optional(),\n customPatterns: z.array(CustomPatternSchema).optional(),\n globalReplacement: z.string().min(1, \"globalReplacement must not be empty\").optional(),\n consistentTokens: z.boolean().default(false).optional(),\n aggressive: z.boolean().default(false).optional(),\n enabledCategories: z.record(PiiCategorySchema, z.boolean()).optional(),\n});\n\n// ---------------------------------------------------------------------------\n// Field-level anonymization schema\n// ---------------------------------------------------------------------------\n\n/**\n * Zod schema for a single field rule.\n */\nexport const FieldRuleSchema = z.object({\n strategy: StrategyOptionsSchema,\n});\n\n/**\n * Zod schema for a {@link FieldRuleMap}.\n */\nexport const FieldRuleMapSchema = z.record(z.string(), FieldRuleSchema);\n\n// ---------------------------------------------------------------------------\n// JSON Schema / OpenAI function-calling definitions\n// ---------------------------------------------------------------------------\n\n/**\n * A minimal JSON Schema representation extracted from a Zod schema.\n * Suitable for use in OpenAI function definitions, MCP tool definitions, etc.\n */\nexport interface JsonSchemaDefinition {\n readonly type: string;\n readonly description?: string;\n readonly properties?: Record<string, JsonSchemaDefinition>;\n readonly items?: JsonSchemaDefinition;\n readonly enum?: readonly string[];\n readonly required?: readonly string[];\n readonly anyOf?: readonly JsonSchemaDefinition[];\n readonly default?: unknown;\n}\n\n/**\n * OpenAI-compatible function definition shape.\n */\nexport interface OpenAiFunctionDefinition {\n readonly name: string;\n readonly description: string;\n readonly parameters: {\n readonly type: \"object\";\n readonly properties: Record<string, JsonSchemaDefinition>;\n readonly required?: readonly string[];\n };\n}\n\n/**\n * Pre-built OpenAI / MCP tool definition for the `anonymize` function.\n *\n * @example\n * ```ts\n * import { ANONYMIZE_TOOL_DEFINITION } from \"anonyma/schemas\";\n *\n * // Pass directly to OpenAI client tools array:\n * const response = await openai.chat.completions.create({\n * model: \"gpt-4o\",\n * tools: [{ type: \"function\", function: ANONYMIZE_TOOL_DEFINITION }],\n * messages: [...],\n * });\n * ```\n */\nexport const ANONYMIZE_TOOL_DEFINITION: OpenAiFunctionDefinition = {\n name: \"anonymize\",\n description:\n \"Detect and anonymize PII (personally identifiable information) in a text string. \" +\n \"Returns the anonymized text and, optionally, a list of detected PII matches.\",\n parameters: {\n type: \"object\",\n properties: {\n text: {\n type: \"string\",\n description: \"The input text to anonymize.\",\n },\n defaultStrategy: {\n type: \"object\",\n description:\n \"The anonymization strategy to apply to all detected PII. \" +\n \"Defaults to `{ strategy: 'redact' }`.\",\n properties: {\n strategy: {\n type: \"string\",\n enum: [\"mask\", \"redact\", \"pseudonymize\", \"hash\", \"generalize\"] as const,\n },\n },\n required: [\"strategy\"],\n },\n includeMatches: {\n type: \"boolean\",\n description: \"When true, include detected PII matches in the response.\",\n },\n globalReplacement: {\n type: \"string\",\n description:\n \"When set, every detected PII entity is replaced with this exact string, \" +\n \"overriding per-category rules and defaultStrategy.\",\n },\n consistentTokens: {\n type: \"boolean\",\n description:\n \"When true, identical PII values receive the same token (e.g. EMAIL_1) \" +\n \"across the entire call. Different values get different tokens.\",\n },\n aggressive: {\n type: \"boolean\",\n description:\n \"When true, detectors use expanded, more permissive patterns to catch \" +\n \"obfuscated PII at the cost of higher false-positive rates.\",\n },\n },\n required: [\"text\"],\n },\n};\n\n/**\n * Pre-built OpenAI / MCP tool definition for the `detect` function.\n */\nexport const DETECT_TOOL_DEFINITION: OpenAiFunctionDefinition = {\n name: \"detect\",\n description:\n \"Detect all PII (email, phone, SSN, credit card, IP, URL, IBAN, date-of-birth, name) \" +\n \"in a text string without modifying it. Returns a list of matches.\",\n parameters: {\n type: \"object\",\n properties: {\n text: {\n type: \"string\",\n description: \"The input text to scan for PII.\",\n },\n categories: {\n type: \"array\",\n description:\n \"Optional subset of PII categories to detect. \" + \"Defaults to all supported categories.\",\n items: {\n type: \"string\",\n enum: [\n \"email\",\n \"phone\",\n \"ssn\",\n \"credit-card\",\n \"ipv4\",\n \"ipv6\",\n \"url\",\n \"iban\",\n \"date-of-birth\",\n \"name\",\n ] as const,\n },\n },\n },\n required: [\"text\"],\n },\n};\n\n/**\n * Pre-built OpenAI / MCP tool definition for the `hasPII` function.\n *\n * @example\n * ```ts\n * import { HAS_PII_TOOL_DEFINITION } from \"anonyma/schemas\";\n *\n * const response = await openai.chat.completions.create({\n * tools: [{ type: \"function\", function: HAS_PII_TOOL_DEFINITION }],\n * messages: [...],\n * });\n * ```\n */\nexport const HAS_PII_TOOL_DEFINITION: OpenAiFunctionDefinition = {\n name: \"hasPII\",\n description:\n \"Check whether a text string contains any detectable PII without redacting it. \" +\n \"Returns true/false. Uses early-exit optimisation — stops scanning after the first match.\",\n parameters: {\n type: \"object\",\n properties: {\n text: {\n type: \"string\",\n description: \"The input text to check for PII.\",\n },\n categories: {\n type: \"array\",\n description: \"Optional subset of PII categories to check. Defaults to all.\",\n items: {\n type: \"string\",\n enum: [\n \"email\",\n \"phone\",\n \"ssn\",\n \"credit-card\",\n \"ipv4\",\n \"ipv6\",\n \"url\",\n \"iban\",\n \"date-of-birth\",\n \"name\",\n ] as const,\n },\n },\n },\n required: [\"text\"],\n },\n};\n\n/**\n * Pre-built OpenAI / MCP tool definition for the `anonymizeObject` function.\n *\n * @example\n * ```ts\n * import { ANONYMIZE_OBJECT_TOOL_DEFINITION } from \"anonyma/schemas\";\n * ```\n */\nexport const ANONYMIZE_OBJECT_TOOL_DEFINITION: OpenAiFunctionDefinition = {\n name: \"anonymizeObject\",\n description:\n \"Recursively anonymize all string values found in a JSON-serializable object tree. \" +\n \"Returns a deep clone with PII replaced. Arrays, nested objects, and mixed structures \" +\n \"are all handled. Non-string primitives pass through unchanged.\",\n parameters: {\n type: \"object\",\n properties: {\n obj: {\n type: \"object\",\n description: \"The JSON-serializable object to anonymize.\",\n },\n options: {\n type: \"object\",\n description: \"Optional anonymization configuration (same as anonymize() options).\",\n properties: {\n globalReplacement: {\n type: \"string\",\n description: \"Replace all PII with this exact string.\",\n },\n consistentTokens: {\n type: \"boolean\",\n description: \"Same PII value → same token across the entire object.\",\n },\n aggressive: {\n type: \"boolean\",\n description: \"Enable more permissive detection patterns.\",\n },\n },\n },\n },\n required: [\"obj\"],\n },\n};\n\n// ---------------------------------------------------------------------------\n// AI-readable capability manifest\n// ---------------------------------------------------------------------------\n\n/**\n * Machine-readable manifest describing anonyma's capabilities.\n * Useful for AI agents that need to discover and reason about available tools.\n *\n * @example\n * ```ts\n * import { ANONYMA_MANIFEST } from \"anonyma/schemas\";\n *\n * // Provide to an AI agent as system context:\n * const systemPrompt = `You have access to the following data privacy tool:\\n\\n${JSON.stringify(ANONYMA_MANIFEST, null, 2)}`;\n * ```\n */\nexport const ANONYMA_MANIFEST = {\n name: \"anonyma\",\n version: \"1.2.0\",\n description:\n \"TypeScript-first PII detection & anonymization — 27 built-in detectors (email, SSN, IBAN, passport, credit card, and more), 8 strategies (mask, redact, hash, AES-256 encrypt, tokenize, pseudonymize, generalize, synthesize), 8 compliance presets (GDPR, LGPD, PIPEDA, HIPAA, CCPA, PCI-DSS, SOX, FERPA), reversible tokenization, LLM/AI pipeline helpers, WHATWG streaming, batch processing, checksum validators, and optional Zod/MCP schemas. Zero runtime dependencies.\",\n capabilities: {\n detect: {\n description: \"Detect PII in free text without modifying it.\",\n supportedCategories: [\n \"email\",\n \"phone\",\n \"ssn\",\n \"credit-card\",\n \"ipv4\",\n \"ipv6\",\n \"url\",\n \"iban\",\n \"date-of-birth\",\n \"name\",\n \"address\",\n \"passport\",\n \"drivers-license\",\n \"national-id\",\n \"bank-account\",\n \"cryptocurrency\",\n \"tax-id\",\n \"medical-record\",\n \"health-insurance\",\n \"prescription\",\n \"api-key\",\n \"social-media\",\n \"vin\",\n \"license-plate\",\n \"tracking-number\",\n \"case-number\",\n \"company-registration\",\n ],\n notes: {\n name:\n \"Name detection is heuristic — only catches names preceded by greeting keywords \" +\n \"(e.g. 'Dear Alice'). Not an NLP-based named-entity recogniser.\",\n },\n returns: \"Array of PiiMatch objects with category, value, position, and confidence.\",\n },\n hasPII: {\n description:\n \"Return true/false indicating whether a string contains detectable PII. \" +\n \"Uses early-exit optimisation for performance.\",\n returns: \"boolean\",\n },\n anonymize: {\n description: \"Detect and replace PII in free text using a configurable strategy.\",\n strategies: {\n mask: \"Replace characters with a mask char, keeping optional leading/trailing chars.\",\n redact: \"Replace the entire value with a label such as [REDACTED].\",\n pseudonymize: \"Replace with a deterministic pseudonym (requires seed for reproducibility).\",\n hash: \"Replace with a one-way SHA-256 hash (requires Node.js ≥ 18).\",\n generalize: \"Replace a numeric value with a bucket range (e.g. 27 → 20-29).\",\n tokenize: \"Replace with a reversible opaque token ([CATEGORY_NNNN]) for LLM pipelines.\",\n encrypt: \"Replace with AES-GCM ciphertext (requires Node.js ≥ 18 + passphrase/key).\",\n synthesize: \"Replace with structurally-valid synthetic data (format-preserving).\",\n },\n options: {\n globalReplacement: \"Override ALL strategy outputs with a single replacement string.\",\n consistentTokens: \"Same PII value → same token (EMAIL_1, PHONE_2, etc.) within a call.\",\n aggressive: \"Use expanded, more permissive regex patterns to catch obfuscated PII.\",\n enabledCategories: \"Convenience boolean map for enabling/disabling categories.\",\n customPatterns: \"Ad-hoc regex patterns merged into the detection pipeline.\",\n customDetectors: \"Override built-in detectors on a per-category basis.\",\n preset:\n \"Apply a compliance preset (gdpr | lgpd | pipeda | hipaa | ccpa | pci-dss | sox | ferpa).\",\n allowlist: \"String values that should never be anonymized even when detected as PII.\",\n confidenceThreshold: \"Minimum confidence score (0-1) for a match to be anonymized.\",\n },\n returns: \"AnonymizeResult { text: string; matches: PiiMatch[] }\",\n },\n tokenize: {\n description: \"Replace PII with reversible opaque tokens. Use detokenize() to restore.\",\n returns: \"TokenizeResult { text: string; mapping: Map<string, string> }\",\n },\n anonymizeObject: {\n description:\n \"Recursively anonymize all string values in a JSON-serializable object tree. \" +\n \"Deep-clones the input — no mutation. Detects circular references.\",\n returns: \"A new object of the same shape with all string PII anonymized.\",\n },\n anonymizeRecord: {\n description: \"Anonymize specific fields in a JSON object using dot-notation paths.\",\n returns: \"A new object with the specified fields anonymized.\",\n },\n batch: {\n description:\n \"anonymizeBatch / tokenizeBatch / detectBatch — process arrays of text. \" +\n \"Per-item errors are collected without aborting the rest of the batch.\",\n returns: \"BatchResult<T>[] where ok/error per item is available.\",\n },\n presets: {\n description: \"GDPR, LGPD, PIPEDA, HIPAA, CCPA, PCI-DSS, SOX, FERPA compliance presets.\",\n available: [\"gdpr\", \"lgpd\", \"pipeda\", \"hipaa\", \"ccpa\", \"pci-dss\", \"sox\", \"ferpa\"],\n },\n },\n toolDefinitions: {\n openai: [\n ANONYMIZE_TOOL_DEFINITION,\n DETECT_TOOL_DEFINITION,\n HAS_PII_TOOL_DEFINITION,\n ANONYMIZE_OBJECT_TOOL_DEFINITION,\n ],\n },\n} as const;\n\n// ---------------------------------------------------------------------------\n// Inferred TypeScript types from Zod schemas\n// ---------------------------------------------------------------------------\n\n/** A PII category accepted by {@link PiiCategorySchema}. */\nexport type PiiCategoryInput = z.infer<typeof PiiCategorySchema>;\n/** Strategy options accepted by {@link StrategyOptionsSchema}. */\nexport type StrategyOptionsInput = z.infer<typeof StrategyOptionsSchema>;\n/** Anonymization options accepted by {@link AnonymizeOptionsSchema}. */\nexport type AnonymizeOptionsInput = z.infer<typeof AnonymizeOptionsSchema>;\n/** A per-category rule accepted by {@link AnonymizationRuleSchema}. */\nexport type AnonymizationRuleInput = z.infer<typeof AnonymizationRuleSchema>;\n/** A custom pattern accepted by {@link CustomPatternSchema}. */\nexport type CustomPatternInput = z.infer<typeof CustomPatternSchema>;\n/** A detected match as validated by {@link PiiMatchSchema}. */\nexport type PiiMatchOutput = z.infer<typeof PiiMatchSchema>;\n/** An anonymization result as validated by {@link AnonymizeResultSchema}. */\nexport type AnonymizeResultOutput = z.infer<typeof AnonymizeResultSchema>;\n/** A field rule accepted by {@link FieldRuleSchema}. */\nexport type FieldRuleInput = z.infer<typeof FieldRuleSchema>;\n/** A field rule map accepted by {@link FieldRuleMapSchema}. */\nexport type FieldRuleMapInput = z.infer<typeof FieldRuleMapSchema>;\n"]}
@@ -1,4 +1,4 @@
1
- import { z } from 'zod';
1
+ import { z } from 'zod/v3';
2
2
 
3
3
  /**
4
4
  * @module schemas
@@ -954,7 +954,7 @@ declare const ANONYMIZE_OBJECT_TOOL_DEFINITION: OpenAiFunctionDefinition;
954
954
  */
955
955
  declare const ANONYMA_MANIFEST: {
956
956
  readonly name: "anonyma";
957
- readonly version: "1.1.1";
957
+ readonly version: "1.2.0";
958
958
  readonly description: "TypeScript-first PII detection & anonymization — 27 built-in detectors (email, SSN, IBAN, passport, credit card, and more), 8 strategies (mask, redact, hash, AES-256 encrypt, tokenize, pseudonymize, generalize, synthesize), 8 compliance presets (GDPR, LGPD, PIPEDA, HIPAA, CCPA, PCI-DSS, SOX, FERPA), reversible tokenization, LLM/AI pipeline helpers, WHATWG streaming, batch processing, checksum validators, and optional Zod/MCP schemas. Zero runtime dependencies.";
959
959
  readonly capabilities: {
960
960
  readonly detect: {
package/dist/schemas.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- import { z } from 'zod';
1
+ import { z } from 'zod/v3';
2
2
 
3
3
  /**
4
4
  * @module schemas
@@ -954,7 +954,7 @@ declare const ANONYMIZE_OBJECT_TOOL_DEFINITION: OpenAiFunctionDefinition;
954
954
  */
955
955
  declare const ANONYMA_MANIFEST: {
956
956
  readonly name: "anonyma";
957
- readonly version: "1.1.1";
957
+ readonly version: "1.2.0";
958
958
  readonly description: "TypeScript-first PII detection & anonymization — 27 built-in detectors (email, SSN, IBAN, passport, credit card, and more), 8 strategies (mask, redact, hash, AES-256 encrypt, tokenize, pseudonymize, generalize, synthesize), 8 compliance presets (GDPR, LGPD, PIPEDA, HIPAA, CCPA, PCI-DSS, SOX, FERPA), reversible tokenization, LLM/AI pipeline helpers, WHATWG streaming, batch processing, checksum validators, and optional Zod/MCP schemas. Zero runtime dependencies.";
959
959
  readonly capabilities: {
960
960
  readonly detect: {
package/dist/schemas.js CHANGED
@@ -1,4 +1,4 @@
1
- import { z } from 'zod';
1
+ import { z } from 'zod/v3';
2
2
 
3
3
  // src/schemas.ts
4
4
  var PiiCategorySchema = z.enum([
@@ -237,7 +237,7 @@ var ANONYMIZE_OBJECT_TOOL_DEFINITION = {
237
237
  };
238
238
  var ANONYMA_MANIFEST = {
239
239
  name: "anonyma",
240
- version: "1.1.1",
240
+ version: "1.2.0",
241
241
  description: "TypeScript-first PII detection & anonymization \u2014 27 built-in detectors (email, SSN, IBAN, passport, credit card, and more), 8 strategies (mask, redact, hash, AES-256 encrypt, tokenize, pseudonymize, generalize, synthesize), 8 compliance presets (GDPR, LGPD, PIPEDA, HIPAA, CCPA, PCI-DSS, SOX, FERPA), reversible tokenization, LLM/AI pipeline helpers, WHATWG streaming, batch processing, checksum validators, and optional Zod/MCP schemas. Zero runtime dependencies.",
242
242
  capabilities: {
243
243
  detect: {
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/schemas.ts"],"names":[],"mappings":"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","file":"schemas.js","sourcesContent":["/**\n * @module schemas\n * @description Optional Zod schemas and JSON Schema definitions for anonyma's\n * public API surface. Import from `\"anonyma/schemas\"`.\n *\n * These schemas enable:\n * - Runtime input validation\n * - Function-calling tool definitions (OpenAI format) and a capability manifest\n * - Automatic form generation\n *\n * The Model Context Protocol declarations and server are in `\"anonyma/mcp\"`.\n *\n * @example\n * ```ts\n * import { AnonymizeOptionsSchema, ANONYMIZE_TOOL_DEFINITION } from \"anonyma/schemas\";\n *\n * // Validate at runtime:\n * const opts = AnonymizeOptionsSchema.parse(unknownInput);\n *\n * // Offer anonymization to a model as a tool:\n * const tools = [{ type: \"function\", function: ANONYMIZE_TOOL_DEFINITION }];\n * ```\n *\n * @remarks\n * This module requires `zod` to be installed (`peerDependency`).\n * Import it only when you need runtime validation or AI schema generation.\n */\n\nimport { z } from \"zod\";\n\n// ---------------------------------------------------------------------------\n// Category & strategy schemas\n// ---------------------------------------------------------------------------\n\n/**\n * Zod schema for the {@link PiiCategory} union.\n */\nexport const PiiCategorySchema = z.enum([\n \"email\",\n \"phone\",\n \"ssn\",\n \"credit-card\",\n \"ipv4\",\n \"ipv6\",\n \"url\",\n \"iban\",\n \"date-of-birth\",\n \"name\",\n \"address\",\n \"passport\",\n \"drivers-license\",\n \"national-id\",\n \"bank-account\",\n \"cryptocurrency\",\n \"tax-id\",\n \"medical-record\",\n \"health-insurance\",\n \"prescription\",\n \"api-key\",\n \"social-media\",\n \"vin\",\n \"license-plate\",\n \"tracking-number\",\n \"case-number\",\n \"company-registration\",\n]);\n\n/**\n * Zod schema for {@link MaskOptions}.\n */\nexport const MaskOptionsSchema = z.object({\n strategy: z.literal(\"mask\"),\n maskChar: z.string().length(1, \"maskChar must be exactly one character\").default(\"*\").optional(),\n keepLeading: z.number().int().nonnegative().default(0).optional(),\n keepTrailing: z.number().int().nonnegative().default(0).optional(),\n});\n\n/**\n * Zod schema for {@link RedactOptions}.\n */\nexport const RedactOptionsSchema = z.object({\n strategy: z.literal(\"redact\"),\n label: z.string().min(1, \"label must not be empty\").default(\"[REDACTED]\").optional(),\n});\n\n/**\n * Zod schema for {@link PseudonymizeOptions}.\n */\nexport const PseudonymizeOptionsSchema = z.object({\n strategy: z.literal(\"pseudonymize\"),\n seed: z.string().optional(),\n prefix: z.string().regex(/^\\S+$/, \"prefix must not contain whitespace\").default(\"id_\").optional(),\n});\n\n/**\n * Zod schema for {@link HashOptions}.\n */\nexport const HashOptionsSchema = z.object({\n strategy: z.literal(\"hash\"),\n truncate: z.number().int().min(1).max(64).default(16).optional(),\n pepper: z.string().optional(),\n});\n\n/**\n * Zod schema for {@link GeneralizeOptions}.\n */\nexport const GeneralizeOptionsSchema = z.object({\n strategy: z.literal(\"generalize\"),\n bucketSize: z.number().int().positive().default(10).optional(),\n});\n\n/**\n * Discriminated union schema for {@link StrategyOptions}.\n */\nexport const StrategyOptionsSchema = z.discriminatedUnion(\"strategy\", [\n MaskOptionsSchema,\n RedactOptionsSchema,\n PseudonymizeOptionsSchema,\n HashOptionsSchema,\n GeneralizeOptionsSchema,\n]);\n\n// ---------------------------------------------------------------------------\n// Match & result schemas\n// ---------------------------------------------------------------------------\n\n/**\n * Zod schema for {@link PiiMatch}.\n */\nexport const PiiMatchSchema = z.object({\n category: PiiCategorySchema,\n value: z.string(),\n start: z.number().int().nonnegative(),\n end: z.number().int().positive(),\n confidence: z.number().min(0).max(1),\n});\n\n/**\n * Zod schema for {@link AnonymizeResult}.\n */\nexport const AnonymizeResultSchema = z.object({\n text: z.string(),\n matches: z.array(PiiMatchSchema),\n});\n\n// ---------------------------------------------------------------------------\n// Anonymize options schema\n// ---------------------------------------------------------------------------\n\n/**\n * Zod schema for a single {@link AnonymizationRule}.\n */\nexport const AnonymizationRuleSchema = z.object({\n category: PiiCategorySchema,\n strategy: StrategyOptionsSchema,\n});\n\n/**\n * Zod schema for a {@link CustomPattern}.\n */\nexport const CustomPatternSchema = z.object({\n pattern: z.instanceof(RegExp, { message: \"pattern must be a RegExp instance\" }),\n category: z.string().min(1).optional(),\n confidence: z.number().min(0).max(1).optional(),\n label: z.string().min(1, \"label must not be empty\").optional(),\n});\n\n/**\n * Zod schema for {@link AnonymizeOptions}.\n */\nexport const AnonymizeOptionsSchema = z.object({\n rules: z.array(AnonymizationRuleSchema).optional(),\n defaultStrategy: StrategyOptionsSchema.optional(),\n includeMatches: z.boolean().default(false).optional(),\n customPatterns: z.array(CustomPatternSchema).optional(),\n globalReplacement: z.string().min(1, \"globalReplacement must not be empty\").optional(),\n consistentTokens: z.boolean().default(false).optional(),\n aggressive: z.boolean().default(false).optional(),\n enabledCategories: z.record(PiiCategorySchema, z.boolean()).optional(),\n});\n\n// ---------------------------------------------------------------------------\n// Field-level anonymization schema\n// ---------------------------------------------------------------------------\n\n/**\n * Zod schema for a single field rule.\n */\nexport const FieldRuleSchema = z.object({\n strategy: StrategyOptionsSchema,\n});\n\n/**\n * Zod schema for a {@link FieldRuleMap}.\n */\nexport const FieldRuleMapSchema = z.record(z.string(), FieldRuleSchema);\n\n// ---------------------------------------------------------------------------\n// JSON Schema / OpenAI function-calling definitions\n// ---------------------------------------------------------------------------\n\n/**\n * A minimal JSON Schema representation extracted from a Zod schema.\n * Suitable for use in OpenAI function definitions, MCP tool definitions, etc.\n */\nexport interface JsonSchemaDefinition {\n readonly type: string;\n readonly description?: string;\n readonly properties?: Record<string, JsonSchemaDefinition>;\n readonly items?: JsonSchemaDefinition;\n readonly enum?: readonly string[];\n readonly required?: readonly string[];\n readonly anyOf?: readonly JsonSchemaDefinition[];\n readonly default?: unknown;\n}\n\n/**\n * OpenAI-compatible function definition shape.\n */\nexport interface OpenAiFunctionDefinition {\n readonly name: string;\n readonly description: string;\n readonly parameters: {\n readonly type: \"object\";\n readonly properties: Record<string, JsonSchemaDefinition>;\n readonly required?: readonly string[];\n };\n}\n\n/**\n * Pre-built OpenAI / MCP tool definition for the `anonymize` function.\n *\n * @example\n * ```ts\n * import { ANONYMIZE_TOOL_DEFINITION } from \"anonyma/schemas\";\n *\n * // Pass directly to OpenAI client tools array:\n * const response = await openai.chat.completions.create({\n * model: \"gpt-4o\",\n * tools: [{ type: \"function\", function: ANONYMIZE_TOOL_DEFINITION }],\n * messages: [...],\n * });\n * ```\n */\nexport const ANONYMIZE_TOOL_DEFINITION: OpenAiFunctionDefinition = {\n name: \"anonymize\",\n description:\n \"Detect and anonymize PII (personally identifiable information) in a text string. \" +\n \"Returns the anonymized text and, optionally, a list of detected PII matches.\",\n parameters: {\n type: \"object\",\n properties: {\n text: {\n type: \"string\",\n description: \"The input text to anonymize.\",\n },\n defaultStrategy: {\n type: \"object\",\n description:\n \"The anonymization strategy to apply to all detected PII. \" +\n \"Defaults to `{ strategy: 'redact' }`.\",\n properties: {\n strategy: {\n type: \"string\",\n enum: [\"mask\", \"redact\", \"pseudonymize\", \"hash\", \"generalize\"] as const,\n },\n },\n required: [\"strategy\"],\n },\n includeMatches: {\n type: \"boolean\",\n description: \"When true, include detected PII matches in the response.\",\n },\n globalReplacement: {\n type: \"string\",\n description:\n \"When set, every detected PII entity is replaced with this exact string, \" +\n \"overriding per-category rules and defaultStrategy.\",\n },\n consistentTokens: {\n type: \"boolean\",\n description:\n \"When true, identical PII values receive the same token (e.g. EMAIL_1) \" +\n \"across the entire call. Different values get different tokens.\",\n },\n aggressive: {\n type: \"boolean\",\n description:\n \"When true, detectors use expanded, more permissive patterns to catch \" +\n \"obfuscated PII at the cost of higher false-positive rates.\",\n },\n },\n required: [\"text\"],\n },\n};\n\n/**\n * Pre-built OpenAI / MCP tool definition for the `detect` function.\n */\nexport const DETECT_TOOL_DEFINITION: OpenAiFunctionDefinition = {\n name: \"detect\",\n description:\n \"Detect all PII (email, phone, SSN, credit card, IP, URL, IBAN, date-of-birth, name) \" +\n \"in a text string without modifying it. Returns a list of matches.\",\n parameters: {\n type: \"object\",\n properties: {\n text: {\n type: \"string\",\n description: \"The input text to scan for PII.\",\n },\n categories: {\n type: \"array\",\n description:\n \"Optional subset of PII categories to detect. \" + \"Defaults to all supported categories.\",\n items: {\n type: \"string\",\n enum: [\n \"email\",\n \"phone\",\n \"ssn\",\n \"credit-card\",\n \"ipv4\",\n \"ipv6\",\n \"url\",\n \"iban\",\n \"date-of-birth\",\n \"name\",\n ] as const,\n },\n },\n },\n required: [\"text\"],\n },\n};\n\n/**\n * Pre-built OpenAI / MCP tool definition for the `hasPII` function.\n *\n * @example\n * ```ts\n * import { HAS_PII_TOOL_DEFINITION } from \"anonyma/schemas\";\n *\n * const response = await openai.chat.completions.create({\n * tools: [{ type: \"function\", function: HAS_PII_TOOL_DEFINITION }],\n * messages: [...],\n * });\n * ```\n */\nexport const HAS_PII_TOOL_DEFINITION: OpenAiFunctionDefinition = {\n name: \"hasPII\",\n description:\n \"Check whether a text string contains any detectable PII without redacting it. \" +\n \"Returns true/false. Uses early-exit optimisation — stops scanning after the first match.\",\n parameters: {\n type: \"object\",\n properties: {\n text: {\n type: \"string\",\n description: \"The input text to check for PII.\",\n },\n categories: {\n type: \"array\",\n description: \"Optional subset of PII categories to check. Defaults to all.\",\n items: {\n type: \"string\",\n enum: [\n \"email\",\n \"phone\",\n \"ssn\",\n \"credit-card\",\n \"ipv4\",\n \"ipv6\",\n \"url\",\n \"iban\",\n \"date-of-birth\",\n \"name\",\n ] as const,\n },\n },\n },\n required: [\"text\"],\n },\n};\n\n/**\n * Pre-built OpenAI / MCP tool definition for the `anonymizeObject` function.\n *\n * @example\n * ```ts\n * import { ANONYMIZE_OBJECT_TOOL_DEFINITION } from \"anonyma/schemas\";\n * ```\n */\nexport const ANONYMIZE_OBJECT_TOOL_DEFINITION: OpenAiFunctionDefinition = {\n name: \"anonymizeObject\",\n description:\n \"Recursively anonymize all string values found in a JSON-serializable object tree. \" +\n \"Returns a deep clone with PII replaced. Arrays, nested objects, and mixed structures \" +\n \"are all handled. Non-string primitives pass through unchanged.\",\n parameters: {\n type: \"object\",\n properties: {\n obj: {\n type: \"object\",\n description: \"The JSON-serializable object to anonymize.\",\n },\n options: {\n type: \"object\",\n description: \"Optional anonymization configuration (same as anonymize() options).\",\n properties: {\n globalReplacement: {\n type: \"string\",\n description: \"Replace all PII with this exact string.\",\n },\n consistentTokens: {\n type: \"boolean\",\n description: \"Same PII value → same token across the entire object.\",\n },\n aggressive: {\n type: \"boolean\",\n description: \"Enable more permissive detection patterns.\",\n },\n },\n },\n },\n required: [\"obj\"],\n },\n};\n\n// ---------------------------------------------------------------------------\n// AI-readable capability manifest\n// ---------------------------------------------------------------------------\n\n/**\n * Machine-readable manifest describing anonyma's capabilities.\n * Useful for AI agents that need to discover and reason about available tools.\n *\n * @example\n * ```ts\n * import { ANONYMA_MANIFEST } from \"anonyma/schemas\";\n *\n * // Provide to an AI agent as system context:\n * const systemPrompt = `You have access to the following data privacy tool:\\n\\n${JSON.stringify(ANONYMA_MANIFEST, null, 2)}`;\n * ```\n */\nexport const ANONYMA_MANIFEST = {\n name: \"anonyma\",\n version: \"1.1.1\",\n description:\n \"TypeScript-first PII detection & anonymization — 27 built-in detectors (email, SSN, IBAN, passport, credit card, and more), 8 strategies (mask, redact, hash, AES-256 encrypt, tokenize, pseudonymize, generalize, synthesize), 8 compliance presets (GDPR, LGPD, PIPEDA, HIPAA, CCPA, PCI-DSS, SOX, FERPA), reversible tokenization, LLM/AI pipeline helpers, WHATWG streaming, batch processing, checksum validators, and optional Zod/MCP schemas. Zero runtime dependencies.\",\n capabilities: {\n detect: {\n description: \"Detect PII in free text without modifying it.\",\n supportedCategories: [\n \"email\",\n \"phone\",\n \"ssn\",\n \"credit-card\",\n \"ipv4\",\n \"ipv6\",\n \"url\",\n \"iban\",\n \"date-of-birth\",\n \"name\",\n \"address\",\n \"passport\",\n \"drivers-license\",\n \"national-id\",\n \"bank-account\",\n \"cryptocurrency\",\n \"tax-id\",\n \"medical-record\",\n \"health-insurance\",\n \"prescription\",\n \"api-key\",\n \"social-media\",\n \"vin\",\n \"license-plate\",\n \"tracking-number\",\n \"case-number\",\n \"company-registration\",\n ],\n notes: {\n name:\n \"Name detection is heuristic — only catches names preceded by greeting keywords \" +\n \"(e.g. 'Dear Alice'). Not an NLP-based named-entity recogniser.\",\n },\n returns: \"Array of PiiMatch objects with category, value, position, and confidence.\",\n },\n hasPII: {\n description:\n \"Return true/false indicating whether a string contains detectable PII. \" +\n \"Uses early-exit optimisation for performance.\",\n returns: \"boolean\",\n },\n anonymize: {\n description: \"Detect and replace PII in free text using a configurable strategy.\",\n strategies: {\n mask: \"Replace characters with a mask char, keeping optional leading/trailing chars.\",\n redact: \"Replace the entire value with a label such as [REDACTED].\",\n pseudonymize: \"Replace with a deterministic pseudonym (requires seed for reproducibility).\",\n hash: \"Replace with a one-way SHA-256 hash (requires Node.js ≥ 18).\",\n generalize: \"Replace a numeric value with a bucket range (e.g. 27 → 20-29).\",\n tokenize: \"Replace with a reversible opaque token ([CATEGORY_NNNN]) for LLM pipelines.\",\n encrypt: \"Replace with AES-GCM ciphertext (requires Node.js ≥ 18 + passphrase/key).\",\n synthesize: \"Replace with structurally-valid synthetic data (format-preserving).\",\n },\n options: {\n globalReplacement: \"Override ALL strategy outputs with a single replacement string.\",\n consistentTokens: \"Same PII value → same token (EMAIL_1, PHONE_2, etc.) within a call.\",\n aggressive: \"Use expanded, more permissive regex patterns to catch obfuscated PII.\",\n enabledCategories: \"Convenience boolean map for enabling/disabling categories.\",\n customPatterns: \"Ad-hoc regex patterns merged into the detection pipeline.\",\n customDetectors: \"Override built-in detectors on a per-category basis.\",\n preset:\n \"Apply a compliance preset (gdpr | lgpd | pipeda | hipaa | ccpa | pci-dss | sox | ferpa).\",\n allowlist: \"String values that should never be anonymized even when detected as PII.\",\n confidenceThreshold: \"Minimum confidence score (0-1) for a match to be anonymized.\",\n },\n returns: \"AnonymizeResult { text: string; matches: PiiMatch[] }\",\n },\n tokenize: {\n description: \"Replace PII with reversible opaque tokens. Use detokenize() to restore.\",\n returns: \"TokenizeResult { text: string; mapping: Map<string, string> }\",\n },\n anonymizeObject: {\n description:\n \"Recursively anonymize all string values in a JSON-serializable object tree. \" +\n \"Deep-clones the input — no mutation. Detects circular references.\",\n returns: \"A new object of the same shape with all string PII anonymized.\",\n },\n anonymizeRecord: {\n description: \"Anonymize specific fields in a JSON object using dot-notation paths.\",\n returns: \"A new object with the specified fields anonymized.\",\n },\n batch: {\n description:\n \"anonymizeBatch / tokenizeBatch / detectBatch — process arrays of text. \" +\n \"Per-item errors are collected without aborting the rest of the batch.\",\n returns: \"BatchResult<T>[] where ok/error per item is available.\",\n },\n presets: {\n description: \"GDPR, LGPD, PIPEDA, HIPAA, CCPA, PCI-DSS, SOX, FERPA compliance presets.\",\n available: [\"gdpr\", \"lgpd\", \"pipeda\", \"hipaa\", \"ccpa\", \"pci-dss\", \"sox\", \"ferpa\"],\n },\n },\n toolDefinitions: {\n openai: [\n ANONYMIZE_TOOL_DEFINITION,\n DETECT_TOOL_DEFINITION,\n HAS_PII_TOOL_DEFINITION,\n ANONYMIZE_OBJECT_TOOL_DEFINITION,\n ],\n },\n} as const;\n\n// ---------------------------------------------------------------------------\n// Inferred TypeScript types from Zod schemas\n// ---------------------------------------------------------------------------\n\n/** A PII category accepted by {@link PiiCategorySchema}. */\nexport type PiiCategoryInput = z.infer<typeof PiiCategorySchema>;\n/** Strategy options accepted by {@link StrategyOptionsSchema}. */\nexport type StrategyOptionsInput = z.infer<typeof StrategyOptionsSchema>;\n/** Anonymization options accepted by {@link AnonymizeOptionsSchema}. */\nexport type AnonymizeOptionsInput = z.infer<typeof AnonymizeOptionsSchema>;\n/** A per-category rule accepted by {@link AnonymizationRuleSchema}. */\nexport type AnonymizationRuleInput = z.infer<typeof AnonymizationRuleSchema>;\n/** A custom pattern accepted by {@link CustomPatternSchema}. */\nexport type CustomPatternInput = z.infer<typeof CustomPatternSchema>;\n/** A detected match as validated by {@link PiiMatchSchema}. */\nexport type PiiMatchOutput = z.infer<typeof PiiMatchSchema>;\n/** An anonymization result as validated by {@link AnonymizeResultSchema}. */\nexport type AnonymizeResultOutput = z.infer<typeof AnonymizeResultSchema>;\n/** A field rule accepted by {@link FieldRuleSchema}. */\nexport type FieldRuleInput = z.infer<typeof FieldRuleSchema>;\n/** A field rule map accepted by {@link FieldRuleMapSchema}. */\nexport type FieldRuleMapInput = z.infer<typeof FieldRuleMapSchema>;\n"]}
1
+ {"version":3,"sources":["../src/schemas.ts"],"names":[],"mappings":"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","file":"schemas.js","sourcesContent":["/**\n * @module schemas\n * @description Optional Zod schemas and JSON Schema definitions for anonyma's\n * public API surface. Import from `\"anonyma/schemas\"`.\n *\n * These schemas enable:\n * - Runtime input validation\n * - Function-calling tool definitions (OpenAI format) and a capability manifest\n * - Automatic form generation\n *\n * The Model Context Protocol declarations and server are in `\"anonyma/mcp\"`.\n *\n * @example\n * ```ts\n * import { AnonymizeOptionsSchema, ANONYMIZE_TOOL_DEFINITION } from \"anonyma/schemas\";\n *\n * // Validate at runtime:\n * const opts = AnonymizeOptionsSchema.parse(unknownInput);\n *\n * // Offer anonymization to a model as a tool:\n * const tools = [{ type: \"function\", function: ANONYMIZE_TOOL_DEFINITION }];\n * ```\n *\n * @remarks\n * This module requires `zod` to be installed (`peerDependency`).\n * Import it only when you need runtime validation or AI schema generation.\n */\n\nimport { z } from \"zod/v3\";\n\n// ---------------------------------------------------------------------------\n// Category & strategy schemas\n// ---------------------------------------------------------------------------\n\n/**\n * Zod schema for the {@link PiiCategory} union.\n */\nexport const PiiCategorySchema = z.enum([\n \"email\",\n \"phone\",\n \"ssn\",\n \"credit-card\",\n \"ipv4\",\n \"ipv6\",\n \"url\",\n \"iban\",\n \"date-of-birth\",\n \"name\",\n \"address\",\n \"passport\",\n \"drivers-license\",\n \"national-id\",\n \"bank-account\",\n \"cryptocurrency\",\n \"tax-id\",\n \"medical-record\",\n \"health-insurance\",\n \"prescription\",\n \"api-key\",\n \"social-media\",\n \"vin\",\n \"license-plate\",\n \"tracking-number\",\n \"case-number\",\n \"company-registration\",\n]);\n\n/**\n * Zod schema for {@link MaskOptions}.\n */\nexport const MaskOptionsSchema = z.object({\n strategy: z.literal(\"mask\"),\n maskChar: z.string().length(1, \"maskChar must be exactly one character\").default(\"*\").optional(),\n keepLeading: z.number().int().nonnegative().default(0).optional(),\n keepTrailing: z.number().int().nonnegative().default(0).optional(),\n});\n\n/**\n * Zod schema for {@link RedactOptions}.\n */\nexport const RedactOptionsSchema = z.object({\n strategy: z.literal(\"redact\"),\n label: z.string().min(1, \"label must not be empty\").default(\"[REDACTED]\").optional(),\n});\n\n/**\n * Zod schema for {@link PseudonymizeOptions}.\n */\nexport const PseudonymizeOptionsSchema = z.object({\n strategy: z.literal(\"pseudonymize\"),\n seed: z.string().optional(),\n prefix: z.string().regex(/^\\S+$/, \"prefix must not contain whitespace\").default(\"id_\").optional(),\n});\n\n/**\n * Zod schema for {@link HashOptions}.\n */\nexport const HashOptionsSchema = z.object({\n strategy: z.literal(\"hash\"),\n truncate: z.number().int().min(1).max(64).default(16).optional(),\n pepper: z.string().optional(),\n});\n\n/**\n * Zod schema for {@link GeneralizeOptions}.\n */\nexport const GeneralizeOptionsSchema = z.object({\n strategy: z.literal(\"generalize\"),\n bucketSize: z.number().int().positive().default(10).optional(),\n});\n\n/**\n * Discriminated union schema for {@link StrategyOptions}.\n */\nexport const StrategyOptionsSchema = z.discriminatedUnion(\"strategy\", [\n MaskOptionsSchema,\n RedactOptionsSchema,\n PseudonymizeOptionsSchema,\n HashOptionsSchema,\n GeneralizeOptionsSchema,\n]);\n\n// ---------------------------------------------------------------------------\n// Match & result schemas\n// ---------------------------------------------------------------------------\n\n/**\n * Zod schema for {@link PiiMatch}.\n */\nexport const PiiMatchSchema = z.object({\n category: PiiCategorySchema,\n value: z.string(),\n start: z.number().int().nonnegative(),\n end: z.number().int().positive(),\n confidence: z.number().min(0).max(1),\n});\n\n/**\n * Zod schema for {@link AnonymizeResult}.\n */\nexport const AnonymizeResultSchema = z.object({\n text: z.string(),\n matches: z.array(PiiMatchSchema),\n});\n\n// ---------------------------------------------------------------------------\n// Anonymize options schema\n// ---------------------------------------------------------------------------\n\n/**\n * Zod schema for a single {@link AnonymizationRule}.\n */\nexport const AnonymizationRuleSchema = z.object({\n category: PiiCategorySchema,\n strategy: StrategyOptionsSchema,\n});\n\n/**\n * Zod schema for a {@link CustomPattern}.\n */\nexport const CustomPatternSchema = z.object({\n pattern: z.instanceof(RegExp, { message: \"pattern must be a RegExp instance\" }),\n category: z.string().min(1).optional(),\n confidence: z.number().min(0).max(1).optional(),\n label: z.string().min(1, \"label must not be empty\").optional(),\n});\n\n/**\n * Zod schema for {@link AnonymizeOptions}.\n */\nexport const AnonymizeOptionsSchema = z.object({\n rules: z.array(AnonymizationRuleSchema).optional(),\n defaultStrategy: StrategyOptionsSchema.optional(),\n includeMatches: z.boolean().default(false).optional(),\n customPatterns: z.array(CustomPatternSchema).optional(),\n globalReplacement: z.string().min(1, \"globalReplacement must not be empty\").optional(),\n consistentTokens: z.boolean().default(false).optional(),\n aggressive: z.boolean().default(false).optional(),\n enabledCategories: z.record(PiiCategorySchema, z.boolean()).optional(),\n});\n\n// ---------------------------------------------------------------------------\n// Field-level anonymization schema\n// ---------------------------------------------------------------------------\n\n/**\n * Zod schema for a single field rule.\n */\nexport const FieldRuleSchema = z.object({\n strategy: StrategyOptionsSchema,\n});\n\n/**\n * Zod schema for a {@link FieldRuleMap}.\n */\nexport const FieldRuleMapSchema = z.record(z.string(), FieldRuleSchema);\n\n// ---------------------------------------------------------------------------\n// JSON Schema / OpenAI function-calling definitions\n// ---------------------------------------------------------------------------\n\n/**\n * A minimal JSON Schema representation extracted from a Zod schema.\n * Suitable for use in OpenAI function definitions, MCP tool definitions, etc.\n */\nexport interface JsonSchemaDefinition {\n readonly type: string;\n readonly description?: string;\n readonly properties?: Record<string, JsonSchemaDefinition>;\n readonly items?: JsonSchemaDefinition;\n readonly enum?: readonly string[];\n readonly required?: readonly string[];\n readonly anyOf?: readonly JsonSchemaDefinition[];\n readonly default?: unknown;\n}\n\n/**\n * OpenAI-compatible function definition shape.\n */\nexport interface OpenAiFunctionDefinition {\n readonly name: string;\n readonly description: string;\n readonly parameters: {\n readonly type: \"object\";\n readonly properties: Record<string, JsonSchemaDefinition>;\n readonly required?: readonly string[];\n };\n}\n\n/**\n * Pre-built OpenAI / MCP tool definition for the `anonymize` function.\n *\n * @example\n * ```ts\n * import { ANONYMIZE_TOOL_DEFINITION } from \"anonyma/schemas\";\n *\n * // Pass directly to OpenAI client tools array:\n * const response = await openai.chat.completions.create({\n * model: \"gpt-4o\",\n * tools: [{ type: \"function\", function: ANONYMIZE_TOOL_DEFINITION }],\n * messages: [...],\n * });\n * ```\n */\nexport const ANONYMIZE_TOOL_DEFINITION: OpenAiFunctionDefinition = {\n name: \"anonymize\",\n description:\n \"Detect and anonymize PII (personally identifiable information) in a text string. \" +\n \"Returns the anonymized text and, optionally, a list of detected PII matches.\",\n parameters: {\n type: \"object\",\n properties: {\n text: {\n type: \"string\",\n description: \"The input text to anonymize.\",\n },\n defaultStrategy: {\n type: \"object\",\n description:\n \"The anonymization strategy to apply to all detected PII. \" +\n \"Defaults to `{ strategy: 'redact' }`.\",\n properties: {\n strategy: {\n type: \"string\",\n enum: [\"mask\", \"redact\", \"pseudonymize\", \"hash\", \"generalize\"] as const,\n },\n },\n required: [\"strategy\"],\n },\n includeMatches: {\n type: \"boolean\",\n description: \"When true, include detected PII matches in the response.\",\n },\n globalReplacement: {\n type: \"string\",\n description:\n \"When set, every detected PII entity is replaced with this exact string, \" +\n \"overriding per-category rules and defaultStrategy.\",\n },\n consistentTokens: {\n type: \"boolean\",\n description:\n \"When true, identical PII values receive the same token (e.g. EMAIL_1) \" +\n \"across the entire call. Different values get different tokens.\",\n },\n aggressive: {\n type: \"boolean\",\n description:\n \"When true, detectors use expanded, more permissive patterns to catch \" +\n \"obfuscated PII at the cost of higher false-positive rates.\",\n },\n },\n required: [\"text\"],\n },\n};\n\n/**\n * Pre-built OpenAI / MCP tool definition for the `detect` function.\n */\nexport const DETECT_TOOL_DEFINITION: OpenAiFunctionDefinition = {\n name: \"detect\",\n description:\n \"Detect all PII (email, phone, SSN, credit card, IP, URL, IBAN, date-of-birth, name) \" +\n \"in a text string without modifying it. Returns a list of matches.\",\n parameters: {\n type: \"object\",\n properties: {\n text: {\n type: \"string\",\n description: \"The input text to scan for PII.\",\n },\n categories: {\n type: \"array\",\n description:\n \"Optional subset of PII categories to detect. \" + \"Defaults to all supported categories.\",\n items: {\n type: \"string\",\n enum: [\n \"email\",\n \"phone\",\n \"ssn\",\n \"credit-card\",\n \"ipv4\",\n \"ipv6\",\n \"url\",\n \"iban\",\n \"date-of-birth\",\n \"name\",\n ] as const,\n },\n },\n },\n required: [\"text\"],\n },\n};\n\n/**\n * Pre-built OpenAI / MCP tool definition for the `hasPII` function.\n *\n * @example\n * ```ts\n * import { HAS_PII_TOOL_DEFINITION } from \"anonyma/schemas\";\n *\n * const response = await openai.chat.completions.create({\n * tools: [{ type: \"function\", function: HAS_PII_TOOL_DEFINITION }],\n * messages: [...],\n * });\n * ```\n */\nexport const HAS_PII_TOOL_DEFINITION: OpenAiFunctionDefinition = {\n name: \"hasPII\",\n description:\n \"Check whether a text string contains any detectable PII without redacting it. \" +\n \"Returns true/false. Uses early-exit optimisation — stops scanning after the first match.\",\n parameters: {\n type: \"object\",\n properties: {\n text: {\n type: \"string\",\n description: \"The input text to check for PII.\",\n },\n categories: {\n type: \"array\",\n description: \"Optional subset of PII categories to check. Defaults to all.\",\n items: {\n type: \"string\",\n enum: [\n \"email\",\n \"phone\",\n \"ssn\",\n \"credit-card\",\n \"ipv4\",\n \"ipv6\",\n \"url\",\n \"iban\",\n \"date-of-birth\",\n \"name\",\n ] as const,\n },\n },\n },\n required: [\"text\"],\n },\n};\n\n/**\n * Pre-built OpenAI / MCP tool definition for the `anonymizeObject` function.\n *\n * @example\n * ```ts\n * import { ANONYMIZE_OBJECT_TOOL_DEFINITION } from \"anonyma/schemas\";\n * ```\n */\nexport const ANONYMIZE_OBJECT_TOOL_DEFINITION: OpenAiFunctionDefinition = {\n name: \"anonymizeObject\",\n description:\n \"Recursively anonymize all string values found in a JSON-serializable object tree. \" +\n \"Returns a deep clone with PII replaced. Arrays, nested objects, and mixed structures \" +\n \"are all handled. Non-string primitives pass through unchanged.\",\n parameters: {\n type: \"object\",\n properties: {\n obj: {\n type: \"object\",\n description: \"The JSON-serializable object to anonymize.\",\n },\n options: {\n type: \"object\",\n description: \"Optional anonymization configuration (same as anonymize() options).\",\n properties: {\n globalReplacement: {\n type: \"string\",\n description: \"Replace all PII with this exact string.\",\n },\n consistentTokens: {\n type: \"boolean\",\n description: \"Same PII value → same token across the entire object.\",\n },\n aggressive: {\n type: \"boolean\",\n description: \"Enable more permissive detection patterns.\",\n },\n },\n },\n },\n required: [\"obj\"],\n },\n};\n\n// ---------------------------------------------------------------------------\n// AI-readable capability manifest\n// ---------------------------------------------------------------------------\n\n/**\n * Machine-readable manifest describing anonyma's capabilities.\n * Useful for AI agents that need to discover and reason about available tools.\n *\n * @example\n * ```ts\n * import { ANONYMA_MANIFEST } from \"anonyma/schemas\";\n *\n * // Provide to an AI agent as system context:\n * const systemPrompt = `You have access to the following data privacy tool:\\n\\n${JSON.stringify(ANONYMA_MANIFEST, null, 2)}`;\n * ```\n */\nexport const ANONYMA_MANIFEST = {\n name: \"anonyma\",\n version: \"1.2.0\",\n description:\n \"TypeScript-first PII detection & anonymization — 27 built-in detectors (email, SSN, IBAN, passport, credit card, and more), 8 strategies (mask, redact, hash, AES-256 encrypt, tokenize, pseudonymize, generalize, synthesize), 8 compliance presets (GDPR, LGPD, PIPEDA, HIPAA, CCPA, PCI-DSS, SOX, FERPA), reversible tokenization, LLM/AI pipeline helpers, WHATWG streaming, batch processing, checksum validators, and optional Zod/MCP schemas. Zero runtime dependencies.\",\n capabilities: {\n detect: {\n description: \"Detect PII in free text without modifying it.\",\n supportedCategories: [\n \"email\",\n \"phone\",\n \"ssn\",\n \"credit-card\",\n \"ipv4\",\n \"ipv6\",\n \"url\",\n \"iban\",\n \"date-of-birth\",\n \"name\",\n \"address\",\n \"passport\",\n \"drivers-license\",\n \"national-id\",\n \"bank-account\",\n \"cryptocurrency\",\n \"tax-id\",\n \"medical-record\",\n \"health-insurance\",\n \"prescription\",\n \"api-key\",\n \"social-media\",\n \"vin\",\n \"license-plate\",\n \"tracking-number\",\n \"case-number\",\n \"company-registration\",\n ],\n notes: {\n name:\n \"Name detection is heuristic — only catches names preceded by greeting keywords \" +\n \"(e.g. 'Dear Alice'). Not an NLP-based named-entity recogniser.\",\n },\n returns: \"Array of PiiMatch objects with category, value, position, and confidence.\",\n },\n hasPII: {\n description:\n \"Return true/false indicating whether a string contains detectable PII. \" +\n \"Uses early-exit optimisation for performance.\",\n returns: \"boolean\",\n },\n anonymize: {\n description: \"Detect and replace PII in free text using a configurable strategy.\",\n strategies: {\n mask: \"Replace characters with a mask char, keeping optional leading/trailing chars.\",\n redact: \"Replace the entire value with a label such as [REDACTED].\",\n pseudonymize: \"Replace with a deterministic pseudonym (requires seed for reproducibility).\",\n hash: \"Replace with a one-way SHA-256 hash (requires Node.js ≥ 18).\",\n generalize: \"Replace a numeric value with a bucket range (e.g. 27 → 20-29).\",\n tokenize: \"Replace with a reversible opaque token ([CATEGORY_NNNN]) for LLM pipelines.\",\n encrypt: \"Replace with AES-GCM ciphertext (requires Node.js ≥ 18 + passphrase/key).\",\n synthesize: \"Replace with structurally-valid synthetic data (format-preserving).\",\n },\n options: {\n globalReplacement: \"Override ALL strategy outputs with a single replacement string.\",\n consistentTokens: \"Same PII value → same token (EMAIL_1, PHONE_2, etc.) within a call.\",\n aggressive: \"Use expanded, more permissive regex patterns to catch obfuscated PII.\",\n enabledCategories: \"Convenience boolean map for enabling/disabling categories.\",\n customPatterns: \"Ad-hoc regex patterns merged into the detection pipeline.\",\n customDetectors: \"Override built-in detectors on a per-category basis.\",\n preset:\n \"Apply a compliance preset (gdpr | lgpd | pipeda | hipaa | ccpa | pci-dss | sox | ferpa).\",\n allowlist: \"String values that should never be anonymized even when detected as PII.\",\n confidenceThreshold: \"Minimum confidence score (0-1) for a match to be anonymized.\",\n },\n returns: \"AnonymizeResult { text: string; matches: PiiMatch[] }\",\n },\n tokenize: {\n description: \"Replace PII with reversible opaque tokens. Use detokenize() to restore.\",\n returns: \"TokenizeResult { text: string; mapping: Map<string, string> }\",\n },\n anonymizeObject: {\n description:\n \"Recursively anonymize all string values in a JSON-serializable object tree. \" +\n \"Deep-clones the input — no mutation. Detects circular references.\",\n returns: \"A new object of the same shape with all string PII anonymized.\",\n },\n anonymizeRecord: {\n description: \"Anonymize specific fields in a JSON object using dot-notation paths.\",\n returns: \"A new object with the specified fields anonymized.\",\n },\n batch: {\n description:\n \"anonymizeBatch / tokenizeBatch / detectBatch — process arrays of text. \" +\n \"Per-item errors are collected without aborting the rest of the batch.\",\n returns: \"BatchResult<T>[] where ok/error per item is available.\",\n },\n presets: {\n description: \"GDPR, LGPD, PIPEDA, HIPAA, CCPA, PCI-DSS, SOX, FERPA compliance presets.\",\n available: [\"gdpr\", \"lgpd\", \"pipeda\", \"hipaa\", \"ccpa\", \"pci-dss\", \"sox\", \"ferpa\"],\n },\n },\n toolDefinitions: {\n openai: [\n ANONYMIZE_TOOL_DEFINITION,\n DETECT_TOOL_DEFINITION,\n HAS_PII_TOOL_DEFINITION,\n ANONYMIZE_OBJECT_TOOL_DEFINITION,\n ],\n },\n} as const;\n\n// ---------------------------------------------------------------------------\n// Inferred TypeScript types from Zod schemas\n// ---------------------------------------------------------------------------\n\n/** A PII category accepted by {@link PiiCategorySchema}. */\nexport type PiiCategoryInput = z.infer<typeof PiiCategorySchema>;\n/** Strategy options accepted by {@link StrategyOptionsSchema}. */\nexport type StrategyOptionsInput = z.infer<typeof StrategyOptionsSchema>;\n/** Anonymization options accepted by {@link AnonymizeOptionsSchema}. */\nexport type AnonymizeOptionsInput = z.infer<typeof AnonymizeOptionsSchema>;\n/** A per-category rule accepted by {@link AnonymizationRuleSchema}. */\nexport type AnonymizationRuleInput = z.infer<typeof AnonymizationRuleSchema>;\n/** A custom pattern accepted by {@link CustomPatternSchema}. */\nexport type CustomPatternInput = z.infer<typeof CustomPatternSchema>;\n/** A detected match as validated by {@link PiiMatchSchema}. */\nexport type PiiMatchOutput = z.infer<typeof PiiMatchSchema>;\n/** An anonymization result as validated by {@link AnonymizeResultSchema}. */\nexport type AnonymizeResultOutput = z.infer<typeof AnonymizeResultSchema>;\n/** A field rule accepted by {@link FieldRuleSchema}. */\nexport type FieldRuleInput = z.infer<typeof FieldRuleSchema>;\n/** A field rule map accepted by {@link FieldRuleMapSchema}. */\nexport type FieldRuleMapInput = z.infer<typeof FieldRuleMapSchema>;\n"]}
@@ -1,4 +1,13 @@
1
- import { T as TokenizationProvider, a as TokenContext, R as RestoreResult } from './types-oxllMFYF.js';
1
+ import { c as TokenizationProvider, d as TokenContext, R as RestoreResult } from './types-LZHFEgx5.cjs';
2
+
3
+ /**
4
+ * Shape of a numbered token.
5
+ *
6
+ * - `"bracket"`: `[EMAIL_0001]`
7
+ * - `"angle"`: `<EMAIL_1>`
8
+ * - `"brace"`: `{{EMAIL_1}}`
9
+ */
10
+ type TokenShape = "bracket" | "angle" | "brace";
2
11
 
3
12
  /**
4
13
  * @module vault/session
@@ -21,7 +30,7 @@ interface SessionSnapshot {
21
30
  /** Snapshot format version. */
22
31
  readonly v: 1;
23
32
  /** Token shape of the session. */
24
- readonly format: "bracket" | "angle";
33
+ readonly format: TokenShape;
25
34
  /** The session tag, when the session has one. */
26
35
  readonly tag?: string;
27
36
  /** Every token with its original value and category, in creation order. */
@@ -37,8 +46,12 @@ interface SessionSnapshot {
37
46
  * Options accepted by {@link createSessionTokenizer}.
38
47
  */
39
48
  interface SessionTokenizerOptions {
40
- /** Token shape: `[EMAIL_0001]` (`"bracket"`, default) or `<EMAIL_1>` (`"angle"`). */
41
- readonly format?: "bracket" | "angle";
49
+ /**
50
+ * Token shape: `[EMAIL_0001]` (`"bracket"`, default), `<EMAIL_1>`
51
+ * (`"angle"`) or `{{EMAIL_1}}` (`"brace"`). Avoid `"brace"` when prompts go
52
+ * through a template engine that treats `{{…}}` as a placeholder.
53
+ */
54
+ readonly format?: TokenShape;
42
55
  /**
43
56
  * 2 to 12 letters or digits inserted into every token (`[EMAIL_k3Xf_0001]`).
44
57
  * With an unpredictable tag, text that merely looks like a token — in the
@@ -99,4 +112,4 @@ interface SessionTokenizer extends TokenizationProvider {
99
112
  */
100
113
  declare function createSessionTokenizer(options?: SessionTokenizerOptions): SessionTokenizer;
101
114
 
102
- export { type SessionTokenizer as S, type SessionSnapshot as a, type SessionTokenizerOptions as b, createSessionTokenizer as c };
115
+ export { type SessionTokenizer as S, type TokenShape as T, type SessionSnapshot as a, type SessionTokenizerOptions as b, createSessionTokenizer as c };
@@ -1,4 +1,13 @@
1
- import { T as TokenizationProvider, a as TokenContext, R as RestoreResult } from './types-BL5UWH0y.cjs';
1
+ import { c as TokenizationProvider, d as TokenContext, R as RestoreResult } from './types-LZHFEgx5.js';
2
+
3
+ /**
4
+ * Shape of a numbered token.
5
+ *
6
+ * - `"bracket"`: `[EMAIL_0001]`
7
+ * - `"angle"`: `<EMAIL_1>`
8
+ * - `"brace"`: `{{EMAIL_1}}`
9
+ */
10
+ type TokenShape = "bracket" | "angle" | "brace";
2
11
 
3
12
  /**
4
13
  * @module vault/session
@@ -21,7 +30,7 @@ interface SessionSnapshot {
21
30
  /** Snapshot format version. */
22
31
  readonly v: 1;
23
32
  /** Token shape of the session. */
24
- readonly format: "bracket" | "angle";
33
+ readonly format: TokenShape;
25
34
  /** The session tag, when the session has one. */
26
35
  readonly tag?: string;
27
36
  /** Every token with its original value and category, in creation order. */
@@ -37,8 +46,12 @@ interface SessionSnapshot {
37
46
  * Options accepted by {@link createSessionTokenizer}.
38
47
  */
39
48
  interface SessionTokenizerOptions {
40
- /** Token shape: `[EMAIL_0001]` (`"bracket"`, default) or `<EMAIL_1>` (`"angle"`). */
41
- readonly format?: "bracket" | "angle";
49
+ /**
50
+ * Token shape: `[EMAIL_0001]` (`"bracket"`, default), `<EMAIL_1>`
51
+ * (`"angle"`) or `{{EMAIL_1}}` (`"brace"`). Avoid `"brace"` when prompts go
52
+ * through a template engine that treats `{{…}}` as a placeholder.
53
+ */
54
+ readonly format?: TokenShape;
42
55
  /**
43
56
  * 2 to 12 letters or digits inserted into every token (`[EMAIL_k3Xf_0001]`).
44
57
  * With an unpredictable tag, text that merely looks like a token — in the
@@ -99,4 +112,4 @@ interface SessionTokenizer extends TokenizationProvider {
99
112
  */
100
113
  declare function createSessionTokenizer(options?: SessionTokenizerOptions): SessionTokenizer;
101
114
 
102
- export { type SessionTokenizer as S, type SessionSnapshot as a, type SessionTokenizerOptions as b, createSessionTokenizer as c };
115
+ export { type SessionTokenizer as S, type TokenShape as T, type SessionSnapshot as a, type SessionTokenizerOptions as b, createSessionTokenizer as c };
package/dist/stream.cjs CHANGED
@@ -1,10 +1,12 @@
1
1
  'use strict';
2
2
 
3
- var chunkZXPZ7W37_cjs = require('./chunk-ZXPZ7W37.cjs');
4
- require('./chunk-CRXRJZEV.cjs');
5
- require('./chunk-IHEIYZPL.cjs');
6
- require('./chunk-UA3EOFBS.cjs');
7
- require('./chunk-GYMG5OI3.cjs');
3
+ var chunk42ZZZUMO_cjs = require('./chunk-42ZZZUMO.cjs');
4
+ require('./chunk-JPU7KQZX.cjs');
5
+ require('./chunk-RJX27YEX.cjs');
6
+ require('./chunk-XVCVIUZS.cjs');
7
+ require('./chunk-ESVFPMG4.cjs');
8
+ require('./chunk-T2KIN6VL.cjs');
9
+ require('./chunk-UN74SYHV.cjs');
8
10
  var chunkWLJN7GIS_cjs = require('./chunk-WLJN7GIS.cjs');
9
11
 
10
12
  // src/stream.ts
@@ -25,7 +27,7 @@ function createAnonymizeStream(options = {}) {
25
27
  controller.error(new chunkWLJN7GIS_cjs.ValidationError("chunk", "must be a string"));
26
28
  return;
27
29
  }
28
- controller.enqueue(chunkZXPZ7W37_cjs.anonymize(chunk, options));
30
+ controller.enqueue(chunk42ZZZUMO_cjs.anonymize(chunk, options));
29
31
  }
30
32
  });
31
33
  }
@@ -38,7 +40,7 @@ function createAnonymizeStreamAsync(options = {}) {
38
40
  return;
39
41
  }
40
42
  try {
41
- const result = await chunkZXPZ7W37_cjs.anonymizeAsync(chunk, options);
43
+ const result = await chunk42ZZZUMO_cjs.anonymizeAsync(chunk, options);
42
44
  controller.enqueue(result);
43
45
  } catch (err) {
44
46
  controller.error(err);
@@ -54,7 +56,7 @@ function createTokenizeStream(options = {}) {
54
56
  controller.error(new chunkWLJN7GIS_cjs.ValidationError("chunk", "must be a string"));
55
57
  return;
56
58
  }
57
- controller.enqueue(chunkZXPZ7W37_cjs.tokenize(chunk, options));
59
+ controller.enqueue(chunk42ZZZUMO_cjs.tokenize(chunk, options));
58
60
  }
59
61
  });
60
62
  }