@unbrained/pm-http 0.0.0-stage → 2026.10.29

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 (47) hide show
  1. package/ARCHITECTURE.md +59 -0
  2. package/CHANGELOG.md +24 -0
  3. package/LICENSE +21 -0
  4. package/README.md +186 -2
  5. package/dist/index.d.ts +116 -0
  6. package/dist/index.d.ts.map +1 -0
  7. package/dist/index.js +30 -0
  8. package/dist/index.js.map +1 -0
  9. package/dist/src/api.d.ts +56 -0
  10. package/dist/src/api.d.ts.map +1 -0
  11. package/dist/src/api.js +200 -0
  12. package/dist/src/api.js.map +1 -0
  13. package/dist/src/capture.d.ts +23 -0
  14. package/dist/src/capture.d.ts.map +1 -0
  15. package/dist/src/capture.js +113 -0
  16. package/dist/src/capture.js.map +1 -0
  17. package/dist/src/commands.d.ts +6 -0
  18. package/dist/src/commands.d.ts.map +1 -0
  19. package/dist/src/commands.js +84 -0
  20. package/dist/src/commands.js.map +1 -0
  21. package/dist/src/core.d.ts +36 -0
  22. package/dist/src/core.d.ts.map +1 -0
  23. package/dist/src/core.js +75 -0
  24. package/dist/src/core.js.map +1 -0
  25. package/dist/src/derive.d.ts +62 -0
  26. package/dist/src/derive.d.ts.map +1 -0
  27. package/dist/src/derive.js +139 -0
  28. package/dist/src/derive.js.map +1 -0
  29. package/dist/src/policy.d.ts +29 -0
  30. package/dist/src/policy.d.ts.map +1 -0
  31. package/dist/src/policy.js +137 -0
  32. package/dist/src/policy.js.map +1 -0
  33. package/dist/src/store.d.ts +42 -0
  34. package/dist/src/store.d.ts.map +1 -0
  35. package/dist/src/store.js +124 -0
  36. package/dist/src/store.js.map +1 -0
  37. package/dist/src/transport.d.ts +9 -0
  38. package/dist/src/transport.d.ts.map +1 -0
  39. package/dist/src/transport.js +144 -0
  40. package/dist/src/transport.js.map +1 -0
  41. package/dist/src/types.d.ts +140 -0
  42. package/dist/src/types.d.ts.map +1 -0
  43. package/dist/src/types.js +2 -0
  44. package/dist/src/types.js.map +1 -0
  45. package/docs/real-data.md +20 -0
  46. package/manifest.json +14 -0
  47. package/package.json +150 -4
@@ -0,0 +1,200 @@
1
+ import { randomUUID } from 'node:crypto';
2
+ import { contractShape } from './capture.js';
3
+ import { digest, HttpError, label, requireInput, bound } from './core.js';
4
+ import { makeProbe, requestFor } from './policy.js';
5
+ import { capture, uncertain } from './transport.js';
6
+ import { Store, assertRevision, capacity, targetDigest, RESPONSE_RESERVATION } from './store.js';
7
+ /** Locate a canonical probe with prototype-safe lookup. */
8
+ export function probeFrom(value, name) { const probe = value.probes.find(entry => entry.name === label(name)); if (probe === undefined)
9
+ throw new HttpError('probe_missing', 'Declared probe does not exist', 'Run pm http probe add for this task'); return probe; }
10
+ /** Bind effect admission to the original caller policy, identity and lifecycle, never mutable guard selectors. */
11
+ export function assertPlanGuard(value, entry, original, callerRevision, phase, sourceDigest) {
12
+ if (entry === undefined || entry.id !== original.id || entry.probe !== original.probe || entry.probeDigest !== original.probeDigest || entry.stage !== (phase === 1 ? 'planned' : 'sending') || entry.observation !== undefined || phase === 2 && entry.reservedBytes !== RESPONSE_RESERVATION - 1024 || entry.targetDigest !== original.targetDigest || callerRevision === undefined && (entry.expectedRevision !== undefined || entry.guardRevision !== undefined || entry.targetDigest !== undefined))
13
+ throw new HttpError('conflict', 'Send journal policy or identity changed', 'Inspect the current journal and declare a new operation', { reason: 'stale_revision' });
14
+ if (callerRevision !== undefined) {
15
+ assertRevision(entry.expectedRevision ?? -1, callerRevision);
16
+ assertRevision(entry.guardRevision ?? -1, callerRevision + phase);
17
+ assertRevision(value.revision, callerRevision + phase);
18
+ if (sourceDigest !== original.targetDigest)
19
+ throw new HttpError('conflict', 'Native target changed after planning', 'Read current context and declare a new operation', { reason: 'stale_revision' });
20
+ }
21
+ }
22
+ /** Share operation identity, guard and recording-capacity admission between preview and apply. */
23
+ export function admitPlan(value, probe, id, expectedRevision, sourceDigest) {
24
+ requireInput(/^[a-zA-Z0-9_-]{1,64}$/.test(id), 'Operation identity must be a short identifier');
25
+ const previous = value.plans.find(entry => entry.id === id);
26
+ if (previous !== undefined) {
27
+ requireInput(previous.probeDigest === digest(probe) && previous.probe === probe.name, 'Operation already belongs to another declaration');
28
+ if (expectedRevision !== undefined)
29
+ assertRevision(expectedRevision, previous.expectedRevision ?? -1);
30
+ if (previous.stage === 'cancelled')
31
+ throw new HttpError('cancelled', 'Operation was cancelled or refused without an observation', 'Inspect the refusal and use a new operation identity');
32
+ if (previous.stage === 'planned')
33
+ capacity({ ...value, plans: value.plans.map(plan => plan === previous ? { ...plan, reservedBytes: RESPONSE_RESERVATION } : plan) });
34
+ return false;
35
+ }
36
+ assertRevision(value.revision, expectedRevision);
37
+ value.plans.push({ id, probe: probe.name, probeDigest: digest(probe), stage: 'planned', reservedBytes: RESPONSE_RESERVATION, ...(expectedRevision === undefined ? {} : { expectedRevision, guardRevision: value.revision + 1, targetDigest: sourceDigest }) });
38
+ capacity({ ...value, revision: value.revision + 1 });
39
+ return true;
40
+ }
41
+ /** Declare an immutable request bound to an existing native task. */
42
+ export async function addProbe(item, name, input, options) {
43
+ const probe = makeProbe(name, input);
44
+ const store = new Store(options);
45
+ const value = await store.change(item, async (current) => { const existing = current.probes.find(entry => entry.name === probe.name); if (existing !== undefined) {
46
+ requireInput(digest({ ...existing, review: undefined }) === digest(probe), 'Probe name already declares a different request; use a new name');
47
+ return false;
48
+ } current.probes.push(probe); capacity({ ...current, revision: current.revision + 1 }); await store.register(); return true; }, 'Declared HTTP probe; environment references only', [`path=${probe.url},scope=project`]);
49
+ return { probe, revision: value.revision };
50
+ }
51
+ /** Record separate mutation review with attributed author and an explicit reason. */
52
+ export async function reviewProbe(item, name, reason, options) {
53
+ requireInput(reason.trim().length >= 8 && reason.length <= 256 && /^[a-zA-Z .,;:-]+$/.test(reason), 'Review reason must be 8 to 256 plain prose characters without secret values');
54
+ const store = new Store(options);
55
+ store.writable();
56
+ const author = await store.author();
57
+ const value = await store.change(item, current => { const probe = probeFrom(current, name); if (probe.review !== undefined) {
58
+ requireInput(probe.review.author === author && probe.review.reason === reason, 'Mutation review already exists with a different identity or reason');
59
+ if (probe.review.allowMutation === true)
60
+ return false;
61
+ } probe.review = { allowMutation: true, author, reason, at: new Date().toISOString() }; return true; }, 'Recorded explicit reviewed HTTP mutation capability');
62
+ return { probe: probeFrom(value, name), revision: value.revision };
63
+ }
64
+ /** List complete declarations with a source-completeness receipt. */
65
+ export async function listProbes(item, options) { const { value } = await new Store(options).read(item); return { revision: value.revision, probes: value.probes, receipt: { complete: true, omitted: 0 } }; }
66
+ /** Preview the same request planner used by send, without resolving credentials or writing. */
67
+ export async function preview(item, name, options) {
68
+ const { value, item: target } = await new Store(options).read(item);
69
+ const probe = probeFrom(value, name);
70
+ const request = requestFor(probe, false);
71
+ const operation = options.operationId ?? randomUUID();
72
+ admitPlan(structuredClone(value), probe, operation, options.expectedRevision, targetDigest(target, operation));
73
+ const previous = value.plans.find(entry => entry.id === operation);
74
+ if (previous?.stage === 'planned')
75
+ assertPlanGuard(value, previous, previous, options.expectedRevision ?? previous.expectedRevision, 1, targetDigest(target, operation));
76
+ return { operation: options.operationId, willSend: previous === undefined || previous.stage === 'planned', revision: value.revision, method: probe.method, url: request.url.href, headers: request.headers, body: probe.body, boundary: probe.boundary, maxBytes: probe.maxBytes, timeoutMs: probe.timeoutMs, credentials: 'environment names only' };
77
+ }
78
+ /** Send using a durable intent; uncertain interrupted sends converge without replaying the request. */
79
+ export async function send(item, name, options) {
80
+ const store = new Store(options);
81
+ store.writable();
82
+ const id = options.operationId ?? randomUUID();
83
+ const initial = await store.read(item);
84
+ const probe = probeFrom(initial.value, name);
85
+ requestFor(probe, false);
86
+ admitPlan(structuredClone(initial.value), probe, id, options.expectedRevision, targetDigest(initial.item, id));
87
+ // Invocation guards survive in the journal; subsequent writes merge only within their admission policy.
88
+ const journal = new Store({ ...options, expectedRevision: undefined });
89
+ /** Label post-effect audit comments for human readers, never for ownership or guard exemptions. */
90
+ const note = (text) => `HTTP operation ${id}: ${text}`;
91
+ /** Expose each complete protocol step to deterministic competing-writer and crash tests. */
92
+ const step = async (point) => { await options.boundary?.(point); };
93
+ /** Revalidate the immutable declaration in every journal mutation, including recovery. */
94
+ const validate = (value) => { if (digest(probeFrom(value, name)) !== digest(probe))
95
+ throw new HttpError('conflict', 'Probe revision changed after planning', 'Inspect the current declaration; use a new reviewed operation'); };
96
+ /** Cancel only an owned, unrecorded intent; preserve completed or reassigned native evidence. */
97
+ const cancel = async () => {
98
+ await journal.change(initial.id, value => { const entry = value.plans.find(plan => plan.id === id); if (entry === undefined || entry.probe !== probe.name || entry.probeDigest !== digest(probe) || entry.observation !== undefined || !['planned', 'sending'].includes(entry.stage))
99
+ return false; entry.stage = 'cancelled'; delete entry.reservedBytes; return true; }, note('HTTP send cancelled or refused; no partial observation'));
100
+ };
101
+ await step('validated');
102
+ return journal.locked(`send:${initial.id}:${id}`, async () => {
103
+ await step('plan-ready');
104
+ let current = await journal.change(initial.id, async (value) => {
105
+ validate(value);
106
+ const plan = value.plans.find(entry => entry.id === id);
107
+ if (plan !== undefined)
108
+ return admitPlan(value, probe, id, options.expectedRevision, targetDigest(initial.item, id));
109
+ if (options.expectedRevision !== undefined && digest((await journal.read(initial.id)).item) !== digest(initial.item))
110
+ throw new HttpError('conflict', 'Native target changed before plan admission', 'Read current context and declare a new operation', { reason: 'stale_revision' });
111
+ return admitPlan(value, probe, id, options.expectedRevision, targetDigest(initial.item, id));
112
+ });
113
+ const plannedTarget = await journal.read(initial.id);
114
+ await step('planned');
115
+ const plan = current.plans.find(entry => entry.id === id);
116
+ const callerRevision = options.expectedRevision ?? plan.expectedRevision;
117
+ let observation = current.observations.find(entry => entry.id === id) ?? plan.observation;
118
+ if (plan.stage === 'sending')
119
+ observation = uncertain(id, probe, 'Interrupted after send intent; outcome uncertain; no automatic retry');
120
+ if (plan.stage === 'planned') {
121
+ // Validate environment availability before marking a possible remote effect.
122
+ requestFor(probe, true);
123
+ try {
124
+ current = await journal.change(initial.id, async (value) => {
125
+ validate(value);
126
+ const entry = value.plans.find(entry => entry.id === id);
127
+ const target = callerRevision === undefined ? undefined : (await journal.read(initial.id)).item;
128
+ if (callerRevision !== undefined && digest(target) !== digest(plannedTarget.item))
129
+ throw new HttpError('conflict', 'Native target changed after planning', 'Read current context and declare a new operation', { reason: 'stale_revision' });
130
+ assertPlanGuard(value, entry, plan, callerRevision, 1, target === undefined ? undefined : targetDigest(target, id));
131
+ if (callerRevision !== undefined) {
132
+ entry.guardRevision = callerRevision + 2;
133
+ }
134
+ entry.stage = 'sending';
135
+ entry.reservedBytes = RESPONSE_RESERVATION - 1024;
136
+ return true;
137
+ });
138
+ }
139
+ catch (error) {
140
+ if (error instanceof HttpError && error.details.reason === 'stale_revision')
141
+ await cancel();
142
+ throw error;
143
+ }
144
+ const readyTarget = await journal.read(initial.id);
145
+ await step('sending');
146
+ try {
147
+ const fresh = await journal.read(initial.id);
148
+ validate(fresh.value);
149
+ capacity(fresh.value);
150
+ const guard = fresh.value.plans.find(entry => entry.id === id);
151
+ if (callerRevision !== undefined) {
152
+ if (digest(fresh.item) !== digest(readyTarget.item) || digest(fresh.value) !== digest(current))
153
+ throw new HttpError('conflict', 'Native target changed immediately before send', 'Read current context and declare a new operation', { reason: 'stale_revision' });
154
+ }
155
+ assertPlanGuard(fresh.value, guard, plan, callerRevision, 2, callerRevision === undefined ? undefined : targetDigest(fresh.item, id));
156
+ observation = await capture(id, probe, options.signal);
157
+ }
158
+ catch (error) {
159
+ await cancel();
160
+ throw error;
161
+ }
162
+ await journal.change(initial.id, value => { validate(value); const entry = value.plans.find(entry => entry.id === id); entry.stage = 'received'; entry.observation = observation; delete entry.reservedBytes; return true; }, note('Journaled complete secret-free HTTP result'));
163
+ }
164
+ await step('received');
165
+ await step('record-ready');
166
+ requireInput(observation !== undefined, 'Send journal has no recoverable result');
167
+ const final = observation;
168
+ await journal.change(initial.id, value => {
169
+ validate(value);
170
+ const existing = value.observations.find(entry => entry.id === id);
171
+ if (existing !== undefined) {
172
+ requireInput(digest(existing) === digest(final), 'Observation identity already has different evidence');
173
+ return false;
174
+ }
175
+ value.observations.push(final);
176
+ const entry = value.plans.find(entry => entry.id === id);
177
+ entry.stage = 'recorded';
178
+ delete entry.observation;
179
+ delete entry.reservedBytes;
180
+ return true;
181
+ }, note('Recorded historical HTTP observation; no present health assertion'));
182
+ await step('recorded');
183
+ await step('complete');
184
+ return { observation: final, operation: id };
185
+ });
186
+ }
187
+ /** Store one normalized contract, replacing the prior expectation under current revision. */
188
+ export async function setContract(item, name, input, options) {
189
+ requireInput(input.statuses.length > 0 && input.statuses.length <= 16, 'Contract needs 1 to 16 expected statuses');
190
+ const contract = { probe: label(name), statuses: [...new Set(input.statuses.map(code => bound(code, 100, 599)))].sort((a, b) => a - b), headers: [...new Set((input.headers ?? []).map(header => header.toLowerCase()))].sort(), ...(input.shape === undefined ? {} : { shape: contractShape(input.shape) }), ...(input.maxLatencyMs === undefined ? {} : { maxLatencyMs: bound(input.maxLatencyMs, 1, 60000) }) };
191
+ requireInput(contract.headers.length <= 32 && contract.headers.every(header => /^[a-z][a-z0-9-]{0,63}$/.test(header)), 'Required header list is invalid');
192
+ const store = new Store(options);
193
+ const value = await store.change(item, current => { probeFrom(current, name); const index = current.contracts.findIndex(entry => entry.probe === contract.probe); if (index >= 0 && digest(current.contracts[index]) === digest(contract))
194
+ return false; if (index < 0)
195
+ current.contracts.push(contract);
196
+ else
197
+ current.contracts[index] = contract; return true; }, 'Recorded bounded HTTP response contract');
198
+ return { contract, revision: value.revision };
199
+ }
200
+ //# sourceMappingURL=api.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/api.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,23 @@
1
+ import type { Shape } from './types.ts';
2
+ /** Bound shape work and report structural omissions instead of inventing completeness. */
3
+ export declare function bodyShape(value: unknown): {
4
+ shape: Shape;
5
+ incomplete: boolean;
6
+ };
7
+ /** Detect JSON semantics within the header count cap without exposing arbitrary media tokens. */
8
+ export declare function jsonMediaType(raw: string[], max: number): boolean | undefined;
9
+ /** Compile the supported JSON-schema subset without retaining source strings. All properties are required. */
10
+ export declare function contractShape(value: unknown, depth?: number): Shape;
11
+ /** Match required fields recursively; additional observed fields are allowed. */
12
+ export declare function matches(actual: Shape, expected: Shape): boolean;
13
+ /** Retain only canonical nonopaque header semantics; everything else is redacted. */
14
+ export declare function headerValue(name: string, value: string, secrets: string[]): string;
15
+ /** Select a bounded response header prefix while recording all capture losses. */
16
+ export declare function captureHeaders(raw: string[], selected: string[], max: number, secrets: string[]): {
17
+ headers: Record<string, string>;
18
+ omitted: number;
19
+ redactions: number;
20
+ };
21
+ /** Digest captured bytes, including a truthful prefix scope when truncated. */
22
+ export declare function bodyDigest(bytes: Buffer): string;
23
+ //# sourceMappingURL=capture.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/capture.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGxC,0FAA0F;AAC1F,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,CAY/E;AACD,iGAAiG;AACjG,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAG7E;AACD,8GAA8G;AAC9G,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,SAAI,GAAG,KAAK,CAW9D;AACD,iFAAiF;AACjF,wBAAgB,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,GAAG,OAAO,CAK/D;AACD,qFAAqF;AACrF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAMlF;AACD,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAQ1K;AACD,+EAA+E;AAC/E,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAA6D"}
@@ -0,0 +1,113 @@
1
+ import { createHash } from 'node:crypto';
2
+ import { digest, requireInput } from './core.js';
3
+ /** Bound shape work and report structural omissions instead of inventing completeness. */
4
+ export function bodyShape(value) {
5
+ let nodes = 0;
6
+ let incomplete = false;
7
+ /** Hash keys and discard every scalar response value. */
8
+ function walk(entry, depth) {
9
+ nodes++;
10
+ if (depth > 12) {
11
+ incomplete = true;
12
+ return { type: 'omitted' };
13
+ }
14
+ if (entry === null)
15
+ return { type: 'null' };
16
+ if (Array.isArray(entry)) {
17
+ const shapes = [];
18
+ for (const item of entry.slice(0, 64)) {
19
+ if (nodes >= 256) {
20
+ incomplete = true;
21
+ break;
22
+ }
23
+ shapes.push(walk(item, depth + 1));
24
+ }
25
+ if (entry.length > 64)
26
+ incomplete = true;
27
+ return { type: 'array', items: [...new Map(shapes.map(shape => [JSON.stringify(shape), shape])).values()].sort((a, b) => JSON.stringify(a).localeCompare(JSON.stringify(b), 'en')) };
28
+ }
29
+ if (typeof entry === 'object') {
30
+ const properties = {};
31
+ if (Object.keys(entry).length > 64)
32
+ incomplete = true;
33
+ for (const [key, content] of Object.entries(entry).slice(0, 64)) {
34
+ if (nodes >= 256) {
35
+ incomplete = true;
36
+ break;
37
+ }
38
+ properties[digest(key)] = walk(content, depth + 1);
39
+ }
40
+ return { type: 'object', properties: Object.fromEntries(Object.entries(properties).sort(([a], [b]) => a.localeCompare(b, 'en'))) };
41
+ }
42
+ return { type: typeof entry };
43
+ }
44
+ const shape = walk(value, 0);
45
+ return { shape, incomplete };
46
+ }
47
+ /** Detect JSON semantics within the header count cap without exposing arbitrary media tokens. */
48
+ export function jsonMediaType(raw, max) {
49
+ for (let index = 0; index < Math.min(raw.length, max * 2); index += 2)
50
+ if (raw[index].toLowerCase() === 'content-type')
51
+ return /^application\/(?:json|[!#$%&'*+.^_`|~0-9a-z-]+\+json)$/i.test(raw[index + 1].split(';')[0].trim());
52
+ return undefined;
53
+ }
54
+ /** Compile the supported JSON-schema subset without retaining source strings. All properties are required. */
55
+ export function contractShape(value, depth = 0) {
56
+ requireInput(value !== null && typeof value === 'object' && !Array.isArray(value) && depth <= 12, 'JSON shape must use the bounded documented schema subset');
57
+ const node = value;
58
+ requireInput(Object.keys(node).every(key => ['type', 'properties', 'items'].includes(key)) && typeof node.type === 'string' && ['object', 'array', 'string', 'number', 'boolean', 'null'].includes(node.type), 'Unsupported JSON shape keyword or type');
59
+ const shape = { type: node.type };
60
+ if (node.properties !== undefined) {
61
+ requireInput(node.type === 'object' && node.properties !== null && typeof node.properties === 'object' && !Array.isArray(node.properties) && Object.keys(node.properties).length <= 64, 'Shape properties require an object with at most 64 keys');
62
+ shape.properties = Object.fromEntries(Object.entries(node.properties).map(([key, child]) => [digest(key), contractShape(child, depth + 1)]).sort(([a], [b]) => String(a).localeCompare(String(b), 'en')));
63
+ }
64
+ if (node.items !== undefined) {
65
+ requireInput(node.type === 'array', 'Shape items require an array');
66
+ shape.items = [contractShape(node.items, depth + 1)];
67
+ }
68
+ return shape;
69
+ }
70
+ /** Match required fields recursively; additional observed fields are allowed. */
71
+ export function matches(actual, expected) {
72
+ if (actual.type !== expected.type)
73
+ return false;
74
+ for (const [key, value] of Object.entries(expected.properties ?? {})) {
75
+ const found = actual.properties?.[key];
76
+ if (found === undefined || !matches(found, value))
77
+ return false;
78
+ }
79
+ if (expected.items !== undefined && actual.items?.some(item => !matches(item, expected.items[0])))
80
+ return false;
81
+ return true;
82
+ }
83
+ /** Retain only canonical nonopaque header semantics; everything else is redacted. */
84
+ export function headerValue(name, value, secrets) {
85
+ if (secrets.some(secret => value.includes(secret)) || /[\u0000-\u001f\u007f-\u009f]/.test(value))
86
+ return '[REDACTED]';
87
+ if (name === 'content-type') {
88
+ const mime = value.split(';')[0].trim().toLowerCase();
89
+ return ['application/json', 'application/problem+json', 'application/vnd.github+json', 'text/plain', 'text/html', 'application/octet-stream'].includes(mime) ? mime : '[REDACTED]';
90
+ }
91
+ if ((name === 'content-length' || name === 'retry-after') && /^\d{1,7}$/.test(value) && Number(value) <= 1048576)
92
+ return String(Number(value));
93
+ if (name === 'cache-control' && /^(?:no-store|no-cache|public|private|max-age=\d{1,6})(?:, ?(?:no-store|no-cache|public|private|max-age=\d{1,6}))*$/.test(value))
94
+ return value;
95
+ return '[REDACTED]';
96
+ }
97
+ /** Select a bounded response header prefix while recording all capture losses. */
98
+ export function captureHeaders(raw, selected, max, secrets) {
99
+ const headers = new Map();
100
+ let redactions = 0;
101
+ for (let i = 0; i < Math.min(raw.length, max * 2); i += 2) {
102
+ const name = raw[i].toLowerCase();
103
+ const value = headerValue(name, raw[i + 1], secrets);
104
+ if (value === '[REDACTED]')
105
+ redactions++;
106
+ if (selected.includes(name))
107
+ headers.set(name, value);
108
+ }
109
+ return { headers: Object.fromEntries(headers), omitted: Math.max(0, raw.length / 2 - max), redactions };
110
+ }
111
+ /** Digest captured bytes, including a truthful prefix scope when truncated. */
112
+ export function bodyDigest(bytes) { return createHash('sha256').update(bytes).digest('hex'); }
113
+ //# sourceMappingURL=capture.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"capture.js","sourceRoot":"","sources":["../../src/capture.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ import type { CommandHandlerContext, ExtensionApi } from '@unbrained/pm-cli/sdk/authoring';
2
+ /** Execute through the native host renderer and structured expected-error boundary. */
3
+ export declare function runCommand(command: string, ctx: CommandHandlerContext): Promise<unknown>;
4
+ /** Register all commands, scalar fields and native output renderers. */
5
+ export declare function register(api: ExtensionApi): void;
6
+ //# sourceMappingURL=commands.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/commands.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,YAAY,EAAkB,MAAM,iCAAiC,CAAC;AAiB3G,uFAAuF;AACvF,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,OAAO,CAAC,CAwB9F;AACD,wEAAwE;AACxE,wBAAgB,QAAQ,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAiBhD"}
@@ -0,0 +1,84 @@
1
+ import { readFile } from 'node:fs/promises';
2
+ import { createPmCliExpectedError } from '@unbrained/pm-cli/sdk';
3
+ import { defineCommand } from '@unbrained/pm-cli/sdk/authoring';
4
+ import { addProbe, listProbes, preview, reviewProbe, send, setContract } from './api.js';
5
+ import { compare, differencePacket, missingEvidence } from './derive.js';
6
+ import { HttpError, failure, requireInput, wire } from './core.js';
7
+ import { FIELDS } from './store.js';
8
+ /** Reject absent or array operands without echoing untrusted data. */
9
+ function text(value) { requireInput(typeof value === 'string', 'Required text operand is missing'); return value; }
10
+ /** Preserve repeated header flags and status sets. */
11
+ function texts(value) { return value === undefined ? [] : (Array.isArray(value) ? value : [value]).map(text); }
12
+ /** Parse an optional integral flag without silently accepting empty inputs. */
13
+ function number(value) { if (value === undefined)
14
+ return undefined; requireInput(typeof value === 'string' && /^\d+$/.test(value), 'Numeric flag requires a nonnegative integer'); const parsed = Number(value); requireInput(Number.isSafeInteger(parsed), 'Numeric flag exceeds the safe integer range'); return parsed; }
15
+ /** Convert one refusal into the native host's safe expected-error contract. */
16
+ function expected(error) {
17
+ const refusal = failure(error);
18
+ return createPmCliExpectedError(`http ${refusal.code}: ${refusal.message}. Remedy: ${refusal.remedy}`, { exitCode: refusal.code === 'cancelled' ? 130 : refusal.code === 'conflict' ? 3 : 2, context: { code: refusal.code, ...refusal.details, required: refusal.remedy, recovery: { attempted_command: 'pm http [arguments omitted]', normalized_args: [], provided_fields: [] } } });
19
+ }
20
+ /** Execute through the native host renderer and structured expected-error boundary. */
21
+ export async function runCommand(command, ctx) {
22
+ const controller = new AbortController();
23
+ /** Make SIGINT a cancellation that cannot leave a partial observation. */
24
+ const cancel = () => controller.abort();
25
+ process.once('SIGINT', cancel);
26
+ try {
27
+ const flags = ctx.options;
28
+ const item = text(ctx.args[0]);
29
+ const options = { workspace: ctx.pm_root, author: ctx.global.author, client: ctx.sdk?.client, operationId: flags.operation === undefined ? undefined : text(flags.operation), expectedRevision: number(flags.expectedRevision), signal: controller.signal };
30
+ if (command === 'probe add')
31
+ return await addProbe(item, text(ctx.args[1]), { url: text(flags.url), method: flags.method === undefined ? undefined : text(flags.method), headers: texts(flags.header), body: flags.body === undefined ? undefined : text(flags.body), boundary: flags.boundary === undefined ? undefined : text(flags.boundary), maxBytes: number(flags.maxBytes), timeoutMs: number(flags.timeoutMs), maxHeaders: number(flags.maxHeaders), responseHeaders: flags.responseHeader === undefined ? undefined : texts(flags.responseHeader) }, options);
32
+ if (command === 'probe review') {
33
+ requireInput(flags.allowMutation === true, 'Review requires --allow-mutation');
34
+ return await reviewProbe(item, text(ctx.args[1]), text(flags.reason), options);
35
+ }
36
+ if (command === 'probe list')
37
+ return await listProbes(item, options);
38
+ if (command === 'send')
39
+ return await (flags.dryRun === true ? preview : send)(item, text(ctx.args[1]), options);
40
+ if (command === 'contract set') {
41
+ let shape;
42
+ if (flags.jsonShape !== undefined) {
43
+ const bytes = await readFile(text(flags.jsonShape));
44
+ requireInput(bytes.length <= 16384, 'Contract shape file exceeds 16384 bytes');
45
+ shape = JSON.parse(bytes.toString('utf8'));
46
+ }
47
+ return await setContract(item, text(ctx.args[1]), { statuses: texts(flags.status).map(value => number(value)), shape, headers: texts(flags.requireHeader), maxLatencyMs: number(flags.maxLatencyMs) }, options);
48
+ }
49
+ if (command === 'compare')
50
+ return await compare(item, { ...options, probe: ctx.args[1] });
51
+ if (command === 'diff')
52
+ return await differencePacket(item, { ...options, budget: number(flags.budget) });
53
+ if (command === 'missing')
54
+ return await missingEvidence(item, options);
55
+ }
56
+ catch (error) {
57
+ throw expected(error);
58
+ }
59
+ finally {
60
+ process.removeListener('SIGINT', cancel);
61
+ }
62
+ throw expected(new HttpError('invalid', 'Unknown HTTP command'));
63
+ }
64
+ /** Register all commands, scalar fields and native output renderers. */
65
+ export function register(api) {
66
+ api.registerItemFields(FIELDS);
67
+ const definitions = [
68
+ ['probe add', ['item', 'name'], ['url', 'method', 'header', 'body', 'boundary', 'max-bytes', 'timeout-ms', 'max-headers', 'response-header', 'expected-revision'], [], 'Declare a bounded request', 'pm http probe add task-id api --url https://example.com/api'],
69
+ ['probe review', ['item', 'name'], ['reason', 'expected-revision'], ['allow-mutation'], 'Record a separate mutation review', 'pm http probe review task-id api --allow-mutation --reason "Reviewed controlled fixture mutation"'],
70
+ ['probe list', ['item'], [], [], 'List request declarations', 'pm http probe list task-id'],
71
+ ['send', ['item', 'probe'], ['operation', 'expected-revision'], ['dry-run'], 'Explicitly send or preview one probe', 'pm http send task-id api --dry-run'],
72
+ ['contract set', ['item', 'probe'], ['status', 'json-shape', 'require-header', 'max-latency-ms', 'expected-revision'], [], 'Set a bounded response expectation', 'pm http contract set task-id api --status 200 --json-shape shape.json'],
73
+ ['compare', ['item', 'probe'], [], [], 'Compare historical observations', 'pm http compare task-id'],
74
+ ['diff', ['item'], ['budget'], [], 'Build a bounded historical difference packet', 'pm http diff task-id --budget 1500'],
75
+ ['missing', ['item'], [], [], 'Name exact outstanding evidence', 'pm http missing task-id'],
76
+ ];
77
+ for (const format of ['toon', 'json'])
78
+ api.registerRenderer(format, ctx => wire(ctx.result, format), { commands: definitions.map(([name]) => `http ${name}`) });
79
+ for (const [name, args, strings, booleans, description, example] of definitions) {
80
+ const flags = [...strings.map(flag => ({ long: `--${flag}`, description: `${flag}; ${example}`, value_type: 'string', value_name: flag, repeatable: ['header', 'response-header', 'require-header', 'status'].includes(flag) })), ...booleans.map(flag => ({ long: `--${flag}`, description: `${flag}; ${example}`, value_type: 'boolean' }))];
81
+ api.registerCommand(defineCommand({ name: `http ${name}`, description, intent: 'Context management for explicit HTTP investigations; observations are historical', arguments: args.map((arg, index) => ({ name: arg, description: arg, required: name !== 'compare' || index === 0 })), flags, examples: [example], run: ctx => runCommand(name, ctx) }));
82
+ }
83
+ }
84
+ //# sourceMappingURL=commands.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/commands.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,36 @@
1
+ /** Typed refusal with no raw network, environment or SDK diagnostic. */
2
+ export declare class HttpError extends Error {
3
+ /** Stable refusal classification for embedded callers. */
4
+ readonly code: string;
5
+ /** Concrete next step without private diagnostics. */
6
+ readonly remedy: string;
7
+ /** Safe hop identities and refusal metadata. */
8
+ readonly details: Record<string, string>;
9
+ /** Keep all error fields safe for both renderers. */
10
+ constructor(code: string, message: string, remedy?: string, details?: Record<string, string>);
11
+ }
12
+ /** Reject before effects without interpolating untrusted input. */
13
+ export declare function requireInput(condition: unknown, message: string): asserts condition;
14
+ /** Stable full SHA-256 identity for declarations and structural property names. */
15
+ export declare function digest(value: unknown): string;
16
+ /** Render untrusted controls and instruction delimiters as inert escaped data. */
17
+ export declare function inert(value: string): string;
18
+ /** Recursively sanitize every emitted string, including object keys. */
19
+ export declare function data(value: unknown): unknown;
20
+ /** Use host-selected TOON or JSON; untrusted text stays labeled data. */
21
+ export declare function wire(value: unknown, format: 'json' | 'toon'): string;
22
+ /** Heuristic units from the SDK estimator, covering both formats and newline; not tokenizer counts. */
23
+ export declare function tokens(value: unknown): number;
24
+ /** Accept bounded integral controls without coercing malformed values. */
25
+ export declare function bound(value: number, min: number, max: number): number;
26
+ /** Resolve a reference name without retaining its value in diagnostics. */
27
+ export declare function reference(value: string): string;
28
+ /** Read only explicitly referenced variables; never enumerate the environment. */
29
+ export declare function resolveReference(value: string): string;
30
+ /** Reject prompt-sized and token-shaped declarations before persistence. */
31
+ export declare function label(value: string): string;
32
+ /** Translate host and fitter failures without exposing source content or SDK diagnostics. */
33
+ export declare function failure(error: unknown): HttpError;
34
+ /** Adapt all public operations to safe, typed failures. */
35
+ export declare function guarded<A extends unknown[], R>(fn: (...args: A) => Promise<R>): (...args: A) => Promise<R>;
36
+ //# sourceMappingURL=core.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/core.ts"],"names":[],"mappings":"AAIA,wEAAwE;AACxE,qBAAa,SAAU,SAAQ,KAAK;IAClC,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,gDAAgD;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,qDAAqD;IACrD,YAAY,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAoD,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EAE1I;CACF;AACD,mEAAmE;AACnE,wBAAgB,YAAY,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAA6D;AACjJ,mFAAmF;AACnF,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAA6E;AAC3H,kFAAkF;AAClF,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAA0H;AACtK,wEAAwE;AACxE,wBAAgB,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAK5C;AACD,yEAAyE;AACzE,wBAAgB,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAuG;AAC5K,uGAAuG;AACvG,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAA2I;AACzL,0EAA0E;AAC1E,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAiJ;AACvN,2EAA2E;AAC3E,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAA4H;AAC5K,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAItD;AACD,4EAA4E;AAC5E,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAA0I;AACtL,6FAA6F;AAC7F,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAKjD;AACD,2DAA2D;AAC3D,wBAAgB,OAAO,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAE1G"}