@xproof/xproof 0.1.5 → 0.1.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/{client-CBMuwyVp.d.mts → client-CWrki-T_.d.mts} +33 -1
- package/dist/{client-CBMuwyVp.d.ts → client-CWrki-T_.d.ts} +33 -1
- package/dist/index.d.mts +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.js +59 -1
- package/dist/index.js.map +1 -1
- package/dist/index.mjs +59 -1
- package/dist/index.mjs.map +1 -1
- package/dist/integrations/vercel.d.mts +1 -1
- package/dist/integrations/vercel.d.ts +1 -1
- package/dist/integrations/vercel.js +59 -1
- package/dist/integrations/vercel.js.map +1 -1
- package/dist/integrations/vercel.mjs +59 -1
- package/dist/integrations/vercel.mjs.map +1 -1
- package/package.json +3 -2
|
@@ -53,6 +53,7 @@ interface FourWOptions {
|
|
|
53
53
|
what?: string;
|
|
54
54
|
when?: string;
|
|
55
55
|
why?: string;
|
|
56
|
+
reversibilityClass?: ReversibilityClass;
|
|
56
57
|
metadata?: Record<string, unknown>;
|
|
57
58
|
}
|
|
58
59
|
interface CertifyHashOptions extends FourWOptions {
|
|
@@ -61,10 +62,12 @@ interface CertifyHashOptions extends FourWOptions {
|
|
|
61
62
|
author: string;
|
|
62
63
|
}
|
|
63
64
|
type ThresholdStage = "initial" | "partial" | "pre-commitment" | "final";
|
|
65
|
+
type ReversibilityClass = "reversible" | "costly" | "irreversible";
|
|
64
66
|
interface ConfidenceOptions {
|
|
65
67
|
confidenceLevel: number;
|
|
66
68
|
thresholdStage: ThresholdStage;
|
|
67
69
|
decisionId: string;
|
|
70
|
+
reversibilityClass?: ReversibilityClass;
|
|
68
71
|
}
|
|
69
72
|
interface ConfidenceTrailStage {
|
|
70
73
|
proofId: string;
|
|
@@ -72,6 +75,7 @@ interface ConfidenceTrailStage {
|
|
|
72
75
|
fileHash: string;
|
|
73
76
|
confidenceLevel: number | null;
|
|
74
77
|
thresholdStage: string | null;
|
|
78
|
+
reversibilityClass: ReversibilityClass | null;
|
|
75
79
|
author: string;
|
|
76
80
|
blockchain: {
|
|
77
81
|
transactionHash: string;
|
|
@@ -89,15 +93,33 @@ interface ConfidenceTrailDrift {
|
|
|
89
93
|
fieldsStable: string[];
|
|
90
94
|
fieldsAbsent: string[];
|
|
91
95
|
}
|
|
96
|
+
interface PolicyViolation {
|
|
97
|
+
proofId: string;
|
|
98
|
+
confidenceLevel: number | null;
|
|
99
|
+
reversibilityClass: ReversibilityClass;
|
|
100
|
+
thresholdStage: string | null;
|
|
101
|
+
threshold: number;
|
|
102
|
+
rule: string;
|
|
103
|
+
}
|
|
92
104
|
interface ConfidenceTrail {
|
|
93
105
|
decisionId: string;
|
|
94
106
|
totalAnchors: number;
|
|
95
107
|
currentConfidence: number | null;
|
|
96
108
|
currentStage: string | null;
|
|
97
109
|
isFinalized: boolean;
|
|
110
|
+
policyCompliant: boolean;
|
|
111
|
+
policyViolations: PolicyViolation[];
|
|
98
112
|
contextDrift: ConfidenceTrailDrift | null;
|
|
99
113
|
stages: ConfidenceTrailStage[];
|
|
100
114
|
}
|
|
115
|
+
interface PolicyCheckResult {
|
|
116
|
+
decisionId: string;
|
|
117
|
+
totalAnchors: number;
|
|
118
|
+
policyCompliant: boolean;
|
|
119
|
+
policyViolations: PolicyViolation[];
|
|
120
|
+
checkedAt: string;
|
|
121
|
+
raw: Record<string, unknown>;
|
|
122
|
+
}
|
|
101
123
|
interface BatchFileEntry {
|
|
102
124
|
fileHash: string;
|
|
103
125
|
fileName?: string;
|
|
@@ -153,8 +175,18 @@ declare class XProofClient {
|
|
|
153
175
|
getContextDrift(decisionId: string): Promise<ContextDrift>;
|
|
154
176
|
getPricing(): Promise<PricingInfo>;
|
|
155
177
|
private requireAuth;
|
|
178
|
+
/**
|
|
179
|
+
* Check policy compliance for a decision chain without fetching the full trail.
|
|
180
|
+
*
|
|
181
|
+
* Calls `GET /api/proofs/policy-check?decision_id=<id>` and returns a lightweight
|
|
182
|
+
* compliance report: whether the chain is policy-compliant and any violations found.
|
|
183
|
+
*
|
|
184
|
+
* @param decisionId - The shared decision chain identifier.
|
|
185
|
+
* @returns A `PolicyCheckResult` with `policyCompliant`, `policyViolations`, and metadata.
|
|
186
|
+
*/
|
|
187
|
+
getPolicyCheck(decisionId: string): Promise<PolicyCheckResult>;
|
|
156
188
|
private request;
|
|
157
189
|
private handleError;
|
|
158
190
|
}
|
|
159
191
|
|
|
160
|
-
export { type BatchFileEntry as B, type Certification as C, type ExecutionContext as E, type FourWOptions as F, type
|
|
192
|
+
export { type BatchFileEntry as B, type Certification as C, type ExecutionContext as E, type FourWOptions as F, type PolicyCheckResult as P, type RegistrationResult as R, type ThresholdStage as T, XProofClient as X, type BatchResult as a, type BatchResultSummary as b, type CertifyHashOptions as c, type ConfidenceOptions as d, type ConfidenceTrail as e, type ConfidenceTrailDrift as f, type ConfidenceTrailStage as g, type ContextDrift as h, type ContextDriftStage as i, type PolicyViolation as j, type PricingInfo as k, type PricingTier as l, type ReversibilityClass as m, type TrialInfo as n, type XProofClientOptions as o };
|
|
@@ -53,6 +53,7 @@ interface FourWOptions {
|
|
|
53
53
|
what?: string;
|
|
54
54
|
when?: string;
|
|
55
55
|
why?: string;
|
|
56
|
+
reversibilityClass?: ReversibilityClass;
|
|
56
57
|
metadata?: Record<string, unknown>;
|
|
57
58
|
}
|
|
58
59
|
interface CertifyHashOptions extends FourWOptions {
|
|
@@ -61,10 +62,12 @@ interface CertifyHashOptions extends FourWOptions {
|
|
|
61
62
|
author: string;
|
|
62
63
|
}
|
|
63
64
|
type ThresholdStage = "initial" | "partial" | "pre-commitment" | "final";
|
|
65
|
+
type ReversibilityClass = "reversible" | "costly" | "irreversible";
|
|
64
66
|
interface ConfidenceOptions {
|
|
65
67
|
confidenceLevel: number;
|
|
66
68
|
thresholdStage: ThresholdStage;
|
|
67
69
|
decisionId: string;
|
|
70
|
+
reversibilityClass?: ReversibilityClass;
|
|
68
71
|
}
|
|
69
72
|
interface ConfidenceTrailStage {
|
|
70
73
|
proofId: string;
|
|
@@ -72,6 +75,7 @@ interface ConfidenceTrailStage {
|
|
|
72
75
|
fileHash: string;
|
|
73
76
|
confidenceLevel: number | null;
|
|
74
77
|
thresholdStage: string | null;
|
|
78
|
+
reversibilityClass: ReversibilityClass | null;
|
|
75
79
|
author: string;
|
|
76
80
|
blockchain: {
|
|
77
81
|
transactionHash: string;
|
|
@@ -89,15 +93,33 @@ interface ConfidenceTrailDrift {
|
|
|
89
93
|
fieldsStable: string[];
|
|
90
94
|
fieldsAbsent: string[];
|
|
91
95
|
}
|
|
96
|
+
interface PolicyViolation {
|
|
97
|
+
proofId: string;
|
|
98
|
+
confidenceLevel: number | null;
|
|
99
|
+
reversibilityClass: ReversibilityClass;
|
|
100
|
+
thresholdStage: string | null;
|
|
101
|
+
threshold: number;
|
|
102
|
+
rule: string;
|
|
103
|
+
}
|
|
92
104
|
interface ConfidenceTrail {
|
|
93
105
|
decisionId: string;
|
|
94
106
|
totalAnchors: number;
|
|
95
107
|
currentConfidence: number | null;
|
|
96
108
|
currentStage: string | null;
|
|
97
109
|
isFinalized: boolean;
|
|
110
|
+
policyCompliant: boolean;
|
|
111
|
+
policyViolations: PolicyViolation[];
|
|
98
112
|
contextDrift: ConfidenceTrailDrift | null;
|
|
99
113
|
stages: ConfidenceTrailStage[];
|
|
100
114
|
}
|
|
115
|
+
interface PolicyCheckResult {
|
|
116
|
+
decisionId: string;
|
|
117
|
+
totalAnchors: number;
|
|
118
|
+
policyCompliant: boolean;
|
|
119
|
+
policyViolations: PolicyViolation[];
|
|
120
|
+
checkedAt: string;
|
|
121
|
+
raw: Record<string, unknown>;
|
|
122
|
+
}
|
|
101
123
|
interface BatchFileEntry {
|
|
102
124
|
fileHash: string;
|
|
103
125
|
fileName?: string;
|
|
@@ -153,8 +175,18 @@ declare class XProofClient {
|
|
|
153
175
|
getContextDrift(decisionId: string): Promise<ContextDrift>;
|
|
154
176
|
getPricing(): Promise<PricingInfo>;
|
|
155
177
|
private requireAuth;
|
|
178
|
+
/**
|
|
179
|
+
* Check policy compliance for a decision chain without fetching the full trail.
|
|
180
|
+
*
|
|
181
|
+
* Calls `GET /api/proofs/policy-check?decision_id=<id>` and returns a lightweight
|
|
182
|
+
* compliance report: whether the chain is policy-compliant and any violations found.
|
|
183
|
+
*
|
|
184
|
+
* @param decisionId - The shared decision chain identifier.
|
|
185
|
+
* @returns A `PolicyCheckResult` with `policyCompliant`, `policyViolations`, and metadata.
|
|
186
|
+
*/
|
|
187
|
+
getPolicyCheck(decisionId: string): Promise<PolicyCheckResult>;
|
|
156
188
|
private request;
|
|
157
189
|
private handleError;
|
|
158
190
|
}
|
|
159
191
|
|
|
160
|
-
export { type BatchFileEntry as B, type Certification as C, type ExecutionContext as E, type FourWOptions as F, type
|
|
192
|
+
export { type BatchFileEntry as B, type Certification as C, type ExecutionContext as E, type FourWOptions as F, type PolicyCheckResult as P, type RegistrationResult as R, type ThresholdStage as T, XProofClient as X, type BatchResult as a, type BatchResultSummary as b, type CertifyHashOptions as c, type ConfidenceOptions as d, type ConfidenceTrail as e, type ConfidenceTrailDrift as f, type ConfidenceTrailStage as g, type ContextDrift as h, type ContextDriftStage as i, type PolicyViolation as j, type PricingInfo as k, type PricingTier as l, type ReversibilityClass as m, type TrialInfo as n, type XProofClientOptions as o };
|
package/dist/index.d.mts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
export { B as BatchFileEntry, a as BatchResult, b as BatchResultSummary, C as Certification, c as CertifyHashOptions, d as ConfidenceOptions, e as ConfidenceTrail, f as ConfidenceTrailDrift, g as ConfidenceTrailStage, h as ContextDrift, i as ContextDriftStage, E as ExecutionContext, F as FourWOptions, P as
|
|
1
|
+
export { B as BatchFileEntry, a as BatchResult, b as BatchResultSummary, C as Certification, c as CertifyHashOptions, d as ConfidenceOptions, e as ConfidenceTrail, f as ConfidenceTrailDrift, g as ConfidenceTrailStage, h as ContextDrift, i as ContextDriftStage, E as ExecutionContext, F as FourWOptions, P as PolicyCheckResult, j as PolicyViolation, k as PricingInfo, l as PricingTier, R as RegistrationResult, m as ReversibilityClass, T as ThresholdStage, n as TrialInfo, X as XProofClient, o as XProofClientOptions } from './client-CWrki-T_.mjs';
|
|
2
2
|
|
|
3
3
|
declare class XProofError extends Error {
|
|
4
4
|
statusCode: number;
|
package/dist/index.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
export { B as BatchFileEntry, a as BatchResult, b as BatchResultSummary, C as Certification, c as CertifyHashOptions, d as ConfidenceOptions, e as ConfidenceTrail, f as ConfidenceTrailDrift, g as ConfidenceTrailStage, h as ContextDrift, i as ContextDriftStage, E as ExecutionContext, F as FourWOptions, P as
|
|
1
|
+
export { B as BatchFileEntry, a as BatchResult, b as BatchResultSummary, C as Certification, c as CertifyHashOptions, d as ConfidenceOptions, e as ConfidenceTrail, f as ConfidenceTrailDrift, g as ConfidenceTrailStage, h as ContextDrift, i as ContextDriftStage, E as ExecutionContext, F as FourWOptions, P as PolicyCheckResult, j as PolicyViolation, k as PricingInfo, l as PricingTier, R as RegistrationResult, m as ReversibilityClass, T as ThresholdStage, n as TrialInfo, X as XProofClient, o as XProofClientOptions } from './client-CWrki-T_.js';
|
|
2
2
|
|
|
3
3
|
declare class XProofError extends Error {
|
|
4
4
|
statusCode: number;
|
package/dist/index.js
CHANGED
|
@@ -171,7 +171,7 @@ function parseRegistrationResult(data) {
|
|
|
171
171
|
}
|
|
172
172
|
|
|
173
173
|
// src/client.ts
|
|
174
|
-
var VERSION = "0.1.
|
|
174
|
+
var VERSION = "0.1.7";
|
|
175
175
|
var DEFAULT_BASE_URL = "https://xproof.app";
|
|
176
176
|
var DEFAULT_TIMEOUT = 3e4;
|
|
177
177
|
var XProofClient = class _XProofClient {
|
|
@@ -208,6 +208,8 @@ var XProofClient = class _XProofClient {
|
|
|
208
208
|
if (fourW?.what !== void 0) metadata.what = fourW.what;
|
|
209
209
|
if (fourW?.when !== void 0) metadata.when = fourW.when;
|
|
210
210
|
if (fourW?.why !== void 0) metadata.why = fourW.why;
|
|
211
|
+
if (fourW?.reversibilityClass !== void 0)
|
|
212
|
+
metadata.reversibility_class = fourW.reversibilityClass;
|
|
211
213
|
const payload = {
|
|
212
214
|
filename: fileName,
|
|
213
215
|
file_hash: fileHash,
|
|
@@ -266,9 +268,13 @@ var XProofClient = class _XProofClient {
|
|
|
266
268
|
if (fourW?.what !== void 0) metadata.what = fourW.what;
|
|
267
269
|
if (fourW?.when !== void 0) metadata.when = fourW.when;
|
|
268
270
|
if (fourW?.why !== void 0) metadata.why = fourW.why;
|
|
271
|
+
if (fourW?.reversibilityClass !== void 0)
|
|
272
|
+
metadata.reversibility_class = fourW.reversibilityClass;
|
|
269
273
|
metadata.confidence_level = confidence.confidenceLevel;
|
|
270
274
|
metadata.threshold_stage = confidence.thresholdStage;
|
|
271
275
|
metadata.decision_id = confidence.decisionId;
|
|
276
|
+
if (confidence.reversibilityClass !== void 0)
|
|
277
|
+
metadata.reversibility_class = confidence.reversibilityClass;
|
|
272
278
|
const payload = {
|
|
273
279
|
filename: fileName,
|
|
274
280
|
file_hash: fileHash,
|
|
@@ -291,6 +297,7 @@ var XProofClient = class _XProofClient {
|
|
|
291
297
|
fileHash: s.file_hash || "",
|
|
292
298
|
confidenceLevel: s.confidence_level ?? null,
|
|
293
299
|
thresholdStage: s.threshold_stage ?? null,
|
|
300
|
+
reversibilityClass: s.metadata?.reversibility_class ?? null,
|
|
294
301
|
author: s.author || "",
|
|
295
302
|
blockchain: {
|
|
296
303
|
transactionHash: s.blockchain?.transaction_hash || "",
|
|
@@ -309,12 +316,23 @@ var XProofClient = class _XProofClient {
|
|
|
309
316
|
fieldsStable: rawDrift.fields_stable || [],
|
|
310
317
|
fieldsAbsent: rawDrift.fields_absent || []
|
|
311
318
|
} : null;
|
|
319
|
+
const rawViolations = data.policy_violations || [];
|
|
320
|
+
const policyViolations = rawViolations.map((v) => ({
|
|
321
|
+
proofId: v.proof_id || "",
|
|
322
|
+
confidenceLevel: v.confidence_level ?? null,
|
|
323
|
+
reversibilityClass: v.reversibility_class,
|
|
324
|
+
thresholdStage: v.threshold_stage ?? null,
|
|
325
|
+
threshold: v.threshold ?? 0.95,
|
|
326
|
+
rule: v.rule || ""
|
|
327
|
+
}));
|
|
312
328
|
return {
|
|
313
329
|
decisionId: data.decision_id || decisionId,
|
|
314
330
|
totalAnchors: data.total_anchors || stages.length,
|
|
315
331
|
currentConfidence: data.current_confidence ?? null,
|
|
316
332
|
currentStage: data.current_stage ?? null,
|
|
317
333
|
isFinalized: data.is_finalized || false,
|
|
334
|
+
policyCompliant: data.policy_compliant ?? true,
|
|
335
|
+
policyViolations,
|
|
318
336
|
contextDrift,
|
|
319
337
|
stages
|
|
320
338
|
};
|
|
@@ -359,6 +377,46 @@ var XProofClient = class _XProofClient {
|
|
|
359
377
|
);
|
|
360
378
|
}
|
|
361
379
|
}
|
|
380
|
+
/**
|
|
381
|
+
* Check policy compliance for a decision chain without fetching the full trail.
|
|
382
|
+
*
|
|
383
|
+
* Calls `GET /api/proofs/policy-check?decision_id=<id>` and returns a lightweight
|
|
384
|
+
* compliance report: whether the chain is policy-compliant and any violations found.
|
|
385
|
+
*
|
|
386
|
+
* @param decisionId - The shared decision chain identifier.
|
|
387
|
+
* @returns A `PolicyCheckResult` with `policyCompliant`, `policyViolations`, and metadata.
|
|
388
|
+
*/
|
|
389
|
+
async getPolicyCheck(decisionId) {
|
|
390
|
+
if (!decisionId || !decisionId.trim()) {
|
|
391
|
+
throw new ValidationError("decisionId is required", {});
|
|
392
|
+
}
|
|
393
|
+
const data = await this.request(
|
|
394
|
+
"GET",
|
|
395
|
+
`/api/proofs/policy-check?decision_id=${encodeURIComponent(decisionId)}`,
|
|
396
|
+
{ authRequired: false }
|
|
397
|
+
);
|
|
398
|
+
const violations = (data.policy_violations ?? []).map(
|
|
399
|
+
(v) => {
|
|
400
|
+
const vv = v;
|
|
401
|
+
return {
|
|
402
|
+
proofId: vv.proof_id ?? "",
|
|
403
|
+
confidenceLevel: vv.confidence_level != null ? vv.confidence_level : null,
|
|
404
|
+
reversibilityClass: vv.reversibility_class ?? "reversible",
|
|
405
|
+
thresholdStage: vv.threshold_stage != null ? vv.threshold_stage : null,
|
|
406
|
+
threshold: vv.threshold ?? 0,
|
|
407
|
+
rule: vv.rule ?? ""
|
|
408
|
+
};
|
|
409
|
+
}
|
|
410
|
+
);
|
|
411
|
+
return {
|
|
412
|
+
decisionId: data.decision_id ?? decisionId,
|
|
413
|
+
totalAnchors: data.total_anchors ?? 0,
|
|
414
|
+
policyCompliant: data.policy_compliant ?? true,
|
|
415
|
+
policyViolations: violations,
|
|
416
|
+
checkedAt: data.checked_at ?? "",
|
|
417
|
+
raw: data
|
|
418
|
+
};
|
|
419
|
+
}
|
|
362
420
|
async request(method, path, options = {}) {
|
|
363
421
|
const url = `${this.baseUrl}${path}`;
|
|
364
422
|
const { body, authRequired = true } = options;
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/index.ts","../src/client.ts","../src/errors.ts","../src/hash.ts","../src/parse.ts"],"sourcesContent":["export { XProofClient } from \"./client.js\";\nexport {\n XProofError,\n AuthenticationError,\n ValidationError,\n NotFoundError,\n ConflictError,\n RateLimitError,\n ServerError,\n} from \"./errors.js\";\nexport type {\n Certification,\n BatchResult,\n BatchResultSummary,\n PricingInfo,\n PricingTier,\n RegistrationResult,\n TrialInfo,\n FourWOptions,\n CertifyHashOptions,\n BatchFileEntry,\n XProofClientOptions,\n ThresholdStage,\n ConfidenceOptions,\n ConfidenceTrail,\n ConfidenceTrailStage,\n ConfidenceTrailDrift,\n ExecutionContext,\n ContextDriftStage,\n ContextDrift,\n} from \"./types.js\";\nexport { hashFile, hashBuffer, hashString } from \"./hash.js\";\n","import { basename } from \"path\";\nimport {\n XProofError,\n AuthenticationError,\n ValidationError,\n NotFoundError,\n ConflictError,\n RateLimitError,\n ServerError,\n} from \"./errors.js\";\nimport { hashFile } from \"./hash.js\";\nimport {\n parseCertification,\n parseBatchResult,\n parsePricingInfo,\n parseRegistrationResult,\n} from \"./parse.js\";\nimport type {\n Certification,\n BatchResult,\n PricingInfo,\n RegistrationResult,\n FourWOptions,\n BatchFileEntry,\n XProofClientOptions,\n ConfidenceOptions,\n ConfidenceTrail,\n ConfidenceTrailStage,\n ConfidenceTrailDrift,\n ContextDrift,\n ContextDriftStage,\n ExecutionContext,\n} from \"./types.js\";\n\nconst VERSION = \"0.1.5\";\nconst DEFAULT_BASE_URL = \"https://xproof.app\";\nconst DEFAULT_TIMEOUT = 30_000;\n\nexport class XProofClient {\n private apiKey: string;\n private baseUrl: string;\n private timeout: number;\n\n registration: RegistrationResult | null = null;\n\n constructor(options: XProofClientOptions = {}) {\n this.apiKey = options.apiKey ?? \"\";\n this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n this.timeout = options.timeout ?? DEFAULT_TIMEOUT;\n }\n\n static async register(\n agentName: string,\n options: Omit<XProofClientOptions, \"apiKey\"> = {}\n ): Promise<XProofClient> {\n const temp = new XProofClient(options);\n const data = await temp.request(\"POST\", \"/api/agent/register\", {\n body: { agent_name: agentName },\n authRequired: false,\n });\n const result = parseRegistrationResult(data);\n const client = new XProofClient({\n ...options,\n apiKey: result.apiKey,\n });\n client.registration = result;\n return client;\n }\n\n async certify(\n path: string,\n author: string,\n fileName?: string,\n fourW?: FourWOptions\n ): Promise<Certification> {\n this.requireAuth();\n const fileHash = await hashFile(path);\n const resolvedName = fileName ?? basename(path);\n return this.certifyHash(fileHash, resolvedName, author, fourW);\n }\n\n async certifyHash(\n fileHash: string,\n fileName: string,\n author: string,\n fourW?: FourWOptions\n ): Promise<Certification> {\n this.requireAuth();\n\n const metadata: Record<string, unknown> = fourW?.metadata\n ? { ...fourW.metadata }\n : {};\n if (fourW?.who !== undefined) metadata.who = fourW.who;\n if (fourW?.what !== undefined) metadata.what = fourW.what;\n if (fourW?.when !== undefined) metadata.when = fourW.when;\n if (fourW?.why !== undefined) metadata.why = fourW.why;\n\n const payload: Record<string, unknown> = {\n filename: fileName,\n file_hash: fileHash,\n author_name: author,\n };\n if (Object.keys(metadata).length > 0) {\n payload.metadata = metadata;\n }\n\n const data = await this.request(\"POST\", \"/api/proof\", { body: payload });\n return parseCertification(data);\n }\n\n async batchCertify(files: BatchFileEntry[]): Promise<BatchResult> {\n this.requireAuth();\n\n if (files.length > 50) {\n throw new Error(\"Batch certification supports a maximum of 50 files\");\n }\n\n const entries = files.map((f) => {\n const entry: Record<string, unknown> = {\n filename: f.fileName ?? \"unknown\",\n file_hash: f.fileHash,\n };\n if (f.metadata) entry.metadata = f.metadata;\n return entry;\n });\n\n const payload: Record<string, unknown> = { files: entries };\n const author = files.find((f) => f.author)?.author;\n if (author) payload.author_name = author;\n\n const data = await this.request(\"POST\", \"/api/batch\", { body: payload });\n return parseBatchResult(data);\n }\n\n async verify(proofId: string): Promise<Certification> {\n const data = await this.request(\"GET\", `/api/proof/${proofId}`, {\n authRequired: false,\n });\n return parseCertification(data);\n }\n\n async verifyHash(fileHash: string): Promise<Certification> {\n const data = await this.request(\"GET\", `/api/proof/hash/${fileHash}`, {\n authRequired: false,\n });\n return parseCertification(data);\n }\n\n async certifyWithConfidence(\n fileHash: string,\n fileName: string,\n author: string,\n confidence: ConfidenceOptions,\n fourW?: FourWOptions\n ): Promise<Certification> {\n this.requireAuth();\n\n if (confidence.confidenceLevel < 0 || confidence.confidenceLevel > 1) {\n throw new ValidationError(\n \"confidenceLevel must be between 0.0 and 1.0\",\n {}\n );\n }\n if (!confidence.decisionId || confidence.decisionId.trim().length === 0) {\n throw new ValidationError(\"decisionId is required\", {});\n }\n\n const metadata: Record<string, unknown> = fourW?.metadata\n ? { ...fourW.metadata }\n : {};\n if (fourW?.who !== undefined) metadata.who = fourW.who;\n if (fourW?.what !== undefined) metadata.what = fourW.what;\n if (fourW?.when !== undefined) metadata.when = fourW.when;\n if (fourW?.why !== undefined) metadata.why = fourW.why;\n\n metadata.confidence_level = confidence.confidenceLevel;\n metadata.threshold_stage = confidence.thresholdStage;\n metadata.decision_id = confidence.decisionId;\n\n const payload: Record<string, unknown> = {\n filename: fileName,\n file_hash: fileHash,\n author_name: author,\n metadata,\n };\n\n const data = await this.request(\"POST\", \"/api/proof\", { body: payload });\n return parseCertification(data);\n }\n\n async getConfidenceTrail(decisionId: string): Promise<ConfidenceTrail> {\n const data = await this.request(\n \"GET\",\n `/api/confidence-trail/${encodeURIComponent(decisionId)}`,\n { authRequired: false }\n );\n\n const rawStages = (data.stages as any[]) || [];\n const stages: ConfidenceTrailStage[] = rawStages.map((s: any) => ({\n proofId: s.proof_id || \"\",\n fileName: s.file_name || \"\",\n fileHash: s.file_hash || \"\",\n confidenceLevel: s.confidence_level ?? null,\n thresholdStage: s.threshold_stage ?? null,\n author: s.author || \"\",\n blockchain: {\n transactionHash: s.blockchain?.transaction_hash || \"\",\n explorerUrl: s.blockchain?.explorer_url || \"\",\n status: s.blockchain?.status || \"\",\n },\n anchoredAt: s.anchored_at || \"\",\n metadata: s.metadata || {},\n }));\n\n const rawDrift = data.context_drift as any;\n const contextDrift: ConfidenceTrailDrift | null = rawDrift\n ? {\n contextCoherent: rawDrift.context_coherent ?? true,\n driftScore: rawDrift.drift_score ?? 0,\n fieldsMonitored: rawDrift.fields_monitored || [],\n fieldsDrifted: rawDrift.fields_drifted || [],\n fieldsStable: rawDrift.fields_stable || [],\n fieldsAbsent: rawDrift.fields_absent || [],\n }\n : null;\n\n return {\n decisionId: (data.decision_id as string) || decisionId,\n totalAnchors: (data.total_anchors as number) || stages.length,\n currentConfidence: (data.current_confidence as number) ?? null,\n currentStage: (data.current_stage as string) ?? null,\n isFinalized: (data.is_finalized as boolean) || false,\n contextDrift,\n stages,\n };\n }\n\n async getContextDrift(decisionId: string): Promise<ContextDrift> {\n const data = await this.request(\n \"GET\",\n `/api/context-drift/${encodeURIComponent(decisionId)}`,\n { authRequired: false }\n );\n\n const rawStages = (data.stages as any[]) || [];\n const stages: ContextDriftStage[] = rawStages.map((s: any) => ({\n proofId: s.proof_id || \"\",\n stageIndex: s.stage_index ?? 0,\n anchoredAt: s.anchored_at || \"\",\n executionContext: (s.execution_context || {}) as ExecutionContext,\n contextBreak: s.context_break || false,\n driftedFields: s.drifted_fields || [],\n }));\n\n return {\n decisionId: (data.decision_id as string) || decisionId,\n contextCoherent: (data.context_coherent as boolean) ?? true,\n driftScore: (data.drift_score as number) ?? 0,\n fieldsMonitored: (data.fields_monitored as string[]) || [],\n fieldsDrifted: (data.fields_drifted as string[]) || [],\n fieldsStable: (data.fields_stable as string[]) || [],\n fieldsAbsent: (data.fields_absent as string[]) || [],\n totalAnchors: (data.total_anchors as number) || stages.length,\n stages,\n };\n }\n\n async getPricing(): Promise<PricingInfo> {\n const data = await this.request(\"GET\", \"/api/pricing\", {\n authRequired: false,\n });\n return parsePricingInfo(data);\n }\n\n private requireAuth(): void {\n if (!this.apiKey) {\n throw new Error(\n \"apiKey is required — call XProofClient.register() or pass an apiKey\"\n );\n }\n }\n\n private async request(\n method: string,\n path: string,\n options: {\n body?: Record<string, unknown>;\n authRequired?: boolean;\n } = {}\n ): Promise<Record<string, unknown>> {\n const url = `${this.baseUrl}${path}`;\n const { body, authRequired = true } = options;\n\n const headers: Record<string, string> = {\n \"User-Agent\": `xproof-js/${VERSION}`,\n };\n\n if (authRequired && this.apiKey) {\n headers[\"Authorization\"] = `Bearer ${this.apiKey}`;\n }\n\n if (body) {\n headers[\"Content-Type\"] = \"application/json\";\n }\n\n const controller = new AbortController();\n const timer = setTimeout(() => controller.abort(), this.timeout);\n\n let resp: Response;\n try {\n resp = await fetch(url, {\n method,\n headers,\n body: body ? JSON.stringify(body) : undefined,\n signal: controller.signal,\n });\n } catch (err) {\n clearTimeout(timer);\n if (err instanceof DOMException && err.name === \"AbortError\") {\n throw new XProofError(`Request timed out after ${this.timeout}ms`);\n }\n throw new XProofError(`Request failed: ${(err as Error).message}`);\n } finally {\n clearTimeout(timer);\n }\n\n if (resp.status === 200 || resp.status === 201) {\n let data: Record<string, unknown>;\n try {\n data = (await resp.json()) as Record<string, unknown>;\n } catch {\n const text = await resp.text().catch(() => \"\");\n throw new XProofError(\n `Unexpected non-JSON response from ${method} ${url}: ${text.slice(0, 200)}`\n );\n }\n return data;\n }\n\n await this.handleError(resp);\n return {};\n }\n\n private async handleError(resp: Response): Promise<never> {\n let body: Record<string, unknown>;\n try {\n body = (await resp.json()) as Record<string, unknown>;\n } catch {\n body = { message: await resp.text().catch(() => \"\") };\n }\n\n const message =\n (body.message as string) || (body.error as string) || `HTTP ${resp.status}`;\n const status = resp.status;\n\n if (status === 400) throw new ValidationError(message, body);\n if (status === 401 || status === 403)\n throw new AuthenticationError(message, body);\n if (status === 404) throw new NotFoundError(message, body);\n if (status === 409)\n throw new ConflictError(\n message,\n (body.certificationId as string) || \"\",\n body\n );\n if (status === 429) throw new RateLimitError(message, body);\n if (status >= 500) throw new ServerError(message, status, body);\n throw new XProofError(message, status, body);\n }\n}\n","export class XProofError extends Error {\n statusCode: number;\n response: Record<string, unknown> | null;\n\n constructor(\n message: string,\n statusCode = 0,\n response: Record<string, unknown> | null = null\n ) {\n super(message);\n this.name = \"XProofError\";\n this.statusCode = statusCode;\n this.response = response;\n }\n}\n\nexport class AuthenticationError extends XProofError {\n constructor(\n message = \"Invalid or missing API key\",\n response: Record<string, unknown> | null = null\n ) {\n super(message, 401, response);\n this.name = \"AuthenticationError\";\n }\n}\n\nexport class ValidationError extends XProofError {\n constructor(\n message = \"Invalid request data\",\n response: Record<string, unknown> | null = null\n ) {\n super(message, 400, response);\n this.name = \"ValidationError\";\n }\n}\n\nexport class NotFoundError extends XProofError {\n constructor(\n message = \"Resource not found\",\n response: Record<string, unknown> | null = null\n ) {\n super(message, 404, response);\n this.name = \"NotFoundError\";\n }\n}\n\nexport class ConflictError extends XProofError {\n certificationId: string;\n\n constructor(\n message = \"File already certified\",\n certificationId = \"\",\n response: Record<string, unknown> | null = null\n ) {\n super(message, 409, response);\n this.name = \"ConflictError\";\n this.certificationId = certificationId;\n }\n}\n\nexport class RateLimitError extends XProofError {\n constructor(\n message = \"Rate limit exceeded\",\n response: Record<string, unknown> | null = null\n ) {\n super(message, 429, response);\n this.name = \"RateLimitError\";\n }\n}\n\nexport class ServerError extends XProofError {\n constructor(\n message = \"Internal server error\",\n statusCode = 500,\n response: Record<string, unknown> | null = null\n ) {\n super(message, statusCode, response);\n this.name = \"ServerError\";\n }\n}\n","import { createHash } from \"crypto\";\nimport { readFile } from \"fs/promises\";\n\nexport async function hashFile(path: string): Promise<string> {\n const data = await readFile(path);\n return createHash(\"sha256\").update(data).digest(\"hex\");\n}\n\nexport function hashBuffer(data: Uint8Array): string {\n return createHash(\"sha256\").update(data).digest(\"hex\");\n}\n\nexport function hashString(data: string): string {\n return createHash(\"sha256\").update(data, \"utf8\").digest(\"hex\");\n}\n","import type {\n Certification,\n BatchResult,\n BatchResultSummary,\n PricingInfo,\n PricingTier,\n RegistrationResult,\n TrialInfo,\n} from \"./types.js\";\n\nexport function parseCertification(data: Record<string, unknown>): Certification {\n const blockchain = (data.blockchain as Record<string, unknown>) || {};\n return {\n id: (data.id as string) || (data.proof_id as string) || \"\",\n fileName:\n (data.fileName as string) ||\n (data.filename as string) ||\n (data.file_name as string) ||\n \"\",\n fileHash:\n (data.fileHash as string) || (data.file_hash as string) || \"\",\n transactionHash:\n (data.transactionHash as string) ||\n (blockchain.transaction_hash as string) ||\n \"\",\n transactionUrl:\n (data.transactionUrl as string) ||\n (blockchain.explorer_url as string) ||\n \"\",\n createdAt:\n (data.createdAt as string) ||\n (data.created_at as string) ||\n (data.timestamp as string) ||\n \"\",\n authorName:\n (data.authorName as string) || (data.author_name as string) || \"\",\n blockchainStatus:\n (data.blockchainStatus as string) || (data.status as string) || \"\",\n isPublic: data.isPublic !== undefined ? !!data.isPublic : (data.is_public !== undefined ? !!data.is_public : true),\n certificateUrl:\n (data.certificateUrl as string) ||\n (data.certificate_url as string) ||\n \"\",\n verifyUrl:\n (data.verifyUrl as string) || (data.verify_url as string) || \"\",\n };\n}\n\nexport function parseBatchResult(data: Record<string, unknown>): BatchResult {\n const rawResults = (data.results as Array<Record<string, unknown>>) || [];\n const results = rawResults.map(parseCertification);\n const total = (data.total as number) ?? rawResults.length;\n const created = (data.created as number) ?? 0;\n const existing = (data.existing as number) ?? 0;\n\n const summary: BatchResultSummary = {\n total,\n created,\n existing,\n get certified() { return created; },\n get failed() { return total - created - existing; },\n };\n\n return {\n batchId: (data.batch_id as string) || \"\",\n results,\n summary,\n };\n}\n\nexport function parsePricingInfo(data: Record<string, unknown>): PricingInfo {\n const rawTiers = (data.tiers as Array<Record<string, unknown>>) || [];\n const tiers: PricingTier[] = rawTiers.map((t) => ({\n minCertifications:\n (t.min_certifications as number) ?? (t.min as number) ?? 0,\n maxCertifications:\n (t.max_certifications as number) ?? (t.max as number) ?? null,\n priceUsd: (t.price_usd as number) ?? (t.price as number) ?? 0,\n }));\n\n return {\n protocol: (data.protocol as string) || \"\",\n version: (data.version as string) || \"\",\n priceUsd:\n (data.price_usd as number) ?? (data.current_price as number) ?? 0,\n tiers,\n paymentMethods:\n (data.payment_methods as Array<Record<string, string>>) || [],\n raw: data,\n };\n}\n\nexport function parseRegistrationResult(\n data: Record<string, unknown>\n): RegistrationResult {\n const trialData = (data.trial as Record<string, unknown>) || {};\n const trial: TrialInfo = {\n quota: (trialData.quota as number) ?? 0,\n used: (trialData.used as number) ?? 0,\n remaining: (trialData.remaining as number) ?? 0,\n };\n return {\n apiKey: (data.api_key as string) || \"\",\n agentName: (data.agent_name as string) || \"\",\n trial,\n endpoints: (data.endpoints as Record<string, string>) || {},\n raw: data,\n };\n}\n"],"mappings":"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","names":[]}
|
|
1
|
+
{"version":3,"sources":["../src/index.ts","../src/client.ts","../src/errors.ts","../src/hash.ts","../src/parse.ts"],"sourcesContent":["export { XProofClient } from \"./client.js\";\nexport {\n XProofError,\n AuthenticationError,\n ValidationError,\n NotFoundError,\n ConflictError,\n RateLimitError,\n ServerError,\n} from \"./errors.js\";\nexport type {\n Certification,\n BatchResult,\n BatchResultSummary,\n PricingInfo,\n PricingTier,\n RegistrationResult,\n TrialInfo,\n FourWOptions,\n CertifyHashOptions,\n BatchFileEntry,\n XProofClientOptions,\n ThresholdStage,\n ReversibilityClass,\n ConfidenceOptions,\n ConfidenceTrail,\n ConfidenceTrailStage,\n ConfidenceTrailDrift,\n PolicyViolation,\n PolicyCheckResult,\n ExecutionContext,\n ContextDriftStage,\n ContextDrift,\n} from \"./types.js\";\nexport { hashFile, hashBuffer, hashString } from \"./hash.js\";\n","import { basename } from \"path\";\nimport {\n XProofError,\n AuthenticationError,\n ValidationError,\n NotFoundError,\n ConflictError,\n RateLimitError,\n ServerError,\n} from \"./errors.js\";\nimport { hashFile } from \"./hash.js\";\nimport {\n parseCertification,\n parseBatchResult,\n parsePricingInfo,\n parseRegistrationResult,\n} from \"./parse.js\";\nimport type {\n Certification,\n BatchResult,\n PricingInfo,\n RegistrationResult,\n FourWOptions,\n BatchFileEntry,\n XProofClientOptions,\n ConfidenceOptions,\n ConfidenceTrail,\n ConfidenceTrailStage,\n ConfidenceTrailDrift,\n ContextDrift,\n ContextDriftStage,\n ExecutionContext,\n PolicyViolation,\n PolicyCheckResult,\n ReversibilityClass,\n} from \"./types.js\";\n\nconst VERSION = \"0.1.7\";\nconst DEFAULT_BASE_URL = \"https://xproof.app\";\nconst DEFAULT_TIMEOUT = 30_000;\n\nexport class XProofClient {\n private apiKey: string;\n private baseUrl: string;\n private timeout: number;\n\n registration: RegistrationResult | null = null;\n\n constructor(options: XProofClientOptions = {}) {\n this.apiKey = options.apiKey ?? \"\";\n this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n this.timeout = options.timeout ?? DEFAULT_TIMEOUT;\n }\n\n static async register(\n agentName: string,\n options: Omit<XProofClientOptions, \"apiKey\"> = {}\n ): Promise<XProofClient> {\n const temp = new XProofClient(options);\n const data = await temp.request(\"POST\", \"/api/agent/register\", {\n body: { agent_name: agentName },\n authRequired: false,\n });\n const result = parseRegistrationResult(data);\n const client = new XProofClient({\n ...options,\n apiKey: result.apiKey,\n });\n client.registration = result;\n return client;\n }\n\n async certify(\n path: string,\n author: string,\n fileName?: string,\n fourW?: FourWOptions\n ): Promise<Certification> {\n this.requireAuth();\n const fileHash = await hashFile(path);\n const resolvedName = fileName ?? basename(path);\n return this.certifyHash(fileHash, resolvedName, author, fourW);\n }\n\n async certifyHash(\n fileHash: string,\n fileName: string,\n author: string,\n fourW?: FourWOptions\n ): Promise<Certification> {\n this.requireAuth();\n\n const metadata: Record<string, unknown> = fourW?.metadata\n ? { ...fourW.metadata }\n : {};\n if (fourW?.who !== undefined) metadata.who = fourW.who;\n if (fourW?.what !== undefined) metadata.what = fourW.what;\n if (fourW?.when !== undefined) metadata.when = fourW.when;\n if (fourW?.why !== undefined) metadata.why = fourW.why;\n if (fourW?.reversibilityClass !== undefined)\n metadata.reversibility_class = fourW.reversibilityClass;\n\n const payload: Record<string, unknown> = {\n filename: fileName,\n file_hash: fileHash,\n author_name: author,\n };\n if (Object.keys(metadata).length > 0) {\n payload.metadata = metadata;\n }\n\n const data = await this.request(\"POST\", \"/api/proof\", { body: payload });\n return parseCertification(data);\n }\n\n async batchCertify(files: BatchFileEntry[]): Promise<BatchResult> {\n this.requireAuth();\n\n if (files.length > 50) {\n throw new Error(\"Batch certification supports a maximum of 50 files\");\n }\n\n const entries = files.map((f) => {\n const entry: Record<string, unknown> = {\n filename: f.fileName ?? \"unknown\",\n file_hash: f.fileHash,\n };\n if (f.metadata) entry.metadata = f.metadata;\n return entry;\n });\n\n const payload: Record<string, unknown> = { files: entries };\n const author = files.find((f) => f.author)?.author;\n if (author) payload.author_name = author;\n\n const data = await this.request(\"POST\", \"/api/batch\", { body: payload });\n return parseBatchResult(data);\n }\n\n async verify(proofId: string): Promise<Certification> {\n const data = await this.request(\"GET\", `/api/proof/${proofId}`, {\n authRequired: false,\n });\n return parseCertification(data);\n }\n\n async verifyHash(fileHash: string): Promise<Certification> {\n const data = await this.request(\"GET\", `/api/proof/hash/${fileHash}`, {\n authRequired: false,\n });\n return parseCertification(data);\n }\n\n async certifyWithConfidence(\n fileHash: string,\n fileName: string,\n author: string,\n confidence: ConfidenceOptions,\n fourW?: FourWOptions\n ): Promise<Certification> {\n this.requireAuth();\n\n if (confidence.confidenceLevel < 0 || confidence.confidenceLevel > 1) {\n throw new ValidationError(\n \"confidenceLevel must be between 0.0 and 1.0\",\n {}\n );\n }\n if (!confidence.decisionId || confidence.decisionId.trim().length === 0) {\n throw new ValidationError(\"decisionId is required\", {});\n }\n\n const metadata: Record<string, unknown> = fourW?.metadata\n ? { ...fourW.metadata }\n : {};\n if (fourW?.who !== undefined) metadata.who = fourW.who;\n if (fourW?.what !== undefined) metadata.what = fourW.what;\n if (fourW?.when !== undefined) metadata.when = fourW.when;\n if (fourW?.why !== undefined) metadata.why = fourW.why;\n if (fourW?.reversibilityClass !== undefined)\n metadata.reversibility_class = fourW.reversibilityClass;\n\n metadata.confidence_level = confidence.confidenceLevel;\n metadata.threshold_stage = confidence.thresholdStage;\n metadata.decision_id = confidence.decisionId;\n // confidence.reversibilityClass takes priority over fourW.reversibilityClass\n if (confidence.reversibilityClass !== undefined)\n metadata.reversibility_class = confidence.reversibilityClass;\n\n const payload: Record<string, unknown> = {\n filename: fileName,\n file_hash: fileHash,\n author_name: author,\n metadata,\n };\n\n const data = await this.request(\"POST\", \"/api/proof\", { body: payload });\n return parseCertification(data);\n }\n\n async getConfidenceTrail(decisionId: string): Promise<ConfidenceTrail> {\n const data = await this.request(\n \"GET\",\n `/api/confidence-trail/${encodeURIComponent(decisionId)}`,\n { authRequired: false }\n );\n\n const rawStages = (data.stages as any[]) || [];\n const stages: ConfidenceTrailStage[] = rawStages.map((s: any) => ({\n proofId: s.proof_id || \"\",\n fileName: s.file_name || \"\",\n fileHash: s.file_hash || \"\",\n confidenceLevel: s.confidence_level ?? null,\n thresholdStage: s.threshold_stage ?? null,\n reversibilityClass: (s.metadata?.reversibility_class ?? null) as ReversibilityClass | null,\n author: s.author || \"\",\n blockchain: {\n transactionHash: s.blockchain?.transaction_hash || \"\",\n explorerUrl: s.blockchain?.explorer_url || \"\",\n status: s.blockchain?.status || \"\",\n },\n anchoredAt: s.anchored_at || \"\",\n metadata: s.metadata || {},\n }));\n\n const rawDrift = data.context_drift as any;\n const contextDrift: ConfidenceTrailDrift | null = rawDrift\n ? {\n contextCoherent: rawDrift.context_coherent ?? true,\n driftScore: rawDrift.drift_score ?? 0,\n fieldsMonitored: rawDrift.fields_monitored || [],\n fieldsDrifted: rawDrift.fields_drifted || [],\n fieldsStable: rawDrift.fields_stable || [],\n fieldsAbsent: rawDrift.fields_absent || [],\n }\n : null;\n\n const rawViolations = (data.policy_violations as any[]) || [];\n const policyViolations: PolicyViolation[] = rawViolations.map((v: any) => ({\n proofId: v.proof_id || \"\",\n confidenceLevel: v.confidence_level ?? null,\n reversibilityClass: v.reversibility_class as ReversibilityClass,\n thresholdStage: v.threshold_stage ?? null,\n threshold: v.threshold ?? 0.95,\n rule: v.rule || \"\",\n }));\n\n return {\n decisionId: (data.decision_id as string) || decisionId,\n totalAnchors: (data.total_anchors as number) || stages.length,\n currentConfidence: (data.current_confidence as number) ?? null,\n currentStage: (data.current_stage as string) ?? null,\n isFinalized: (data.is_finalized as boolean) || false,\n policyCompliant: (data.policy_compliant as boolean) ?? true,\n policyViolations,\n contextDrift,\n stages,\n };\n }\n\n async getContextDrift(decisionId: string): Promise<ContextDrift> {\n const data = await this.request(\n \"GET\",\n `/api/context-drift/${encodeURIComponent(decisionId)}`,\n { authRequired: false }\n );\n\n const rawStages = (data.stages as any[]) || [];\n const stages: ContextDriftStage[] = rawStages.map((s: any) => ({\n proofId: s.proof_id || \"\",\n stageIndex: s.stage_index ?? 0,\n anchoredAt: s.anchored_at || \"\",\n executionContext: (s.execution_context || {}) as ExecutionContext,\n contextBreak: s.context_break || false,\n driftedFields: s.drifted_fields || [],\n }));\n\n return {\n decisionId: (data.decision_id as string) || decisionId,\n contextCoherent: (data.context_coherent as boolean) ?? true,\n driftScore: (data.drift_score as number) ?? 0,\n fieldsMonitored: (data.fields_monitored as string[]) || [],\n fieldsDrifted: (data.fields_drifted as string[]) || [],\n fieldsStable: (data.fields_stable as string[]) || [],\n fieldsAbsent: (data.fields_absent as string[]) || [],\n totalAnchors: (data.total_anchors as number) || stages.length,\n stages,\n };\n }\n\n async getPricing(): Promise<PricingInfo> {\n const data = await this.request(\"GET\", \"/api/pricing\", {\n authRequired: false,\n });\n return parsePricingInfo(data);\n }\n\n private requireAuth(): void {\n if (!this.apiKey) {\n throw new Error(\n \"apiKey is required — call XProofClient.register() or pass an apiKey\"\n );\n }\n }\n\n /**\n * Check policy compliance for a decision chain without fetching the full trail.\n *\n * Calls `GET /api/proofs/policy-check?decision_id=<id>` and returns a lightweight\n * compliance report: whether the chain is policy-compliant and any violations found.\n *\n * @param decisionId - The shared decision chain identifier.\n * @returns A `PolicyCheckResult` with `policyCompliant`, `policyViolations`, and metadata.\n */\n async getPolicyCheck(decisionId: string): Promise<PolicyCheckResult> {\n if (!decisionId || !decisionId.trim()) {\n throw new ValidationError(\"decisionId is required\", {});\n }\n const data = await this.request(\n \"GET\",\n `/api/proofs/policy-check?decision_id=${encodeURIComponent(decisionId)}`,\n { authRequired: false }\n );\n const violations = ((data.policy_violations as unknown[]) ?? []).map(\n (v) => {\n const vv = v as Record<string, unknown>;\n return {\n proofId: (vv.proof_id as string) ?? \"\",\n confidenceLevel:\n vv.confidence_level != null\n ? (vv.confidence_level as number)\n : null,\n reversibilityClass:\n (vv.reversibility_class as ReversibilityClass) ?? \"reversible\",\n thresholdStage:\n vv.threshold_stage != null\n ? (vv.threshold_stage as string)\n : null,\n threshold: (vv.threshold as number) ?? 0,\n rule: (vv.rule as string) ?? \"\",\n } satisfies PolicyViolation;\n }\n );\n return {\n decisionId: (data.decision_id as string) ?? decisionId,\n totalAnchors: (data.total_anchors as number) ?? 0,\n policyCompliant: (data.policy_compliant as boolean) ?? true,\n policyViolations: violations,\n checkedAt: (data.checked_at as string) ?? \"\",\n raw: data,\n };\n }\n\n private async request(\n method: string,\n path: string,\n options: {\n body?: Record<string, unknown>;\n authRequired?: boolean;\n } = {}\n ): Promise<Record<string, unknown>> {\n const url = `${this.baseUrl}${path}`;\n const { body, authRequired = true } = options;\n\n const headers: Record<string, string> = {\n \"User-Agent\": `xproof-js/${VERSION}`,\n };\n\n if (authRequired && this.apiKey) {\n headers[\"Authorization\"] = `Bearer ${this.apiKey}`;\n }\n\n if (body) {\n headers[\"Content-Type\"] = \"application/json\";\n }\n\n const controller = new AbortController();\n const timer = setTimeout(() => controller.abort(), this.timeout);\n\n let resp: Response;\n try {\n resp = await fetch(url, {\n method,\n headers,\n body: body ? JSON.stringify(body) : undefined,\n signal: controller.signal,\n });\n } catch (err) {\n clearTimeout(timer);\n if (err instanceof DOMException && err.name === \"AbortError\") {\n throw new XProofError(`Request timed out after ${this.timeout}ms`);\n }\n throw new XProofError(`Request failed: ${(err as Error).message}`);\n } finally {\n clearTimeout(timer);\n }\n\n if (resp.status === 200 || resp.status === 201) {\n let data: Record<string, unknown>;\n try {\n data = (await resp.json()) as Record<string, unknown>;\n } catch {\n const text = await resp.text().catch(() => \"\");\n throw new XProofError(\n `Unexpected non-JSON response from ${method} ${url}: ${text.slice(0, 200)}`\n );\n }\n return data;\n }\n\n await this.handleError(resp);\n return {};\n }\n\n private async handleError(resp: Response): Promise<never> {\n let body: Record<string, unknown>;\n try {\n body = (await resp.json()) as Record<string, unknown>;\n } catch {\n body = { message: await resp.text().catch(() => \"\") };\n }\n\n const message =\n (body.message as string) || (body.error as string) || `HTTP ${resp.status}`;\n const status = resp.status;\n\n if (status === 400) throw new ValidationError(message, body);\n if (status === 401 || status === 403)\n throw new AuthenticationError(message, body);\n if (status === 404) throw new NotFoundError(message, body);\n if (status === 409)\n throw new ConflictError(\n message,\n (body.certificationId as string) || \"\",\n body\n );\n if (status === 429) throw new RateLimitError(message, body);\n if (status >= 500) throw new ServerError(message, status, body);\n throw new XProofError(message, status, body);\n }\n}\n","export class XProofError extends Error {\n statusCode: number;\n response: Record<string, unknown> | null;\n\n constructor(\n message: string,\n statusCode = 0,\n response: Record<string, unknown> | null = null\n ) {\n super(message);\n this.name = \"XProofError\";\n this.statusCode = statusCode;\n this.response = response;\n }\n}\n\nexport class AuthenticationError extends XProofError {\n constructor(\n message = \"Invalid or missing API key\",\n response: Record<string, unknown> | null = null\n ) {\n super(message, 401, response);\n this.name = \"AuthenticationError\";\n }\n}\n\nexport class ValidationError extends XProofError {\n constructor(\n message = \"Invalid request data\",\n response: Record<string, unknown> | null = null\n ) {\n super(message, 400, response);\n this.name = \"ValidationError\";\n }\n}\n\nexport class NotFoundError extends XProofError {\n constructor(\n message = \"Resource not found\",\n response: Record<string, unknown> | null = null\n ) {\n super(message, 404, response);\n this.name = \"NotFoundError\";\n }\n}\n\nexport class ConflictError extends XProofError {\n certificationId: string;\n\n constructor(\n message = \"File already certified\",\n certificationId = \"\",\n response: Record<string, unknown> | null = null\n ) {\n super(message, 409, response);\n this.name = \"ConflictError\";\n this.certificationId = certificationId;\n }\n}\n\nexport class RateLimitError extends XProofError {\n constructor(\n message = \"Rate limit exceeded\",\n response: Record<string, unknown> | null = null\n ) {\n super(message, 429, response);\n this.name = \"RateLimitError\";\n }\n}\n\nexport class ServerError extends XProofError {\n constructor(\n message = \"Internal server error\",\n statusCode = 500,\n response: Record<string, unknown> | null = null\n ) {\n super(message, statusCode, response);\n this.name = \"ServerError\";\n }\n}\n","import { createHash } from \"crypto\";\nimport { readFile } from \"fs/promises\";\n\nexport async function hashFile(path: string): Promise<string> {\n const data = await readFile(path);\n return createHash(\"sha256\").update(data).digest(\"hex\");\n}\n\nexport function hashBuffer(data: Uint8Array): string {\n return createHash(\"sha256\").update(data).digest(\"hex\");\n}\n\nexport function hashString(data: string): string {\n return createHash(\"sha256\").update(data, \"utf8\").digest(\"hex\");\n}\n","import type {\n Certification,\n BatchResult,\n BatchResultSummary,\n PricingInfo,\n PricingTier,\n RegistrationResult,\n TrialInfo,\n} from \"./types.js\";\n\nexport function parseCertification(data: Record<string, unknown>): Certification {\n const blockchain = (data.blockchain as Record<string, unknown>) || {};\n return {\n id: (data.id as string) || (data.proof_id as string) || \"\",\n fileName:\n (data.fileName as string) ||\n (data.filename as string) ||\n (data.file_name as string) ||\n \"\",\n fileHash:\n (data.fileHash as string) || (data.file_hash as string) || \"\",\n transactionHash:\n (data.transactionHash as string) ||\n (blockchain.transaction_hash as string) ||\n \"\",\n transactionUrl:\n (data.transactionUrl as string) ||\n (blockchain.explorer_url as string) ||\n \"\",\n createdAt:\n (data.createdAt as string) ||\n (data.created_at as string) ||\n (data.timestamp as string) ||\n \"\",\n authorName:\n (data.authorName as string) || (data.author_name as string) || \"\",\n blockchainStatus:\n (data.blockchainStatus as string) || (data.status as string) || \"\",\n isPublic: data.isPublic !== undefined ? !!data.isPublic : (data.is_public !== undefined ? !!data.is_public : true),\n certificateUrl:\n (data.certificateUrl as string) ||\n (data.certificate_url as string) ||\n \"\",\n verifyUrl:\n (data.verifyUrl as string) || (data.verify_url as string) || \"\",\n };\n}\n\nexport function parseBatchResult(data: Record<string, unknown>): BatchResult {\n const rawResults = (data.results as Array<Record<string, unknown>>) || [];\n const results = rawResults.map(parseCertification);\n const total = (data.total as number) ?? rawResults.length;\n const created = (data.created as number) ?? 0;\n const existing = (data.existing as number) ?? 0;\n\n const summary: BatchResultSummary = {\n total,\n created,\n existing,\n get certified() { return created; },\n get failed() { return total - created - existing; },\n };\n\n return {\n batchId: (data.batch_id as string) || \"\",\n results,\n summary,\n };\n}\n\nexport function parsePricingInfo(data: Record<string, unknown>): PricingInfo {\n const rawTiers = (data.tiers as Array<Record<string, unknown>>) || [];\n const tiers: PricingTier[] = rawTiers.map((t) => ({\n minCertifications:\n (t.min_certifications as number) ?? (t.min as number) ?? 0,\n maxCertifications:\n (t.max_certifications as number) ?? (t.max as number) ?? null,\n priceUsd: (t.price_usd as number) ?? (t.price as number) ?? 0,\n }));\n\n return {\n protocol: (data.protocol as string) || \"\",\n version: (data.version as string) || \"\",\n priceUsd:\n (data.price_usd as number) ?? (data.current_price as number) ?? 0,\n tiers,\n paymentMethods:\n (data.payment_methods as Array<Record<string, string>>) || [],\n raw: data,\n };\n}\n\nexport function parseRegistrationResult(\n data: Record<string, unknown>\n): RegistrationResult {\n const trialData = (data.trial as Record<string, unknown>) || {};\n const trial: TrialInfo = {\n quota: (trialData.quota as number) ?? 0,\n used: (trialData.used as number) ?? 0,\n remaining: (trialData.remaining as number) ?? 0,\n };\n return {\n apiKey: (data.api_key as string) || \"\",\n agentName: (data.agent_name as string) || \"\",\n trial,\n endpoints: (data.endpoints as Record<string, string>) || {},\n raw: data,\n };\n}\n"],"mappings":"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","names":[]}
|
package/dist/index.mjs
CHANGED
|
@@ -135,7 +135,7 @@ function parseRegistrationResult(data) {
|
|
|
135
135
|
}
|
|
136
136
|
|
|
137
137
|
// src/client.ts
|
|
138
|
-
var VERSION = "0.1.
|
|
138
|
+
var VERSION = "0.1.7";
|
|
139
139
|
var DEFAULT_BASE_URL = "https://xproof.app";
|
|
140
140
|
var DEFAULT_TIMEOUT = 3e4;
|
|
141
141
|
var XProofClient = class _XProofClient {
|
|
@@ -172,6 +172,8 @@ var XProofClient = class _XProofClient {
|
|
|
172
172
|
if (fourW?.what !== void 0) metadata.what = fourW.what;
|
|
173
173
|
if (fourW?.when !== void 0) metadata.when = fourW.when;
|
|
174
174
|
if (fourW?.why !== void 0) metadata.why = fourW.why;
|
|
175
|
+
if (fourW?.reversibilityClass !== void 0)
|
|
176
|
+
metadata.reversibility_class = fourW.reversibilityClass;
|
|
175
177
|
const payload = {
|
|
176
178
|
filename: fileName,
|
|
177
179
|
file_hash: fileHash,
|
|
@@ -230,9 +232,13 @@ var XProofClient = class _XProofClient {
|
|
|
230
232
|
if (fourW?.what !== void 0) metadata.what = fourW.what;
|
|
231
233
|
if (fourW?.when !== void 0) metadata.when = fourW.when;
|
|
232
234
|
if (fourW?.why !== void 0) metadata.why = fourW.why;
|
|
235
|
+
if (fourW?.reversibilityClass !== void 0)
|
|
236
|
+
metadata.reversibility_class = fourW.reversibilityClass;
|
|
233
237
|
metadata.confidence_level = confidence.confidenceLevel;
|
|
234
238
|
metadata.threshold_stage = confidence.thresholdStage;
|
|
235
239
|
metadata.decision_id = confidence.decisionId;
|
|
240
|
+
if (confidence.reversibilityClass !== void 0)
|
|
241
|
+
metadata.reversibility_class = confidence.reversibilityClass;
|
|
236
242
|
const payload = {
|
|
237
243
|
filename: fileName,
|
|
238
244
|
file_hash: fileHash,
|
|
@@ -255,6 +261,7 @@ var XProofClient = class _XProofClient {
|
|
|
255
261
|
fileHash: s.file_hash || "",
|
|
256
262
|
confidenceLevel: s.confidence_level ?? null,
|
|
257
263
|
thresholdStage: s.threshold_stage ?? null,
|
|
264
|
+
reversibilityClass: s.metadata?.reversibility_class ?? null,
|
|
258
265
|
author: s.author || "",
|
|
259
266
|
blockchain: {
|
|
260
267
|
transactionHash: s.blockchain?.transaction_hash || "",
|
|
@@ -273,12 +280,23 @@ var XProofClient = class _XProofClient {
|
|
|
273
280
|
fieldsStable: rawDrift.fields_stable || [],
|
|
274
281
|
fieldsAbsent: rawDrift.fields_absent || []
|
|
275
282
|
} : null;
|
|
283
|
+
const rawViolations = data.policy_violations || [];
|
|
284
|
+
const policyViolations = rawViolations.map((v) => ({
|
|
285
|
+
proofId: v.proof_id || "",
|
|
286
|
+
confidenceLevel: v.confidence_level ?? null,
|
|
287
|
+
reversibilityClass: v.reversibility_class,
|
|
288
|
+
thresholdStage: v.threshold_stage ?? null,
|
|
289
|
+
threshold: v.threshold ?? 0.95,
|
|
290
|
+
rule: v.rule || ""
|
|
291
|
+
}));
|
|
276
292
|
return {
|
|
277
293
|
decisionId: data.decision_id || decisionId,
|
|
278
294
|
totalAnchors: data.total_anchors || stages.length,
|
|
279
295
|
currentConfidence: data.current_confidence ?? null,
|
|
280
296
|
currentStage: data.current_stage ?? null,
|
|
281
297
|
isFinalized: data.is_finalized || false,
|
|
298
|
+
policyCompliant: data.policy_compliant ?? true,
|
|
299
|
+
policyViolations,
|
|
282
300
|
contextDrift,
|
|
283
301
|
stages
|
|
284
302
|
};
|
|
@@ -323,6 +341,46 @@ var XProofClient = class _XProofClient {
|
|
|
323
341
|
);
|
|
324
342
|
}
|
|
325
343
|
}
|
|
344
|
+
/**
|
|
345
|
+
* Check policy compliance for a decision chain without fetching the full trail.
|
|
346
|
+
*
|
|
347
|
+
* Calls `GET /api/proofs/policy-check?decision_id=<id>` and returns a lightweight
|
|
348
|
+
* compliance report: whether the chain is policy-compliant and any violations found.
|
|
349
|
+
*
|
|
350
|
+
* @param decisionId - The shared decision chain identifier.
|
|
351
|
+
* @returns A `PolicyCheckResult` with `policyCompliant`, `policyViolations`, and metadata.
|
|
352
|
+
*/
|
|
353
|
+
async getPolicyCheck(decisionId) {
|
|
354
|
+
if (!decisionId || !decisionId.trim()) {
|
|
355
|
+
throw new ValidationError("decisionId is required", {});
|
|
356
|
+
}
|
|
357
|
+
const data = await this.request(
|
|
358
|
+
"GET",
|
|
359
|
+
`/api/proofs/policy-check?decision_id=${encodeURIComponent(decisionId)}`,
|
|
360
|
+
{ authRequired: false }
|
|
361
|
+
);
|
|
362
|
+
const violations = (data.policy_violations ?? []).map(
|
|
363
|
+
(v) => {
|
|
364
|
+
const vv = v;
|
|
365
|
+
return {
|
|
366
|
+
proofId: vv.proof_id ?? "",
|
|
367
|
+
confidenceLevel: vv.confidence_level != null ? vv.confidence_level : null,
|
|
368
|
+
reversibilityClass: vv.reversibility_class ?? "reversible",
|
|
369
|
+
thresholdStage: vv.threshold_stage != null ? vv.threshold_stage : null,
|
|
370
|
+
threshold: vv.threshold ?? 0,
|
|
371
|
+
rule: vv.rule ?? ""
|
|
372
|
+
};
|
|
373
|
+
}
|
|
374
|
+
);
|
|
375
|
+
return {
|
|
376
|
+
decisionId: data.decision_id ?? decisionId,
|
|
377
|
+
totalAnchors: data.total_anchors ?? 0,
|
|
378
|
+
policyCompliant: data.policy_compliant ?? true,
|
|
379
|
+
policyViolations: violations,
|
|
380
|
+
checkedAt: data.checked_at ?? "",
|
|
381
|
+
raw: data
|
|
382
|
+
};
|
|
383
|
+
}
|
|
326
384
|
async request(method, path, options = {}) {
|
|
327
385
|
const url = `${this.baseUrl}${path}`;
|
|
328
386
|
const { body, authRequired = true } = options;
|