@watchtowerobservability/activity 0.0.0-stage → 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +202 -0
- package/README.md +55 -2
- package/dist/ed25519ph.d.ts +2 -0
- package/dist/ed25519ph.test.d.ts +1 -0
- package/dist/index.cjs +931 -0
- package/dist/index.cjs.map +7 -0
- package/dist/index.d.cts +213 -0
- package/dist/index.d.ts +213 -0
- package/dist/index.js +908 -0
- package/dist/index.js.map +7 -0
- package/dist/index.test.d.ts +1 -0
- package/dist/model3.d.ts +30 -0
- package/dist/model3.test.d.ts +1 -0
- package/dist/model4.d.ts +74 -0
- package/dist/model4.test.d.ts +1 -0
- package/dist/types.d.ts +457 -0
- package/dist/verify.d.ts +104 -0
- package/dist/verify.test.d.ts +1 -0
- package/package.json +56 -4
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
{
|
|
2
|
+
"version": 3,
|
|
3
|
+
"sources": ["../src/index.ts", "../src/model3.ts", "../src/model4.ts", "../src/ed25519ph.ts", "../src/verify.ts"],
|
|
4
|
+
"sourcesContent": ["import type {\n AccountToken, AccountTokenIn, ActivityEvent, Archive, Batch, ErasureRequest, ErasureResult, EventIn, Export, ExportRequest, Invite, InviteIn,\n ListFilters, Page, RecordResult, Rule, RuleIn, RulePatch, SavedView, Stream, StreamIn, StreamPatch, ValidateResult, ViewerSession, ViewerSessionOptions,\n} from './types';\n\nimport { type Seal, type SigningKey, wire } from './model3';\n\nexport type * from './types';\nexport { canonicalJson, openSealed } from './model3';\nexport type { Seal, SealedEnvelope, SigningKey } from './model3';\n\nexport interface ActivityOptions {\n /** The project's `wti_` secret key with scope `ingest:activity`: record, validate, sessions, list, export. */\n secretKey: string;\n /** An org API key with access to the project, for `accountTokens()`, `streams()` and `rules()` (project management routes do not take `wti_` keys). */\n apiKey?: string;\n baseUrl?: string;\n /**\n * Data residency: the org's region (`us`, `eu`, ...). The client asks `GET /v1/regions` of `baseUrl` once and\n * then talks to that region's API. Either way a `421 wrong_region` answer is followed once.\n */\n region?: string;\n /** Opt in to constructing in a browser. Do not: the secret key would ship to users. */\n allowBrowser?: boolean;\n maxRetries?: number;\n fetch?: typeof fetch;\n /** Test hook; defaults to setTimeout. */\n sleep?: (ms: number) => Promise<void>;\n /**\n * Fill `trace_id`/`span_id` of events that have none from the active OpenTelemetry span.\n * Default: on when `@opentelemetry/api` is installed (an optional peer, loaded lazily); `false`\n * turns it off; a function supplies the ids yourself.\n */\n traceContext?: boolean | (() => SpanIds | undefined);\n /** Sign every recorded event (customer-signed events; register the public key under `kid`). */\n signingKey?: SigningKey;\n /** Encrypt these event paths here (AES-256-GCM); `openSealed` decrypts. */\n seal?: Seal;\n}\n\nexport interface SpanIds { trace_id: string; span_id: string }\n\nconst OTEL = '@opentelemetry/api';\nconst HEX32 = /^[0-9a-f]{32}$/;\nlet otel: Promise<(() => SpanIds | undefined) | undefined> | undefined;\n\n/** The active span's ids via `@opentelemetry/api`, or undefined when it is absent or no span is recording. */\nfunction otelSpan(): Promise<(() => SpanIds | undefined) | undefined> {\n // A variable specifier keeps bundlers and tsc from requiring the optional peer.\n otel ??= import(OTEL).then(\n (m: { trace?: { getActiveSpan?: () => { spanContext(): { traceId: string; spanId: string } } | undefined } }) => () => {\n const c = m.trace?.getActiveSpan?.()?.spanContext();\n return c && HEX32.test(c.traceId) && !/^0+$/.test(c.traceId) ? { trace_id: c.traceId, span_id: c.spanId } : undefined;\n },\n () => undefined,\n );\n return otel;\n}\n\n/** RFC 9457 problem+json mapped to an Error. */\nexport class ActivityError extends Error {\n readonly status: number;\n readonly type: string;\n readonly title: string;\n readonly detail?: string;\n readonly instance?: string;\n readonly extensions: Record<string, unknown>;\n constructor(status: number, p: Record<string, unknown> = {}) {\n const { type, title, detail, instance, status: _s, ...ext } = p;\n const t = typeof title === 'string' ? title : `HTTP ${status}`;\n super(typeof detail === 'string' ? `${t}: ${detail}` : t);\n this.name = 'ActivityError';\n this.status = status;\n this.type = typeof type === 'string' ? type : 'about:blank';\n this.title = t;\n this.detail = typeof detail === 'string' ? detail : undefined;\n this.instance = typeof instance === 'string' ? instance : undefined;\n this.extensions = ext;\n }\n}\n\nconst BATCH = 100;\n/** With `partial: true` the server takes up to 1000 per request and reports rejects per event. */\nconst PARTIAL_BATCH = 1000;\n\nconst defaultSleep = (ms: number) => new Promise<void>((r) => setTimeout(r, ms));\n\nfunction retryAfterMs(h: string | null): number | undefined {\n if (!h) return undefined;\n const s = Number(h);\n if (Number.isFinite(s)) return Math.max(0, s * 1000);\n const d = Date.parse(h);\n return Number.isNaN(d) ? undefined : Math.max(0, d - Date.now());\n}\n\nexport class Activity {\n readonly #key: string;\n readonly #apiKey: string | undefined;\n #base: string;\n readonly #region: string | undefined;\n #regionDone = false;\n readonly #fetch: typeof fetch;\n readonly #sleep: (ms: number) => Promise<void>;\n readonly #retries: number;\n readonly #trace: boolean | (() => SpanIds | undefined);\n readonly #signingKey: SigningKey | undefined;\n readonly #seal: Seal | undefined;\n\n constructor(opts: ActivityOptions) {\n if (typeof window !== 'undefined' && !opts.allowBrowser) {\n throw new Error('@watchtowerobservability/activity is server-only: the secret key would ship to browsers. Use @watchtowerobservability/activity-web there.');\n }\n if (!opts?.secretKey) throw new Error('secretKey is required');\n this.#key = opts.secretKey;\n this.#apiKey = opts.apiKey;\n const base = opts.baseUrl ?? (typeof process !== 'undefined' ? process.env.WT_API_URL : undefined);\n if (!base) throw new Error('baseUrl (or the WT_API_URL environment variable) is required');\n this.#base = base.replace(/\\/+$/, '');\n this.#region = opts.region;\n this.#fetch = opts.fetch ?? ((...a) => globalThis.fetch(...a));\n this.#sleep = opts.sleep ?? defaultSleep;\n this.#retries = opts.maxRetries ?? 4;\n this.#trace = opts.traceContext ?? true;\n this.#signingKey = opts.signingKey;\n this.#seal = opts.seal;\n }\n\n /** Never expose the key via console.log / util.inspect / JSON.stringify. */\n toJSON() { return { baseUrl: this.#base }; }\n\n /** With `region`: that region's API base from the directory, once (a failed lookup keeps `baseUrl`). */\n async #resolveRegion() {\n if (!this.#region || this.#regionDone) return;\n this.#regionDone = true;\n try {\n const res = await this.#fetch(`${this.#base}/v1/regions`, { method: 'GET' });\n const d = (await res.json()) as { current?: string | null; data?: { region: string; api_base_url: string }[] };\n const hit = d.current === this.#region ? undefined : d.data?.find((r) => r.region === this.#region);\n if (hit) this.#base = hit.api_base_url.replace(/\\/+$/, '');\n } catch { /* keep baseUrl; a 421 still redirects */ }\n }\n\n async #request(method: string, path: string, body?: unknown, key = this.#key): Promise<Response> {\n const backoff = (attempt: number) => Math.min(30000, 250 * 2 ** attempt * (0.5 + Math.random() / 2));\n await this.#resolveRegion();\n let moved = false;\n for (let attempt = 0; ; attempt++) {\n let res: Response;\n try {\n res = await this.#fetch(this.#base + path, {\n method,\n headers: {\n authorization: `Bearer ${key}`,\n ...(body === undefined ? {} : { 'content-type': 'application/json' }),\n },\n body: body === undefined ? undefined : JSON.stringify(body),\n });\n } catch (e) {\n // fetch rejects on connection, DNS and TLS failures: retry those like a 5xx\n if (attempt >= this.#retries) throw e;\n await this.#sleep(backoff(attempt));\n continue;\n }\n if (res.ok) return res;\n if ((res.status === 429 || res.status >= 500) && attempt < this.#retries) {\n // Retry-After wins; else exponential backoff with jitter, capped at 30 s.\n const wait = retryAfterMs(res.headers.get('retry-after')) ?? backoff(attempt);\n await res.body?.cancel().catch(() => {});\n await this.#sleep(wait);\n continue;\n }\n let p: Record<string, unknown> | undefined;\n try { p = (await res.json()) as Record<string, unknown>; } catch { /* non-JSON error body */ }\n // 421 wrong_region: the org lives elsewhere; follow its API once\n if (res.status === 421 && !moved && typeof p?.api_base_url === 'string') {\n moved = true;\n this.#base = p.api_base_url.replace(/\\/+$/, '');\n attempt--;\n continue;\n }\n throw new ActivityError(res.status, p);\n }\n }\n\n /**\n * At-least-once: a retry after a lost response can re-send, so supply your own stable\n * idempotency_key per business event; the server dedupes on (project, key).\n * `dryRun` validates without storing (POST /v1/activity/events/validate).\n */\n record(event: EventIn, o: { dryRun: true }): Promise<ValidateResult>;\n record(event: EventIn, o?: { dryRun?: false }): Promise<RecordResult>;\n async record(event: EventIn, o: { dryRun?: boolean } = {}): Promise<RecordResult | ValidateResult> {\n return o.dryRun ? this.validate([event]) : this.recordBatch([event]);\n }\n\n /** Normalized stored form, schema warnings, missing template and PII detector hits; stores nothing. */\n async validate(events: EventIn | EventIn[]): Promise<ValidateResult> {\n return this.#json('POST', '/v1/activity/events/validate', { events: Array.isArray(events) ? events : [events] });\n }\n\n /**\n * `partial: true`: batches of 1000, bad events are listed in `rejected` instead of failing the batch.\n * `receipts: true`: a signed receipt per accepted event (check with `verifyReceipt`).\n * `async: true`: queued server-side; poll `batch(id)` for each of `batch_ids`.\n */\n async recordBatch(events: EventIn[], o: { partial?: boolean; receipts?: boolean; async?: boolean } = {}): Promise<RecordResult> {\n // Key is assigned once, before chunking and retries, so every re-send carries the same key.\n const span = await this.#spanIds();\n const prepared = await wire(events.map((e) => ({\n ...(span && !e.trace_id ? span : {}),\n ...e,\n idempotency_key: e.idempotency_key ?? globalThis.crypto.randomUUID(),\n })), this.#seal, this.#signingKey);\n const size = o.partial ? PARTIAL_BATCH : BATCH;\n const out: Required<RecordResult> = { accepted: 0, rejected: [], warnings: [], receipts: [], coalesced: [], batch_ids: [] };\n const q = [o.partial && 'partial=true', o.receipts && 'receipts=true', o.async && 'async=true'].filter(Boolean).join('&');\n for (let i = 0; i < prepared.length; i += size) {\n const r = await this.#json<RecordResult & { batch_id?: string }>('POST', `/v1/activity/events${q ? `?${q}` : ''}`, { events: prepared.slice(i, i + size) });\n out.accepted += r.accepted;\n // Indexes are per request; shift them to the caller's array.\n for (const x of r.rejected ?? []) out.rejected.push({ ...x, index: x.index + i });\n for (const x of r.warnings ?? []) out.warnings.push({ ...x, index: x.index + i });\n for (const x of r.receipts ?? []) out.receipts.push({ ...x, index: x.index + i });\n for (const x of r.coalesced ?? []) out.coalesced.push({ ...x, index: x.index + i });\n if (r.batch_id) out.batch_ids.push(r.batch_id);\n }\n return {\n accepted: out.accepted, ...(o.partial ? { rejected: out.rejected } : {}), ...(out.warnings.length ? { warnings: out.warnings } : {}),\n ...(out.receipts.length ? { receipts: out.receipts } : {}), ...(out.coalesced.length ? { coalesced: out.coalesced } : {}),\n ...(out.batch_ids.length ? { batch_ids: out.batch_ids } : {}),\n };\n }\n\n /** The state of an async batch (`recordBatch(..., { async: true })`). */\n async batch(id: string): Promise<Batch> {\n return this.#json('GET', `/v1/activity/batches/${encodeURIComponent(id)}`);\n }\n\n /** One event by id (with lookup `labels`). */\n async getEvent(projectId: string, id: string): Promise<ActivityEvent> {\n return this.#json('GET', `${this.#prj(projectId)}/events/${encodeURIComponent(id)}`);\n }\n\n async #spanIds(): Promise<SpanIds | undefined> {\n if (this.#trace === false) return undefined;\n if (typeof this.#trace === 'function') return this.#trace();\n return (await otelSpan())?.();\n }\n\n /** Write 25 realistic sample events into one account (default `sample`) through the ingest pipeline. */\n async samples(projectId: string, o: { accountId?: string } = {}): Promise<{ account_id: string; accepted: number }> {\n return this.#json('POST', `${this.#prj(projectId)}/samples`, o.accountId ? { account_id: o.accountId } : {});\n }\n\n async createViewerSession(o: ViewerSessionOptions): Promise<ViewerSession> {\n const j = await this.#json<{ token: string; url: string; expires_at: string; jti?: string }>('POST', '/v1/activity/sessions', {\n account_id: o.accountId, actor_id: o.actorId, expires_in: o.expiresIn, capabilities: o.capabilities,\n locale: o.locale, time_zone: o.timeZone,\n sub_scope: o.subScope && { target_type: o.subScope.targetType, target_id: o.subScope.targetId },\n });\n return { token: j.token, url: j.url, expiresAt: j.expires_at, ...(j.jti ? { jti: j.jti } : {}) };\n }\n\n /** Revoke one viewer session by its `jti`. */\n async revokeSession(jti: string): Promise<void> {\n await this.#request('DELETE', `/v1/activity/sessions/${encodeURIComponent(jti)}`);\n }\n\n /** Revoke every live viewer session of an account (e.g. on offboarding). Returns how many were live. */\n async revokeAccountSessions(accountId: string): Promise<{ revoked: number }> {\n return this.#json('POST', '/v1/activity/sessions/revoke', { account_id: accountId });\n }\n\n /** Project management calls authenticate with `apiKey`. */\n #mgmt(method: string, path: string, body?: unknown) {\n if (!this.#apiKey) throw new Error('apiKey (an org API key) is required for accountTokens(), streams(), rules() and privacy()');\n return this.#request(method, path, body, this.#apiKey);\n }\n async #mjson<T>(method: string, path: string, body?: unknown): Promise<T> {\n return (await (await this.#mgmt(method, path, body)).json()) as T;\n }\n\n /** End-customer API tokens (`wta_acct_...`) of one account; the token string is in the create response only. */\n accountTokens(projectId: string, accountId: string) {\n const base = `${this.#prj(projectId)}/accounts/${encodeURIComponent(accountId)}/tokens`;\n return {\n list: () => this.#mjson<Page<AccountToken>>('GET', base),\n create: (o: AccountTokenIn) => this.#mjson<AccountToken>('POST', base, o),\n revoke: (id: string) => this.#mgmt('DELETE', `${base}/${encodeURIComponent(id)}`).then(() => undefined),\n };\n }\n\n /** Email a one-time link to the account's hosted page (single use; it becomes a fresh session when opened). */\n async invite(projectId: string, accountId: string, o: InviteIn): Promise<Invite> {\n return this.#mjson('POST', `${this.#prj(projectId)}/accounts/${encodeURIComponent(accountId)}/invite`, o);\n }\n\n /** SIEM / log streams (secrets are write-only). */\n streams(projectId: string) {\n const base = `${this.#prj(projectId)}/streams`;\n const one = (id: string) => `${base}/${encodeURIComponent(id)}`;\n return {\n list: () => this.#mjson<Page<Stream>>('GET', base),\n get: (id: string) => this.#mjson<Stream>('GET', one(id)),\n create: (s: StreamIn) => this.#mjson<Stream>('POST', base, s),\n update: (id: string, patch: StreamPatch) => this.#mjson<Stream>('PATCH', one(id), patch),\n /** Re-send everything received since `from` (RFC 3339, within retention). */\n replay: (id: string, o: { from: string }) => this.#mjson<Stream>('POST', `${one(id)}/replay`, o),\n delete: (id: string) => this.#mgmt('DELETE', one(id)).then(() => undefined),\n /** Queues a test delivery (202); poll `get(id)` for `last_test`. */\n test: (id: string) => this.#mgmt('POST', `${one(id)}/test`, {}).then(() => undefined),\n };\n }\n\n /** Alert rules on chosen actions (email, Slack, signed webhook). */\n rules(projectId: string) {\n const base = `${this.#prj(projectId)}/rules`;\n const one = (id: string) => `${base}/${encodeURIComponent(id)}`;\n return {\n list: () => this.#mjson<Page<Rule>>('GET', base),\n create: (r: RuleIn) => this.#mjson<Rule>('POST', base, r),\n /** A new `channel` returns a new `signing_secret` for webhooks. */\n update: (id: string, patch: RulePatch) => this.#mjson<Rule>('PATCH', one(id), patch),\n delete: (id: string) => this.#mgmt('DELETE', one(id)).then(() => undefined),\n };\n }\n\n /** Async exports (the file is kept 24 h) and restores of cold archives. */\n exports(projectId: string) {\n const base = `${this.#prj(projectId)}/exports`;\n const one = (id: string) => `${base}/${encodeURIComponent(id)}`;\n return {\n create: (r: ExportRequest = {}) => this.#mjson<Export>('POST', base, r),\n get: (id: string) => this.#mjson<Export>('GET', one(id)),\n download: async (id: string): Promise<ReadableStream<Uint8Array>> => {\n const res = await this.#mgmt('GET', `${one(id)}/download`);\n if (!res.body) throw new ActivityError(res.status, { title: 'Empty export body' });\n return res.body;\n },\n };\n }\n\n archives(projectId: string) {\n const base = `${this.#prj(projectId)}/archives`;\n return {\n list: (o: { accountId?: string } = {}) => this.#mjson<Page<Archive>>('GET', `${base}${o.accountId ? `?account_id=${encodeURIComponent(o.accountId)}` : ''}`),\n /** Load an archive back for `days` (1 to 30, default 7); list it with `list(.., { source: 'archive' })`. */\n restore: (id: string, o: { days?: number } = {}) => this.#mjson<Archive>('POST', `${base}/${encodeURIComponent(id)}/restore`, o),\n };\n }\n\n /** Right to erasure. With `approval: true` the erase waits for a second member's `approve` (202 request). */\n privacy(projectId: string) {\n const base = this.#prj(projectId);\n return {\n eraseActor: (actorId: string, o: { approval?: boolean } = {}) =>\n this.#mjson<ErasureResult | ErasureRequest>('POST', `${base}/actors/${encodeURIComponent(actorId)}/erase`, o.approval ? { approval: { required: true } } : {}),\n /** Pending requests. */\n erasures: () => this.#mjson<Page<ErasureRequest>>('GET', `${base}/erasures`),\n /** By a member other than the requester (else 404). */\n approve: (id: string) => this.#mjson<ErasureResult>('POST', `${base}/erasures/${encodeURIComponent(id)}/approve`, {}),\n /** Withdraw a pending request: its requester, or a member with the privacy permission (else 404). */\n cancel: async (id: string) => { await this.#mgmt('POST', `${base}/erasures/${encodeURIComponent(id)}/cancel`, {}); },\n /** One event, org owners only. */\n deleteEvent: (id: string) => this.#mjson<{ committed: boolean; fields_erased: number }>('DELETE', `${base}/events/${encodeURIComponent(id)}`),\n };\n }\n\n #prj(projectId: string) { return `/v1/projects/${encodeURIComponent(projectId)}/activity`; }\n\n async #json<T>(method: string, path: string, body?: unknown): Promise<T> {\n return (await (await this.#request(method, path, body)).json()) as T;\n }\n\n #query(f: ListFilters & { format?: string; fields?: string[]; chain?: boolean }, cursor?: string): string {\n const m: Record<string, string | number | undefined> = {\n account_id: f.accountId, actor_id: f.actorId, action: f.action, target_type: f.targetType,\n target_id: f.targetId, q: f.q, outcome: f.outcome, severity: f.severity, order: f.order, from: f.from, to: f.to, limit: f.limit,\n source: f.source, since: f.since,\n format: f.format, fields: f.fields?.length ? f.fields.join(',') : undefined, chain: f.chain ? 1 : undefined, cursor,\n };\n const q = new URLSearchParams();\n for (const [k, v] of Object.entries(m)) if (v !== undefined) q.set(k, String(v));\n const s = q.toString();\n return s ? `?${s}` : '';\n }\n\n /** Async iterator over every event, following next_cursor page by page. */\n async *list(projectId: string, filters: ListFilters = {}): AsyncGenerator<ActivityEvent, void, undefined> {\n let cursor: string | undefined;\n do {\n const page = await this.#json<Page<ActivityEvent>>('GET', `${this.#prj(projectId)}/events${this.#query(filters, cursor)}`);\n yield* page.data;\n cursor = page.next_cursor ?? undefined;\n } while (cursor);\n }\n\n /**\n * Returns the streaming response body (csv, ndjson or OCSF NDJSON). `fields` keeps only those\n * columns/keys (e.g. `['id', 'occurred_at', 'actor.email']`); `chain: true` (ndjson) adds `seq`,\n * `chain_hash`, `prev_hash` and `chain_body` per line for offline verification.\n */\n async export(projectId: string, o: { format: 'csv' | 'ndjson' | 'ocsf'; fields?: string[]; chain?: boolean } & ListFilters): Promise<ReadableStream<Uint8Array>> {\n const { format, limit: _limit, ...f } = o; // the export endpoint streams everything and takes no limit\n const res = await this.#request('GET', `${this.#prj(projectId)}/export${this.#query({ ...f, format })}`);\n if (!res.body) throw new ActivityError(res.status, { title: 'Empty export body' });\n return res.body;\n }\n\n /**\n * The browser feed's calls with one viewer credential (a viewer token from\n * `createViewerSession` or an account token `wta_acct_...`), from server code: a backend that\n * renders the log itself, or a support tool. The session's scopes always apply.\n */\n viewer(token: string) {\n const json = async <T,>(method: string, path: string, body?: unknown) =>\n (await (await this.#request(method, path, body, token)).json()) as T;\n const stream = async (path: string) => {\n const res = await this.#request('GET', path, undefined, token);\n if (!res.body) throw new ActivityError(res.status, { title: 'Empty export body' });\n return res.body;\n };\n const q = (f: ListFilters, extra: Record<string, string> = {}, cursor?: string) => {\n const s = new URLSearchParams(this.#query(f, cursor).slice(1));\n for (const [k, v] of Object.entries(extra)) s.set(k, v);\n return s.toString() ? `?${s}` : '';\n };\n return {\n /** Every event of the session's scope, page by page. */\n feed: async function* (filters: ListFilters = {}): AsyncGenerator<ActivityEvent, void, undefined> {\n let cursor: string | undefined;\n do {\n const page = await json<Page<ActivityEvent>>('GET', `/v1/activity/feed${q(filters, {}, cursor)}`);\n yield* page.data;\n cursor = page.next_cursor ?? undefined;\n } while (cursor);\n },\n facets: (field: 'action' | 'actor' | 'target_type' | 'target', filters: ListFilters = {}) =>\n json<Page<{ value: string; label?: string | null; count: number }>>('GET', `/v1/activity/feed/facets${q(filters, { field })}`),\n histogram: (filters: ListFilters = {}) =>\n json<Page<{ at: string; count: number }>>('GET', `/v1/activity/feed/histogram${q(filters, { bucket: 'day' })}`),\n /** Server-side saved views; account tokens only (a session gets 404 and keeps views in the browser). */\n views: {\n list: () => json<Page<SavedView>>('GET', '/v1/activity/views'),\n create: (v: { name: string; q?: string; params?: Record<string, string> }) => json<SavedView>('POST', '/v1/activity/views', v),\n delete: async (id: string) => { await this.#request('DELETE', `/v1/activity/views/${encodeURIComponent(id)}`, undefined, token); },\n },\n /** Merkle inclusion proof of one event (capability `verify`; 409 until its hour is signed). */\n proof: (eventId: string) => json<Record<string, unknown>>('GET', `/v1/activity/feed/proof?event_id=${encodeURIComponent(eventId)}`),\n /** Consistency proof between two signed tree heads (`toSize` defaults to the latest). */\n consistency: (fromSize: number, toSize?: number) =>\n json<Record<string, unknown>>('GET', `/v1/activity/feed/consistency?from_size=${fromSize}${toSize ? `&to_size=${toSize}` : ''}`),\n /** Synchronous download (capability `export`). */\n export: (format: 'csv' | 'ndjson' | 'ocsf', filters: ListFilters = {}) => stream(`/v1/activity/feed/export${q(filters, { format })}`),\n exports: {\n list: () => json<Page<Export>>('GET', '/v1/activity/exports'),\n create: (r: ExportRequest) => json<Export>('POST', '/v1/activity/exports', r),\n get: (id: string) => json<Export>('GET', `/v1/activity/exports/${encodeURIComponent(id)}`),\n download: (id: string) => stream(`/v1/activity/exports/${encodeURIComponent(id)}/download`),\n },\n };\n }\n}\n\nexport { ActivityQueue, middleware } from './model4';\nexport type { QueueOptions, RequestContext } from './model4';\nexport * from './verify';\n", "// Customer-signed events and client-side sealing (WebCrypto: Node 20+, Deno, Bun, workers).\n\n/** Signs every recorded event: Ed25519 over `canonicalJson` of the event as sent, without `signature`. */\nexport interface SigningKey {\n /** The key registered at `PUT /v1/projects/{prj}/activity/signing-keys`. */\n kid: string;\n /** Base64 of the 32-byte Ed25519 seed (private key), or use `sign` (HSM, KMS). */\n privateKey?: string;\n sign?: (message: Uint8Array) => Promise<Uint8Array> | Uint8Array;\n}\n\n/** Encrypts the values at `paths` (dotted from the event root, e.g. `metadata.ssn`) with AES-256-GCM before they leave the process. */\nexport interface Seal {\n kid: string;\n /** Base64 of the 32-byte AES key. Never sent. */\n key: string;\n paths: string[];\n}\n\nexport interface SealedEnvelope { $wt_cse: string; alg: 'A256GCM'; iv: string; ct: string }\n\nconst enc = new TextEncoder();\nconst subtle = () => globalThis.crypto.subtle;\nconst b64 = (b: Uint8Array) => btoa(String.fromCharCode(...b));\nconst unb64 = (s: string) => Uint8Array.from(atob(s), (c) => c.charCodeAt(0));\n\nconst byUtf8 = (a: string, b: string) => {\n const x = enc.encode(a), y = enc.encode(b);\n for (let i = 0; i < Math.min(x.length, y.length); i++) if (x[i] !== y[i]) return x[i]! - y[i]!;\n return x.length - y.length;\n};\n\n/**\n * Keys sorted at every level, no whitespace, strings escaped as the server does: the bytes a\n * signature covers. shortcut: numbers print as JSON.stringify does; use integers or strings in signed events.\n */\nexport function canonicalJson(v: unknown): string {\n if (Array.isArray(v)) return `[${v.map((x) => canonicalJson(x === undefined ? null : x)).join(',')}]`;\n if (v && typeof v === 'object') {\n const o = v as Record<string, unknown>;\n const keys = Object.keys(o).filter((k) => o[k] !== undefined).sort(byUtf8);\n return `{${keys.map((k) => `${JSON.stringify(k)}:${canonicalJson(o[k])}`).join(',')}}`;\n }\n return JSON.stringify(v ?? null);\n}\n\nasync function signer(k: SigningKey): Promise<(m: Uint8Array) => Promise<Uint8Array>> {\n if (k.sign) return async (m) => k.sign!(m);\n if (!k.privateKey) throw new Error('signingKey needs privateKey or sign');\n // PKCS#8 wrapper of a raw Ed25519 seed (RFC 8410)\n const pkcs8 = new Uint8Array([...unb64('MC4CAQAwBQYDK2VwBCIEIA=='), ...unb64(k.privateKey)]);\n const key = await subtle().importKey('pkcs8', pkcs8, { name: 'Ed25519' }, false, ['sign']);\n return async (m) => new Uint8Array(await subtle().sign('Ed25519', key, m));\n}\n\nasync function aes(key: string, use: KeyUsage) {\n return subtle().importKey('raw', unb64(key), 'AES-GCM', false, [use]);\n}\n\n/** Seals, then signs (the signature covers the envelopes). Returns new objects. */\nexport async function wire<T extends object>(events: T[], seal?: Seal, signingKey?: SigningKey): Promise<T[]> {\n if (!seal && !signingKey) return events;\n const key = seal ? await aes(seal.key, 'encrypt') : undefined;\n const sign = signingKey ? await signer(signingKey) : undefined;\n const out: T[] = [];\n for (const e of events) {\n const o = JSON.parse(JSON.stringify(e)) as Record<string, unknown>;\n for (const path of seal?.paths ?? []) {\n const parts = path.split('.');\n const last = parts.pop()!;\n let node: unknown = o;\n for (const p of parts) node = node && typeof node === 'object' ? (node as Record<string, unknown>)[p] : undefined;\n if (!node || typeof node !== 'object' || !(last in node)) continue;\n const parent = node as Record<string, unknown>;\n const iv = globalThis.crypto.getRandomValues(new Uint8Array(12));\n const ct = await subtle().encrypt({ name: 'AES-GCM', iv, additionalData: enc.encode(path) }, key!, enc.encode(canonicalJson(parent[last])));\n parent[last] = { $wt_cse: seal!.kid, alg: 'A256GCM', iv: b64(iv), ct: b64(new Uint8Array(ct)) } satisfies SealedEnvelope;\n }\n if (sign) {\n delete o.signature;\n const sig = await sign(enc.encode(canonicalJson(o)));\n o.signature = { kid: signingKey!.kid, alg: 'ed25519', sig: b64(sig) };\n }\n out.push(o as T);\n }\n return out;\n}\n\n/** Decrypts a `$wt_cse` envelope found at `path` (e.g. `metadata.ssn`) with the base64 AES key. Throws when it does not match. */\nexport async function openSealed(key: string, path: string, envelope: SealedEnvelope): Promise<unknown> {\n const pt = await subtle().decrypt({ name: 'AES-GCM', iv: unb64(envelope.iv), additionalData: enc.encode(path) }, await aes(key, 'decrypt'), unb64(envelope.ct));\n return JSON.parse(new TextDecoder().decode(pt));\n}\n", "// Background queue (I23) and framework middleware (I24) for the server SDK.\nimport type { EventIn, RecordResult } from './types';\n\n/** Anything that records batches: an `Activity` client. */\ninterface Recorder { recordBatch(events: EventIn[], o?: { partial?: boolean }): Promise<RecordResult> }\n\nexport interface QueueOptions {\n /** Events per request (default 100, at most 1000). */\n maxBatch?: number;\n /** Flush at least this often, in ms (default 1000). */\n flushMs?: number;\n /** Events held in memory before new ones are dropped (default 10000). */\n maxBuffer?: number;\n /**\n * `open` (default): a full buffer or a failed send drops events and calls `onDrop`.\n * `closed`: `enqueue` rejects when the buffer is full, so the caller can refuse the action\n * (audit-or-fail).\n */\n mode?: 'open' | 'closed';\n /** Called with events that could not be recorded and why. */\n onDrop?: (events: EventIn[], reason: unknown) => void;\n /** Flush on process exit signals (default true in Node). */\n flushOnExit?: boolean;\n}\n\n/**\n * Non-blocking recording: `enqueue` returns at once; events go out in batches of `maxBatch` every\n * `flushMs` (with `partial`, so one bad event does not drop the rest). Each event gets its\n * idempotency key when enqueued, so the client's retries never duplicate. At-least-once while\n * the process lives; `flush()` before exit (done for SIGTERM/SIGINT/beforeExit by default).\n */\nexport class ActivityQueue {\n readonly #client: Recorder;\n readonly #o: Required<Omit<QueueOptions, 'onDrop'>> & Pick<QueueOptions, 'onDrop'>;\n #buf: EventIn[] = [];\n #timer: ReturnType<typeof setInterval> | undefined;\n #sending: Promise<void> = Promise.resolve();\n\n constructor(client: Recorder, o: QueueOptions = {}) {\n this.#client = client;\n this.#o = {\n maxBatch: Math.min(Math.max(o.maxBatch ?? 100, 1), 1000), flushMs: o.flushMs ?? 1000,\n maxBuffer: o.maxBuffer ?? 10000, mode: o.mode ?? 'open', onDrop: o.onDrop, flushOnExit: o.flushOnExit ?? true,\n };\n this.#timer = setInterval(() => { void this.flush(); }, this.#o.flushMs);\n (this.#timer as { unref?: () => void }).unref?.();\n const p = typeof process !== 'undefined' ? (process as { once?: (e: string, f: () => void) => void }) : undefined;\n if (this.#o.flushOnExit && p?.once) {\n for (const sig of ['beforeExit', 'SIGTERM', 'SIGINT']) p.once(sig, () => { void this.close(); });\n }\n }\n\n /** Events waiting to be sent. */\n get size() { return this.#buf.length; }\n\n /** Queue one event. In `closed` mode a full buffer rejects; in `open` mode it drops and calls `onDrop`. */\n async enqueue(e: EventIn): Promise<void> {\n const ev = { ...e, idempotency_key: e.idempotency_key ?? globalThis.crypto.randomUUID() };\n if (this.#buf.length >= this.#o.maxBuffer) {\n const err = new Error('activity queue full');\n if (this.#o.mode === 'closed') throw err;\n this.#o.onDrop?.([ev], err);\n return;\n }\n this.#buf.push(ev);\n if (this.#buf.length >= this.#o.maxBatch) void this.flush();\n }\n\n /** Send everything queued now; resolves when sent (or dropped). */\n flush(): Promise<void> {\n this.#sending = this.#sending.then(async () => {\n while (this.#buf.length) {\n const batch = this.#buf.splice(0, this.#o.maxBatch);\n try {\n const r = await this.#client.recordBatch(batch, { partial: true });\n const bad = (r.rejected ?? []).map((x) => batch[x.index]).filter((x): x is EventIn => !!x);\n if (bad.length) this.#o.onDrop?.(bad, r.rejected);\n } catch (err) {\n this.#o.onDrop?.(batch, err);\n }\n }\n });\n return this.#sending;\n }\n\n /** Stop the timer and flush. */\n async close(): Promise<void> {\n if (this.#timer) clearInterval(this.#timer);\n this.#timer = undefined;\n await this.flush();\n }\n}\n\n/** What the middleware knows about the request, for `event()`. */\nexport interface RequestContext { method: string; path: string; status: number; ip?: string; userAgent?: string; requestId?: string }\n\ninterface NodeReq { method?: string; url?: string; originalUrl?: string; ip?: string; headers?: Record<string, string | string[] | undefined>; socket?: { remoteAddress?: string } }\ninterface NodeRes { statusCode?: number; once?: (e: 'finish', f: () => void) => void; on?: (e: 'finish', f: () => void) => void }\n\nconst header = (r: NodeReq, k: string) => { const v = r.headers?.[k]; return Array.isArray(v) ? v[0] : v; };\n\n/**\n * Express / Connect / Fastify (`fastify.addHook('onRequest', (req, reply, done) => mw(req.raw, reply.raw, done))`)\n * middleware: after each response, `event(req, ctx)` returns the event to record (or nothing to skip) and it is\n * queued; request context (ip, user agent, request id) is filled in. Never blocks or fails the request.\n */\nexport function middleware<Req extends NodeReq>(queue: ActivityQueue, event: (req: Req, ctx: RequestContext) => EventIn | undefined | null) {\n return (req: Req, res: NodeRes, next: (err?: unknown) => void) => {\n const done = () => {\n try {\n const ctx: RequestContext = {\n method: req.method ?? 'GET', path: (req.originalUrl ?? req.url ?? '/').split('?')[0]!, status: res.statusCode ?? 0,\n ip: req.ip ?? req.socket?.remoteAddress, userAgent: header(req, 'user-agent'), requestId: header(req, 'x-request-id'),\n };\n const e = event(req, ctx);\n if (!e) return;\n const context = { ...(ctx.ip ? { ip: ctx.ip } : {}), ...(ctx.userAgent ? { user_agent: ctx.userAgent } : {}), ...(ctx.requestId ? { request_id: ctx.requestId } : {}), ...e.context };\n void queue.enqueue({ ...e, context }).catch(() => {});\n } catch { /* never fail the request for its audit event */ }\n };\n (res.once ?? res.on)?.call(res, 'finish', done);\n next();\n };\n}\n", "// RFC 8032 Ed25519ph verification (empty context) in plain BigInt: WebCrypto and Node have Ed25519 but not\n// Ed25519ph, which a Rekor v2 hashedrekord entry carries. Verification only, so constant time is not needed.\nconst P = 2n ** 255n - 19n;\nconst L = 2n ** 252n + 27742317777372353535851937790883648493n;\nconst md = (a: bigint) => ((a % P) + P) % P;\nconst pw = (b: bigint, e: bigint) => {\n let r = 1n;\n for (b = md(b); e > 0n; e >>= 1n, b = md(b * b)) if (e & 1n) r = md(r * b);\n return r;\n};\nconst D = md(-121665n * pw(121666n, P - 2n));\nconst SQRT_M1 = pw(2n, (P - 1n) / 4n);\ntype Pt = [bigint, bigint, bigint, bigint];\nconst add = ([x1, y1, z1, t1]: Pt, [x2, y2, z2, t2]: Pt): Pt => {\n const a = md((y1 - x1) * (y2 - x2)), b = md((y1 + x1) * (y2 + x2));\n const c = md(t1 * 2n * D * t2), d = md(z1 * 2n * z2);\n const e = b - a, f = d - c, g = d + c, h = b + a;\n return [md(e * f), md(g * h), md(f * g), md(e * h)];\n};\nconst mul = (s: bigint, p: Pt): Pt => {\n let q: Pt = [0n, 1n, 1n, 0n];\n for (; s > 0n; s >>= 1n, p = add(p, p)) if (s & 1n) q = add(q, p);\n return q;\n};\nconst point = (y: bigint, sign: bigint): Pt | null => {\n const xx = md((y * y - 1n) * pw(D * y * y + 1n, P - 2n));\n let x = pw(xx, (P + 3n) / 8n);\n if (md(x * x - xx) !== 0n) x = md(x * SQRT_M1);\n if (md(x * x - xx) !== 0n || (x === 0n && sign === 1n)) return null;\n if ((x & 1n) !== sign) x = P - x;\n return [x, y, 1n, md(x * y)];\n};\nconst le = (b: Uint8Array) => b.reduceRight((n, x) => (n << 8n) | BigInt(x), 0n);\nconst decode = (b: Uint8Array): Pt | null => {\n if (b.length !== 32) return null;\n const n = le(b), y = n & ((1n << 255n) - 1n);\n return y >= P ? null : point(y, n >> 255n);\n};\nconst G = point(md(4n * pw(5n, P - 2n)), 0n)!;\nconst eq = (a: Pt, b: Pt) => md(a[0] * b[2] - b[0] * a[2]) === 0n && md(a[1] * b[2] - b[1] * a[2]) === 0n;\nconst DOM2 = new TextEncoder().encode('SigEd25519 no Ed25519 collisions\\x01\\x00');\n\n/** Ed25519ph: `sig` by `pk` over `digest`, the SHA-512 of the message (RFC 8032 5.1, empty context). */\nexport async function ed25519phVerify(pk: Uint8Array, sig: Uint8Array, digest: Uint8Array): Promise<boolean> {\n if (sig.length !== 64 || digest.length !== 64) return false;\n const a = decode(pk), r = decode(sig.subarray(0, 32)), s = le(sig.subarray(32));\n if (!a || !r || s >= L) return false;\n const msg = new Uint8Array(DOM2.length + 128);\n msg.set(DOM2);\n msg.set(sig.subarray(0, 32), DOM2.length);\n msg.set(pk, DOM2.length + 32);\n msg.set(digest, DOM2.length + 64);\n const h = le(new Uint8Array(await globalThis.crypto.subtle.digest('SHA-512', msg))) % L;\n return eq(mul(s, G), add(r, mul(h, a)));\n}\n", "// Reference verifier (B6): checks what Watchtower hands out without trusting the server. Shared vectors:\n// testdata/activity_verify_vectors.json and activity_merkle_vectors.json (every SDK runs them).\n// chain row hash = SHA-256(prev_hash bytes || body), links and seqs contiguous\n// signed docs checkpoint, tree head (STH), manifest, digest, tombstone, completeness, receipt:\n// Ed25519 (base64url `signature`/`sig`) over the UTF-8 `message` by the key `kid`\n// from GET /v1/activity/keys ({keys: [{kid, x: base64url raw key}]})\n// Merkle RFC 9162: leaf = SHA-256(0x00 || chain hash), node = SHA-256(0x01 || l || r)\n// disclosure commitment = SHA-256(salt bytes || canonical JSON of the value)\nimport type { Receipt } from './types';\nimport { ed25519phVerify } from './ed25519ph';\n\nconst enc = new TextEncoder();\ntype Bytes = Uint8Array<ArrayBuffer>;\nexport interface Key { kid: string; x: string }\nexport interface Signed { kid: string; message: string; signature?: string; sig?: string }\nexport interface ChainRow { seq: number; prev_hash: string; hash: string; body: string; id?: string }\n\nexport function fromHex(s: string): Bytes {\n return new Uint8Array((s.match(/../g) ?? []).map((h) => parseInt(h, 16)));\n}\nexport function fromB64(s: string): Bytes {\n const b = atob(s.replace(/-/g, '+').replace(/_/g, '/').padEnd(Math.ceil(s.length / 4) * 4, '='));\n return Uint8Array.from(b, (c) => c.charCodeAt(0));\n}\nexport const toHex = (b: Uint8Array) => [...b].map((x) => x.toString(16).padStart(2, '0')).join('');\nconst cat = (...p: Uint8Array[]): Bytes => {\n const out = new Uint8Array(p.reduce((n, x) => n + x.length, 0));\n p.reduce((o, x) => (out.set(x, o), o + x.length), 0);\n return out;\n};\nconst sha = async (b: Uint8Array): Promise<Bytes> => new Uint8Array(await globalThis.crypto.subtle.digest('SHA-256', cat(b)));\n\n/** Canonical JSON as the server writes it: sorted keys, no whitespace. */\nexport function canonical(v: unknown): string {\n if (Array.isArray(v)) return `[${v.map(canonical).join(',')}]`;\n if (v && typeof v === 'object') {\n const o = v as Record<string, unknown>;\n return `{${Object.keys(o).sort().map((k) => `${JSON.stringify(k)}:${canonical(o[k])}`).join(',')}}`;\n }\n return v === undefined ? 'null' : JSON.stringify(v);\n}\n\n/** Hex SHA-256(prev || body) of a chain row. */\nexport async function chainHash(prevHex: string, body: string): Promise<string> {\n return toHex(await sha(cat(fromHex(prevHex), enc.encode(body))));\n}\n\n/** Rows ascending and contiguous after `anchor` (or from seq 1 with an empty link): the first bad seq, or null. */\nexport async function verifyRows(rows: ChainRow[], anchor?: { seq: number; hash: string } | null): Promise<number | null> {\n let seq = anchor?.seq ?? 0, prev = anchor?.hash ?? '';\n for (const r of rows) {\n let bodySeq: unknown;\n try { bodySeq = (JSON.parse(r.body) as { seq?: unknown }).seq; } catch { bodySeq = undefined; }\n if (r.seq !== seq + 1 || r.prev_hash !== prev || bodySeq !== r.seq || (await chainHash(r.prev_hash, r.body)) !== r.hash) return r.seq;\n seq = r.seq; prev = r.hash;\n }\n return null;\n}\n\n/** Ed25519 over `message` by `kid`; false for an unknown kid or a bad signature. */\nexport async function verifySignature(s: Signed, keys: Key[]): Promise<boolean> {\n const k = keys.find((x) => x.kid === s.kid);\n const sig = s.signature ?? s.sig;\n if (!k || !sig) return false;\n try {\n const key = await globalThis.crypto.subtle.importKey('raw', fromB64(k.x), { name: 'Ed25519' }, false, ['verify']);\n return await globalThis.crypto.subtle.verify({ name: 'Ed25519' }, key, fromB64(sig), enc.encode(s.message));\n } catch {\n return false;\n }\n}\n\nexport const merkleLeaf = async (chainHashHex: string) => toHex(await sha(cat(new Uint8Array([0]), fromHex(chainHashHex))));\nconst node = (l: Uint8Array, r: Uint8Array) => sha(cat(new Uint8Array([1]), l, r));\n\n/** RFC 9162 tree hash of leaf hashes (hex). */\nexport async function merkleRoot(leaves: string[]): Promise<string> {\n const rec = async (l: Uint8Array[]): Promise<Bytes> => {\n if (l.length === 0) return sha(new Uint8Array());\n if (l.length === 1) return cat(l[0]!);\n let k = 1;\n while (k * 2 < l.length) k *= 2;\n return node(await rec(l.slice(0, k)), await rec(l.slice(k)));\n };\n return toHex(await rec(leaves.map(fromHex)));\n}\n\n/** RFC 9162 2.1.3.2: `leaf` (hex leaf hash) at `index` of a tree of `size` with `root`. */\nexport async function verifyInclusion(leaf: string, index: number, size: number, path: string[], root: string): Promise<boolean> {\n if (index >= size) return false;\n let f = index, s = size - 1, r: Uint8Array = fromHex(leaf);\n for (const p of path.map(fromHex)) {\n if (s === 0) return false;\n if (f % 2 === 1 || f === s) {\n r = await node(p, r);\n while (f % 2 === 0 && f !== 0) { f >>= 1; s >>= 1; }\n } else r = await node(r, p);\n f >>= 1; s >>= 1;\n }\n return s === 0 && toHex(r) === root;\n}\n\n/** RFC 9162 2.1.4.2: the tree (m, oldRoot) is a prefix of (n, newRoot). */\nexport async function verifyConsistency(m: number, n: number, oldRoot: string, newRoot: string, proof: string[]): Promise<boolean> {\n if (m < 1 || m > n) return false;\n if (m === n) return proof.length === 0 && oldRoot === newRoot;\n const p: Uint8Array[] = proof.map(fromHex);\n if ((m & (m - 1)) === 0) p.unshift(fromHex(oldRoot));\n let fn = m - 1, sn = n - 1;\n while (fn % 2 === 1) { fn >>= 1; sn >>= 1; }\n let fr = p[0], sr = p[0];\n if (!fr || !sr) return false;\n for (const c of p.slice(1)) {\n if (sn === 0) return false;\n if (fn % 2 === 1 || fn === sn) {\n fr = await node(c, fr); sr = await node(c, sr);\n while (fn % 2 === 0 && fn !== 0) { fn >>= 1; sn >>= 1; }\n } else sr = await node(sr, c);\n fn >>= 1; sn >>= 1;\n }\n return sn === 0 && toHex(fr) === oldRoot && toHex(sr) === newRoot;\n}\n\n/** A selectively disclosed field: SHA-256(salt || canonical(value)) equals the commitment in the chain body. */\nexport async function verifyCommitment(f: { salt: string; value: unknown; commitment: string }): Promise<boolean> {\n return toHex(await sha(cat(fromHex(f.salt), enc.encode(canonical(f.value))))) === f.commitment;\n}\n\ntype ReceiptLike = Pick<Receipt, 'account_id' | 'seq' | 'leaf_index' | 'chain_hash' | 'kid' | 'message' | 'sig'>;\n\n/** A write receipt: signed by a project key, and its message names the receipt's own fields. */\nexport async function verifyReceipt(r: ReceiptLike, keys: Key[], projectId?: string): Promise<boolean> {\n let m: unknown[];\n try { m = JSON.parse(r.message) as unknown[]; } catch { return false; }\n const shape = m[0] === 'wt.activity.receipt.v1' && (!projectId || m[1] === projectId) && m[2] === r.account_id\n && m[3] === r.seq && m[4] === r.chain_hash && m[5] === r.leaf_index;\n return shape && verifySignature(r, keys);\n}\n\nexport type Verdict = 'VALID' | 'VALID_UNANCHORED' | 'VALID_PRUNED' | 'INVALID';\ntype Obj = Record<string, unknown>;\nexport interface VerifyPage {\n data: ChainRow[]; head_seq?: number; anchor_seq?: number | null;\n checkpoint: (Signed & { seq: number; hash: string }) | null;\n pruned?: (Signed & { from_seq: number; to_seq: number; last_hash: string })[];\n erased?: { from_seq: number; to_seq: number }[];\n}\nexport interface TreeHead extends Signed {\n from_seq: number; to_seq: number; size: number; root: string; note?: string;\n cosignatures?: { line: string }[]; anchor?: { top: string; index: number; size: number; path: string[]; receipts: Obj[] } | null;\n}\n/** What the verifier pins beyond the project keys: Rekor v2 logs `{origin: base64url key}`, witnesses `{name: key}`, the quorum. */\nexport interface Trust { rekorLogs?: Record<string, string>; witnesses?: Record<string, string>; quorum?: number }\n\nconst parse = (m: string): unknown[] => { try { const v = JSON.parse(m) as unknown; return Array.isArray(v) ? v : []; } catch { return []; } };\nconst b64std = (s: string): Bytes => Uint8Array.from(atob(s), (c) => c.charCodeAt(0));\nconst b64enc = (b: Uint8Array) => btoa(String.fromCharCode(...b));\nconst eqb = (a: Uint8Array, b: Uint8Array) => a.length === b.length && a.every((x, i) => x === b[i]);\n\n/** The C2SP checkpoint origin (key name) of an account's log; the account percent-encoded. */\nexport function origin(project: string, account: string): string {\n const safe = /[A-Za-z0-9\\-._~]/;\n const acct = [...enc.encode(account)].map((c) => (safe.test(String.fromCharCode(c)) && c < 128 ? String.fromCharCode(c) : `%${c.toString(16).toUpperCase().padStart(2, '0')}`)).join('');\n return `watchtower.dev/activity/${project}/${acct}`;\n}\nconst keyHash = async (name: string, typ: number, pk: Uint8Array) => (await sha(cat(enc.encode(name), new Uint8Array([0x0a, typ]), pk))).slice(0, 4);\nfunction note(text: string): { body: string; sigs: [string, Bytes][] } | null {\n const i = text.indexOf('\\n\\n');\n if (i < 0) return null;\n const sigs: [string, Bytes][] = [];\n for (const l of text.slice(i + 2).replace(/\\n$/, '').split('\\n')) {\n const m = /^\u2014 (\\S+) (\\S+)$/.exec(l);\n if (!m) return null;\n try { sigs.push([m[1]!, b64std(m[2]!)]); } catch { return null; }\n }\n return { body: text.slice(0, i + 1), sigs };\n}\nconst ed = async (pk: Uint8Array, sig: Uint8Array, msg: Uint8Array) => {\n try {\n const key = await globalThis.crypto.subtle.importKey('raw', cat(pk), { name: 'Ed25519' }, false, ['verify']);\n return await globalThis.crypto.subtle.verify({ name: 'Ed25519' }, key, cat(sig), cat(msg));\n } catch { return false; }\n};\n/** A C2SP signed note carries a valid Ed25519 signature by key `name`. */\nexport async function verifyNote(text: string, name: string, pk: Uint8Array): Promise<boolean> {\n const n = note(text), kh = await keyHash(name, 1, pk);\n if (!n) return false;\n for (const [nm, s] of n.sigs) if (nm === name && s.length === 68 && eqb(s.slice(0, 4), kh) && (await ed(pk, s.slice(4), enc.encode(n.body)))) return true;\n return false;\n}\nconst checkpointOf = (body: string) => {\n const l = body.split('\\n');\n try { return { origin: l[0]!, size: Number(l[1]), root: b64std(l[2]!) }; } catch { return null; }\n};\nasync function cosigned(body: string, sigs: [string, Bytes][], name: string, pk: Uint8Array) {\n const kh = await keyHash(name, 4, pk);\n for (const [nm, s] of sigs) {\n if (nm !== name || s.length !== 76 || !eqb(s.slice(0, 4), kh)) continue;\n const t = new DataView(s.buffer, s.byteOffset + 4, 8).getBigUint64(0);\n if (await ed(pk, s.slice(12), enc.encode(`cosignature/v1\\ntime ${t}\\n${body}`))) return true;\n }\n return false;\n}\nasync function rekorV2(e: Obj, top: string, keys: Key[], logs: Record<string, Bytes>): Promise<boolean> {\n const statement = JSON.stringify(['wt.activity.rekor.v1', top]);\n if (e.statement !== statement) return false;\n try {\n const body = b64std(String(e.canonicalized_body));\n const h = (JSON.parse(new TextDecoder().decode(body)) as { spec: { hashedRekordV002: { data: { digest: string }; signature: { content: string; verifier: { publicKey: { rawBytes: string } } } } } }).spec.hashedRekordV002;\n const k = keys.find((x) => x.kid === e.kid);\n const p = e.inclusion_proof as { log_index: number; tree_size: number; root_hash: string; hashes: string[]; checkpoint: { envelope: string } };\n const dig = new Uint8Array(await globalThis.crypto.subtle.digest('SHA-512', enc.encode(statement)));\n if (!k || h.data.digest !== b64enc(dig) || !eqb(b64std(h.signature.verifier.publicKey.rawBytes), cat(fromHex('302a300506032b6570032100'), fromB64(k.x)))) return false;\n if (!(await ed25519phVerify(fromB64(k.x), b64std(h.signature.content), dig))) return false;\n const root = toHex(b64std(p.root_hash));\n if (!(await verifyInclusion(toHex(await sha(cat(new Uint8Array([0]), body))), p.log_index, p.tree_size, p.hashes.map((x) => toHex(b64std(x))), root))) return false;\n const n = note(p.checkpoint.envelope), c = n && checkpointOf(n.body);\n const pk = c ? logs[c.origin] : undefined;\n return !!c && !!pk && c.size === p.tree_size && toHex(c.root) === root && verifyNote(p.checkpoint.envelope, c.origin, pk);\n } catch { return false; }\n}\nasync function anchored(head: TreeHead, keys: Key[], logs: Record<string, Bytes>): Promise<boolean> {\n const a = head.anchor;\n if (!a || !(await verifyInclusion(await merkleLeaf(head.root), a.index, a.size, a.path, a.top))) return false;\n for (const r of a.receipts ?? []) {\n if (r.kind !== 'rekor' || r.version !== 2) continue;\n for (const e of (r.entries as Obj[] | undefined) ?? []) if (await rekorV2(e, a.top, keys, logs)) return true;\n }\n return false;\n}\n\n/**\n * The spec's verdict over one account's merged verify pages (oldest first) and optionally its tree head: INVALID\n * beats VALID_PRUNED (signed tombstones from seq 1) beats VALID (head signed, the rows' Merkle root, anchored by a\n * Rekor v2 receipt in a trusted log, its Ed25519ph signature included, witness quorum met) beats\n * VALID_UNANCHORED. Other receipt kinds are checked by `wtctl activity verify`.\n */\nexport async function verdict(p: VerifyPage, keys: Key[], head?: TreeHead | null, trust: Trust = {}): Promise<Verdict> {\n const rows = p.data;\n const first = rows[0];\n if (!first) return 'VALID_UNANCHORED';\n if (first.seq === 1 && first.prev_hash) return 'INVALID';\n if ((await verifyRows(rows, { seq: first.seq - 1, hash: first.prev_hash })) !== null) return 'INVALID';\n const body = JSON.parse(first.body) as { project_id?: string; account_id?: string };\n let pruned = false;\n if (first.seq > 1) {\n let next = 1;\n for (const t of [...(p.pruned ?? [])].sort((a, b) => a.from_seq - b.from_seq)) {\n const m = parse(t.message);\n if (!(await verifySignature(t, keys)) || m[0] !== 'wt.activity.pruned.v1' || m[3] !== t.from_seq || m[4] !== t.to_seq || m[5] !== t.last_hash) return 'INVALID';\n if (t.from_seq > next) break;\n next = Math.max(next, t.to_seq + 1);\n if (t.to_seq === first.seq - 1 && t.last_hash !== first.prev_hash) return 'INVALID';\n }\n const erased = (p.erased ?? []).some((e) => e.from_seq <= next && e.to_seq >= first.seq - 1);\n if (next < first.seq && !erased) return 'INVALID';\n pruned = true;\n }\n const hashes = new Map(rows.map((r) => [r.seq, r.hash]));\n const cp = p.checkpoint;\n if (cp) {\n const m = parse(cp.message);\n if (m[0] !== 'wt.activity.checkpoint.v1' || m[3] !== cp.seq || m[4] !== cp.hash || (hashes.get(cp.seq) ?? cp.hash) !== cp.hash || !(await verifySignature(cp, keys))) return 'INVALID';\n }\n let ok = false;\n if (head) {\n const m = parse(head.message);\n if (m[0] !== 'wt.activity.merkle.v1' || m[3] !== head.from_seq || m[4] !== head.to_seq || m[5] !== head.root\n || head.size !== head.to_seq - head.from_seq + 1 || !(await verifySignature(head, keys))) return 'INVALID';\n const cover: string[] = [];\n for (let s = head.from_seq; s <= head.to_seq; s++) { const h = hashes.get(s); if (h) cover.push(h); }\n if (cover.length === head.size) {\n if ((await merkleRoot(await Promise.all(cover.map(merkleLeaf)))) !== head.root) return 'INVALID';\n const k = keys.find((x) => x.kid === head.kid);\n if (head.note) {\n const n = note(head.note), c = n && checkpointOf(n.body);\n if (!k || !c || c.size !== head.size || toHex(c.root) !== head.root\n || !(await verifyNote(head.note, origin(body.project_id ?? '', body.account_id ?? ''), fromB64(k.x)))) return 'INVALID';\n }\n let text = head.note ?? '';\n for (const c of head.cosignatures ?? []) if (!text.includes(c.line)) text += `${c.line}\\n`;\n const n = text ? note(text) : null;\n let count = 0;\n for (const [name, x] of Object.entries(trust.witnesses ?? {})) if (n && (await cosigned(n.body, n.sigs, name, fromB64(x)))) count++;\n const logs = Object.fromEntries(Object.entries(trust.rekorLogs ?? {}).map(([o, x]) => [o, fromB64(x)]));\n ok = count >= (trust.quorum ?? 0) && (await anchored(head, keys, logs));\n }\n }\n if (pruned) return 'VALID_PRUNED';\n return ok ? 'VALID' : 'VALID_UNANCHORED';\n}\n"],
|
|
5
|
+
"mappings": "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",
|
|
6
|
+
"names": ["node", "enc", "n"]
|
|
7
|
+
}
|
package/dist/index.d.cts
ADDED
|
@@ -0,0 +1,213 @@
|
|
|
1
|
+
import type { AccountToken, AccountTokenIn, ActivityEvent, Archive, Batch, ErasureRequest, ErasureResult, EventIn, Export, ExportRequest, Invite, InviteIn, ListFilters, Page, RecordResult, Rule, RuleIn, RulePatch, SavedView, Stream, StreamIn, StreamPatch, ValidateResult, ViewerSession, ViewerSessionOptions } from './types';
|
|
2
|
+
import { type Seal, type SigningKey } from './model3';
|
|
3
|
+
export type * from './types';
|
|
4
|
+
export { canonicalJson, openSealed } from './model3';
|
|
5
|
+
export type { Seal, SealedEnvelope, SigningKey } from './model3';
|
|
6
|
+
export interface ActivityOptions {
|
|
7
|
+
/** The project's `wti_` secret key with scope `ingest:activity`: record, validate, sessions, list, export. */
|
|
8
|
+
secretKey: string;
|
|
9
|
+
/** An org API key with access to the project, for `accountTokens()`, `streams()` and `rules()` (project management routes do not take `wti_` keys). */
|
|
10
|
+
apiKey?: string;
|
|
11
|
+
baseUrl?: string;
|
|
12
|
+
/**
|
|
13
|
+
* Data residency: the org's region (`us`, `eu`, ...). The client asks `GET /v1/regions` of `baseUrl` once and
|
|
14
|
+
* then talks to that region's API. Either way a `421 wrong_region` answer is followed once.
|
|
15
|
+
*/
|
|
16
|
+
region?: string;
|
|
17
|
+
/** Opt in to constructing in a browser. Do not: the secret key would ship to users. */
|
|
18
|
+
allowBrowser?: boolean;
|
|
19
|
+
maxRetries?: number;
|
|
20
|
+
fetch?: typeof fetch;
|
|
21
|
+
/** Test hook; defaults to setTimeout. */
|
|
22
|
+
sleep?: (ms: number) => Promise<void>;
|
|
23
|
+
/**
|
|
24
|
+
* Fill `trace_id`/`span_id` of events that have none from the active OpenTelemetry span.
|
|
25
|
+
* Default: on when `@opentelemetry/api` is installed (an optional peer, loaded lazily); `false`
|
|
26
|
+
* turns it off; a function supplies the ids yourself.
|
|
27
|
+
*/
|
|
28
|
+
traceContext?: boolean | (() => SpanIds | undefined);
|
|
29
|
+
/** Sign every recorded event (customer-signed events; register the public key under `kid`). */
|
|
30
|
+
signingKey?: SigningKey;
|
|
31
|
+
/** Encrypt these event paths here (AES-256-GCM); `openSealed` decrypts. */
|
|
32
|
+
seal?: Seal;
|
|
33
|
+
}
|
|
34
|
+
export interface SpanIds {
|
|
35
|
+
trace_id: string;
|
|
36
|
+
span_id: string;
|
|
37
|
+
}
|
|
38
|
+
/** RFC 9457 problem+json mapped to an Error. */
|
|
39
|
+
export declare class ActivityError extends Error {
|
|
40
|
+
readonly status: number;
|
|
41
|
+
readonly type: string;
|
|
42
|
+
readonly title: string;
|
|
43
|
+
readonly detail?: string;
|
|
44
|
+
readonly instance?: string;
|
|
45
|
+
readonly extensions: Record<string, unknown>;
|
|
46
|
+
constructor(status: number, p?: Record<string, unknown>);
|
|
47
|
+
}
|
|
48
|
+
export declare class Activity {
|
|
49
|
+
#private;
|
|
50
|
+
constructor(opts: ActivityOptions);
|
|
51
|
+
/** Never expose the key via console.log / util.inspect / JSON.stringify. */
|
|
52
|
+
toJSON(): {
|
|
53
|
+
baseUrl: string;
|
|
54
|
+
};
|
|
55
|
+
/**
|
|
56
|
+
* At-least-once: a retry after a lost response can re-send, so supply your own stable
|
|
57
|
+
* idempotency_key per business event; the server dedupes on (project, key).
|
|
58
|
+
* `dryRun` validates without storing (POST /v1/activity/events/validate).
|
|
59
|
+
*/
|
|
60
|
+
record(event: EventIn, o: {
|
|
61
|
+
dryRun: true;
|
|
62
|
+
}): Promise<ValidateResult>;
|
|
63
|
+
record(event: EventIn, o?: {
|
|
64
|
+
dryRun?: false;
|
|
65
|
+
}): Promise<RecordResult>;
|
|
66
|
+
/** Normalized stored form, schema warnings, missing template and PII detector hits; stores nothing. */
|
|
67
|
+
validate(events: EventIn | EventIn[]): Promise<ValidateResult>;
|
|
68
|
+
/**
|
|
69
|
+
* `partial: true`: batches of 1000, bad events are listed in `rejected` instead of failing the batch.
|
|
70
|
+
* `receipts: true`: a signed receipt per accepted event (check with `verifyReceipt`).
|
|
71
|
+
* `async: true`: queued server-side; poll `batch(id)` for each of `batch_ids`.
|
|
72
|
+
*/
|
|
73
|
+
recordBatch(events: EventIn[], o?: {
|
|
74
|
+
partial?: boolean;
|
|
75
|
+
receipts?: boolean;
|
|
76
|
+
async?: boolean;
|
|
77
|
+
}): Promise<RecordResult>;
|
|
78
|
+
/** The state of an async batch (`recordBatch(..., { async: true })`). */
|
|
79
|
+
batch(id: string): Promise<Batch>;
|
|
80
|
+
/** One event by id (with lookup `labels`). */
|
|
81
|
+
getEvent(projectId: string, id: string): Promise<ActivityEvent>;
|
|
82
|
+
/** Write 25 realistic sample events into one account (default `sample`) through the ingest pipeline. */
|
|
83
|
+
samples(projectId: string, o?: {
|
|
84
|
+
accountId?: string;
|
|
85
|
+
}): Promise<{
|
|
86
|
+
account_id: string;
|
|
87
|
+
accepted: number;
|
|
88
|
+
}>;
|
|
89
|
+
createViewerSession(o: ViewerSessionOptions): Promise<ViewerSession>;
|
|
90
|
+
/** Revoke one viewer session by its `jti`. */
|
|
91
|
+
revokeSession(jti: string): Promise<void>;
|
|
92
|
+
/** Revoke every live viewer session of an account (e.g. on offboarding). Returns how many were live. */
|
|
93
|
+
revokeAccountSessions(accountId: string): Promise<{
|
|
94
|
+
revoked: number;
|
|
95
|
+
}>;
|
|
96
|
+
/** End-customer API tokens (`wta_acct_...`) of one account; the token string is in the create response only. */
|
|
97
|
+
accountTokens(projectId: string, accountId: string): {
|
|
98
|
+
list: () => Promise<Page<AccountToken>>;
|
|
99
|
+
create: (o: AccountTokenIn) => Promise<AccountToken>;
|
|
100
|
+
revoke: (id: string) => Promise<undefined>;
|
|
101
|
+
};
|
|
102
|
+
/** Email a one-time link to the account's hosted page (single use; it becomes a fresh session when opened). */
|
|
103
|
+
invite(projectId: string, accountId: string, o: InviteIn): Promise<Invite>;
|
|
104
|
+
/** SIEM / log streams (secrets are write-only). */
|
|
105
|
+
streams(projectId: string): {
|
|
106
|
+
list: () => Promise<Page<Stream>>;
|
|
107
|
+
get: (id: string) => Promise<Stream>;
|
|
108
|
+
create: (s: StreamIn) => Promise<Stream>;
|
|
109
|
+
update: (id: string, patch: StreamPatch) => Promise<Stream>;
|
|
110
|
+
/** Re-send everything received since `from` (RFC 3339, within retention). */
|
|
111
|
+
replay: (id: string, o: {
|
|
112
|
+
from: string;
|
|
113
|
+
}) => Promise<Stream>;
|
|
114
|
+
delete: (id: string) => Promise<undefined>;
|
|
115
|
+
/** Queues a test delivery (202); poll `get(id)` for `last_test`. */
|
|
116
|
+
test: (id: string) => Promise<undefined>;
|
|
117
|
+
};
|
|
118
|
+
/** Alert rules on chosen actions (email, Slack, signed webhook). */
|
|
119
|
+
rules(projectId: string): {
|
|
120
|
+
list: () => Promise<Page<Rule>>;
|
|
121
|
+
create: (r: RuleIn) => Promise<Rule>;
|
|
122
|
+
/** A new `channel` returns a new `signing_secret` for webhooks. */
|
|
123
|
+
update: (id: string, patch: RulePatch) => Promise<Rule>;
|
|
124
|
+
delete: (id: string) => Promise<undefined>;
|
|
125
|
+
};
|
|
126
|
+
/** Async exports (the file is kept 24 h) and restores of cold archives. */
|
|
127
|
+
exports(projectId: string): {
|
|
128
|
+
create: (r?: ExportRequest) => Promise<Export>;
|
|
129
|
+
get: (id: string) => Promise<Export>;
|
|
130
|
+
download: (id: string) => Promise<ReadableStream<Uint8Array>>;
|
|
131
|
+
};
|
|
132
|
+
archives(projectId: string): {
|
|
133
|
+
list: (o?: {
|
|
134
|
+
accountId?: string;
|
|
135
|
+
}) => Promise<Page<Archive>>;
|
|
136
|
+
/** Load an archive back for `days` (1 to 30, default 7); list it with `list(.., { source: 'archive' })`. */
|
|
137
|
+
restore: (id: string, o?: {
|
|
138
|
+
days?: number;
|
|
139
|
+
}) => Promise<Archive>;
|
|
140
|
+
};
|
|
141
|
+
/** Right to erasure. With `approval: true` the erase waits for a second member's `approve` (202 request). */
|
|
142
|
+
privacy(projectId: string): {
|
|
143
|
+
eraseActor: (actorId: string, o?: {
|
|
144
|
+
approval?: boolean;
|
|
145
|
+
}) => Promise<ErasureRequest | ErasureResult>;
|
|
146
|
+
/** Pending requests. */
|
|
147
|
+
erasures: () => Promise<Page<ErasureRequest>>;
|
|
148
|
+
/** By a member other than the requester (else 404). */
|
|
149
|
+
approve: (id: string) => Promise<ErasureResult>;
|
|
150
|
+
/** Withdraw a pending request: its requester, or a member with the privacy permission (else 404). */
|
|
151
|
+
cancel: (id: string) => Promise<void>;
|
|
152
|
+
/** One event, org owners only. */
|
|
153
|
+
deleteEvent: (id: string) => Promise<{
|
|
154
|
+
committed: boolean;
|
|
155
|
+
fields_erased: number;
|
|
156
|
+
}>;
|
|
157
|
+
};
|
|
158
|
+
/** Async iterator over every event, following next_cursor page by page. */
|
|
159
|
+
list(projectId: string, filters?: ListFilters): AsyncGenerator<ActivityEvent, void, undefined>;
|
|
160
|
+
/**
|
|
161
|
+
* Returns the streaming response body (csv, ndjson or OCSF NDJSON). `fields` keeps only those
|
|
162
|
+
* columns/keys (e.g. `['id', 'occurred_at', 'actor.email']`); `chain: true` (ndjson) adds `seq`,
|
|
163
|
+
* `chain_hash`, `prev_hash` and `chain_body` per line for offline verification.
|
|
164
|
+
*/
|
|
165
|
+
export(projectId: string, o: {
|
|
166
|
+
format: 'csv' | 'ndjson' | 'ocsf';
|
|
167
|
+
fields?: string[];
|
|
168
|
+
chain?: boolean;
|
|
169
|
+
} & ListFilters): Promise<ReadableStream<Uint8Array>>;
|
|
170
|
+
/**
|
|
171
|
+
* The browser feed's calls with one viewer credential (a viewer token from
|
|
172
|
+
* `createViewerSession` or an account token `wta_acct_...`), from server code: a backend that
|
|
173
|
+
* renders the log itself, or a support tool. The session's scopes always apply.
|
|
174
|
+
*/
|
|
175
|
+
viewer(token: string): {
|
|
176
|
+
/** Every event of the session's scope, page by page. */
|
|
177
|
+
feed: (filters?: ListFilters) => AsyncGenerator<ActivityEvent, void, undefined>;
|
|
178
|
+
facets: (field: "action" | "actor" | "target_type" | "target", filters?: ListFilters) => Promise<Page<{
|
|
179
|
+
value: string;
|
|
180
|
+
label?: string | null;
|
|
181
|
+
count: number;
|
|
182
|
+
}>>;
|
|
183
|
+
histogram: (filters?: ListFilters) => Promise<Page<{
|
|
184
|
+
at: string;
|
|
185
|
+
count: number;
|
|
186
|
+
}>>;
|
|
187
|
+
/** Server-side saved views; account tokens only (a session gets 404 and keeps views in the browser). */
|
|
188
|
+
views: {
|
|
189
|
+
list: () => Promise<Page<SavedView>>;
|
|
190
|
+
create: (v: {
|
|
191
|
+
name: string;
|
|
192
|
+
q?: string;
|
|
193
|
+
params?: Record<string, string>;
|
|
194
|
+
}) => Promise<SavedView>;
|
|
195
|
+
delete: (id: string) => Promise<void>;
|
|
196
|
+
};
|
|
197
|
+
/** Merkle inclusion proof of one event (capability `verify`; 409 until its hour is signed). */
|
|
198
|
+
proof: (eventId: string) => Promise<Record<string, unknown>>;
|
|
199
|
+
/** Consistency proof between two signed tree heads (`toSize` defaults to the latest). */
|
|
200
|
+
consistency: (fromSize: number, toSize?: number) => Promise<Record<string, unknown>>;
|
|
201
|
+
/** Synchronous download (capability `export`). */
|
|
202
|
+
export: (format: "csv" | "ndjson" | "ocsf", filters?: ListFilters) => Promise<ReadableStream<Uint8Array<ArrayBufferLike>>>;
|
|
203
|
+
exports: {
|
|
204
|
+
list: () => Promise<Page<Export>>;
|
|
205
|
+
create: (r: ExportRequest) => Promise<Export>;
|
|
206
|
+
get: (id: string) => Promise<Export>;
|
|
207
|
+
download: (id: string) => Promise<ReadableStream<Uint8Array<ArrayBufferLike>>>;
|
|
208
|
+
};
|
|
209
|
+
};
|
|
210
|
+
}
|
|
211
|
+
export { ActivityQueue, middleware } from './model4';
|
|
212
|
+
export type { QueueOptions, RequestContext } from './model4';
|
|
213
|
+
export * from './verify';
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,213 @@
|
|
|
1
|
+
import type { AccountToken, AccountTokenIn, ActivityEvent, Archive, Batch, ErasureRequest, ErasureResult, EventIn, Export, ExportRequest, Invite, InviteIn, ListFilters, Page, RecordResult, Rule, RuleIn, RulePatch, SavedView, Stream, StreamIn, StreamPatch, ValidateResult, ViewerSession, ViewerSessionOptions } from './types';
|
|
2
|
+
import { type Seal, type SigningKey } from './model3';
|
|
3
|
+
export type * from './types';
|
|
4
|
+
export { canonicalJson, openSealed } from './model3';
|
|
5
|
+
export type { Seal, SealedEnvelope, SigningKey } from './model3';
|
|
6
|
+
export interface ActivityOptions {
|
|
7
|
+
/** The project's `wti_` secret key with scope `ingest:activity`: record, validate, sessions, list, export. */
|
|
8
|
+
secretKey: string;
|
|
9
|
+
/** An org API key with access to the project, for `accountTokens()`, `streams()` and `rules()` (project management routes do not take `wti_` keys). */
|
|
10
|
+
apiKey?: string;
|
|
11
|
+
baseUrl?: string;
|
|
12
|
+
/**
|
|
13
|
+
* Data residency: the org's region (`us`, `eu`, ...). The client asks `GET /v1/regions` of `baseUrl` once and
|
|
14
|
+
* then talks to that region's API. Either way a `421 wrong_region` answer is followed once.
|
|
15
|
+
*/
|
|
16
|
+
region?: string;
|
|
17
|
+
/** Opt in to constructing in a browser. Do not: the secret key would ship to users. */
|
|
18
|
+
allowBrowser?: boolean;
|
|
19
|
+
maxRetries?: number;
|
|
20
|
+
fetch?: typeof fetch;
|
|
21
|
+
/** Test hook; defaults to setTimeout. */
|
|
22
|
+
sleep?: (ms: number) => Promise<void>;
|
|
23
|
+
/**
|
|
24
|
+
* Fill `trace_id`/`span_id` of events that have none from the active OpenTelemetry span.
|
|
25
|
+
* Default: on when `@opentelemetry/api` is installed (an optional peer, loaded lazily); `false`
|
|
26
|
+
* turns it off; a function supplies the ids yourself.
|
|
27
|
+
*/
|
|
28
|
+
traceContext?: boolean | (() => SpanIds | undefined);
|
|
29
|
+
/** Sign every recorded event (customer-signed events; register the public key under `kid`). */
|
|
30
|
+
signingKey?: SigningKey;
|
|
31
|
+
/** Encrypt these event paths here (AES-256-GCM); `openSealed` decrypts. */
|
|
32
|
+
seal?: Seal;
|
|
33
|
+
}
|
|
34
|
+
export interface SpanIds {
|
|
35
|
+
trace_id: string;
|
|
36
|
+
span_id: string;
|
|
37
|
+
}
|
|
38
|
+
/** RFC 9457 problem+json mapped to an Error. */
|
|
39
|
+
export declare class ActivityError extends Error {
|
|
40
|
+
readonly status: number;
|
|
41
|
+
readonly type: string;
|
|
42
|
+
readonly title: string;
|
|
43
|
+
readonly detail?: string;
|
|
44
|
+
readonly instance?: string;
|
|
45
|
+
readonly extensions: Record<string, unknown>;
|
|
46
|
+
constructor(status: number, p?: Record<string, unknown>);
|
|
47
|
+
}
|
|
48
|
+
export declare class Activity {
|
|
49
|
+
#private;
|
|
50
|
+
constructor(opts: ActivityOptions);
|
|
51
|
+
/** Never expose the key via console.log / util.inspect / JSON.stringify. */
|
|
52
|
+
toJSON(): {
|
|
53
|
+
baseUrl: string;
|
|
54
|
+
};
|
|
55
|
+
/**
|
|
56
|
+
* At-least-once: a retry after a lost response can re-send, so supply your own stable
|
|
57
|
+
* idempotency_key per business event; the server dedupes on (project, key).
|
|
58
|
+
* `dryRun` validates without storing (POST /v1/activity/events/validate).
|
|
59
|
+
*/
|
|
60
|
+
record(event: EventIn, o: {
|
|
61
|
+
dryRun: true;
|
|
62
|
+
}): Promise<ValidateResult>;
|
|
63
|
+
record(event: EventIn, o?: {
|
|
64
|
+
dryRun?: false;
|
|
65
|
+
}): Promise<RecordResult>;
|
|
66
|
+
/** Normalized stored form, schema warnings, missing template and PII detector hits; stores nothing. */
|
|
67
|
+
validate(events: EventIn | EventIn[]): Promise<ValidateResult>;
|
|
68
|
+
/**
|
|
69
|
+
* `partial: true`: batches of 1000, bad events are listed in `rejected` instead of failing the batch.
|
|
70
|
+
* `receipts: true`: a signed receipt per accepted event (check with `verifyReceipt`).
|
|
71
|
+
* `async: true`: queued server-side; poll `batch(id)` for each of `batch_ids`.
|
|
72
|
+
*/
|
|
73
|
+
recordBatch(events: EventIn[], o?: {
|
|
74
|
+
partial?: boolean;
|
|
75
|
+
receipts?: boolean;
|
|
76
|
+
async?: boolean;
|
|
77
|
+
}): Promise<RecordResult>;
|
|
78
|
+
/** The state of an async batch (`recordBatch(..., { async: true })`). */
|
|
79
|
+
batch(id: string): Promise<Batch>;
|
|
80
|
+
/** One event by id (with lookup `labels`). */
|
|
81
|
+
getEvent(projectId: string, id: string): Promise<ActivityEvent>;
|
|
82
|
+
/** Write 25 realistic sample events into one account (default `sample`) through the ingest pipeline. */
|
|
83
|
+
samples(projectId: string, o?: {
|
|
84
|
+
accountId?: string;
|
|
85
|
+
}): Promise<{
|
|
86
|
+
account_id: string;
|
|
87
|
+
accepted: number;
|
|
88
|
+
}>;
|
|
89
|
+
createViewerSession(o: ViewerSessionOptions): Promise<ViewerSession>;
|
|
90
|
+
/** Revoke one viewer session by its `jti`. */
|
|
91
|
+
revokeSession(jti: string): Promise<void>;
|
|
92
|
+
/** Revoke every live viewer session of an account (e.g. on offboarding). Returns how many were live. */
|
|
93
|
+
revokeAccountSessions(accountId: string): Promise<{
|
|
94
|
+
revoked: number;
|
|
95
|
+
}>;
|
|
96
|
+
/** End-customer API tokens (`wta_acct_...`) of one account; the token string is in the create response only. */
|
|
97
|
+
accountTokens(projectId: string, accountId: string): {
|
|
98
|
+
list: () => Promise<Page<AccountToken>>;
|
|
99
|
+
create: (o: AccountTokenIn) => Promise<AccountToken>;
|
|
100
|
+
revoke: (id: string) => Promise<undefined>;
|
|
101
|
+
};
|
|
102
|
+
/** Email a one-time link to the account's hosted page (single use; it becomes a fresh session when opened). */
|
|
103
|
+
invite(projectId: string, accountId: string, o: InviteIn): Promise<Invite>;
|
|
104
|
+
/** SIEM / log streams (secrets are write-only). */
|
|
105
|
+
streams(projectId: string): {
|
|
106
|
+
list: () => Promise<Page<Stream>>;
|
|
107
|
+
get: (id: string) => Promise<Stream>;
|
|
108
|
+
create: (s: StreamIn) => Promise<Stream>;
|
|
109
|
+
update: (id: string, patch: StreamPatch) => Promise<Stream>;
|
|
110
|
+
/** Re-send everything received since `from` (RFC 3339, within retention). */
|
|
111
|
+
replay: (id: string, o: {
|
|
112
|
+
from: string;
|
|
113
|
+
}) => Promise<Stream>;
|
|
114
|
+
delete: (id: string) => Promise<undefined>;
|
|
115
|
+
/** Queues a test delivery (202); poll `get(id)` for `last_test`. */
|
|
116
|
+
test: (id: string) => Promise<undefined>;
|
|
117
|
+
};
|
|
118
|
+
/** Alert rules on chosen actions (email, Slack, signed webhook). */
|
|
119
|
+
rules(projectId: string): {
|
|
120
|
+
list: () => Promise<Page<Rule>>;
|
|
121
|
+
create: (r: RuleIn) => Promise<Rule>;
|
|
122
|
+
/** A new `channel` returns a new `signing_secret` for webhooks. */
|
|
123
|
+
update: (id: string, patch: RulePatch) => Promise<Rule>;
|
|
124
|
+
delete: (id: string) => Promise<undefined>;
|
|
125
|
+
};
|
|
126
|
+
/** Async exports (the file is kept 24 h) and restores of cold archives. */
|
|
127
|
+
exports(projectId: string): {
|
|
128
|
+
create: (r?: ExportRequest) => Promise<Export>;
|
|
129
|
+
get: (id: string) => Promise<Export>;
|
|
130
|
+
download: (id: string) => Promise<ReadableStream<Uint8Array>>;
|
|
131
|
+
};
|
|
132
|
+
archives(projectId: string): {
|
|
133
|
+
list: (o?: {
|
|
134
|
+
accountId?: string;
|
|
135
|
+
}) => Promise<Page<Archive>>;
|
|
136
|
+
/** Load an archive back for `days` (1 to 30, default 7); list it with `list(.., { source: 'archive' })`. */
|
|
137
|
+
restore: (id: string, o?: {
|
|
138
|
+
days?: number;
|
|
139
|
+
}) => Promise<Archive>;
|
|
140
|
+
};
|
|
141
|
+
/** Right to erasure. With `approval: true` the erase waits for a second member's `approve` (202 request). */
|
|
142
|
+
privacy(projectId: string): {
|
|
143
|
+
eraseActor: (actorId: string, o?: {
|
|
144
|
+
approval?: boolean;
|
|
145
|
+
}) => Promise<ErasureRequest | ErasureResult>;
|
|
146
|
+
/** Pending requests. */
|
|
147
|
+
erasures: () => Promise<Page<ErasureRequest>>;
|
|
148
|
+
/** By a member other than the requester (else 404). */
|
|
149
|
+
approve: (id: string) => Promise<ErasureResult>;
|
|
150
|
+
/** Withdraw a pending request: its requester, or a member with the privacy permission (else 404). */
|
|
151
|
+
cancel: (id: string) => Promise<void>;
|
|
152
|
+
/** One event, org owners only. */
|
|
153
|
+
deleteEvent: (id: string) => Promise<{
|
|
154
|
+
committed: boolean;
|
|
155
|
+
fields_erased: number;
|
|
156
|
+
}>;
|
|
157
|
+
};
|
|
158
|
+
/** Async iterator over every event, following next_cursor page by page. */
|
|
159
|
+
list(projectId: string, filters?: ListFilters): AsyncGenerator<ActivityEvent, void, undefined>;
|
|
160
|
+
/**
|
|
161
|
+
* Returns the streaming response body (csv, ndjson or OCSF NDJSON). `fields` keeps only those
|
|
162
|
+
* columns/keys (e.g. `['id', 'occurred_at', 'actor.email']`); `chain: true` (ndjson) adds `seq`,
|
|
163
|
+
* `chain_hash`, `prev_hash` and `chain_body` per line for offline verification.
|
|
164
|
+
*/
|
|
165
|
+
export(projectId: string, o: {
|
|
166
|
+
format: 'csv' | 'ndjson' | 'ocsf';
|
|
167
|
+
fields?: string[];
|
|
168
|
+
chain?: boolean;
|
|
169
|
+
} & ListFilters): Promise<ReadableStream<Uint8Array>>;
|
|
170
|
+
/**
|
|
171
|
+
* The browser feed's calls with one viewer credential (a viewer token from
|
|
172
|
+
* `createViewerSession` or an account token `wta_acct_...`), from server code: a backend that
|
|
173
|
+
* renders the log itself, or a support tool. The session's scopes always apply.
|
|
174
|
+
*/
|
|
175
|
+
viewer(token: string): {
|
|
176
|
+
/** Every event of the session's scope, page by page. */
|
|
177
|
+
feed: (filters?: ListFilters) => AsyncGenerator<ActivityEvent, void, undefined>;
|
|
178
|
+
facets: (field: "action" | "actor" | "target_type" | "target", filters?: ListFilters) => Promise<Page<{
|
|
179
|
+
value: string;
|
|
180
|
+
label?: string | null;
|
|
181
|
+
count: number;
|
|
182
|
+
}>>;
|
|
183
|
+
histogram: (filters?: ListFilters) => Promise<Page<{
|
|
184
|
+
at: string;
|
|
185
|
+
count: number;
|
|
186
|
+
}>>;
|
|
187
|
+
/** Server-side saved views; account tokens only (a session gets 404 and keeps views in the browser). */
|
|
188
|
+
views: {
|
|
189
|
+
list: () => Promise<Page<SavedView>>;
|
|
190
|
+
create: (v: {
|
|
191
|
+
name: string;
|
|
192
|
+
q?: string;
|
|
193
|
+
params?: Record<string, string>;
|
|
194
|
+
}) => Promise<SavedView>;
|
|
195
|
+
delete: (id: string) => Promise<void>;
|
|
196
|
+
};
|
|
197
|
+
/** Merkle inclusion proof of one event (capability `verify`; 409 until its hour is signed). */
|
|
198
|
+
proof: (eventId: string) => Promise<Record<string, unknown>>;
|
|
199
|
+
/** Consistency proof between two signed tree heads (`toSize` defaults to the latest). */
|
|
200
|
+
consistency: (fromSize: number, toSize?: number) => Promise<Record<string, unknown>>;
|
|
201
|
+
/** Synchronous download (capability `export`). */
|
|
202
|
+
export: (format: "csv" | "ndjson" | "ocsf", filters?: ListFilters) => Promise<ReadableStream<Uint8Array<ArrayBufferLike>>>;
|
|
203
|
+
exports: {
|
|
204
|
+
list: () => Promise<Page<Export>>;
|
|
205
|
+
create: (r: ExportRequest) => Promise<Export>;
|
|
206
|
+
get: (id: string) => Promise<Export>;
|
|
207
|
+
download: (id: string) => Promise<ReadableStream<Uint8Array<ArrayBufferLike>>>;
|
|
208
|
+
};
|
|
209
|
+
};
|
|
210
|
+
}
|
|
211
|
+
export { ActivityQueue, middleware } from './model4';
|
|
212
|
+
export type { QueueOptions, RequestContext } from './model4';
|
|
213
|
+
export * from './verify';
|