@xtandard/audit 0.1.0 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,8 +1,8 @@
1
1
  <div align="center">
2
2
 
3
3
  <picture>
4
- <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/xantiagoma/xtandard-audit/main/docs/assets/lockup-horizontal-dark.png" />
5
- <img src="https://raw.githubusercontent.com/xantiagoma/xtandard-audit/main/docs/assets/lockup-horizontal-light.png" alt="@xtandard/audit" height="64" />
4
+ <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/xantiagoma/xtandard-audit/main/docs/assets/lockup-horizontal-dark.svg" />
5
+ <img src="https://raw.githubusercontent.com/xantiagoma/xtandard-audit/main/docs/assets/lockup-horizontal-light.svg" alt="@xtandard/audit" height="64" />
6
6
  </picture>
7
7
 
8
8
  # @xtandard/audit
@@ -366,14 +366,16 @@ ZeroVer (`0.x`) and pre-first-publish: the surface is stabilizing, minor version
366
366
 
367
367
  `@xtandard/audit` is one of a family of open-source, MIT-licensed projects that share the xtandard name. They are independent of each other: use any of them on its own.
368
368
 
369
- | Project | What it is | Links |
370
- | ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
371
- | **`@xtandard/audit`** (this package) | A self-hosted, embeddable, tamper-evident audit-log control plane for B2B SaaS: a WorkOS Audit Logs alternative as a library | [Docs](https://me.xantiagoma.com/xtandard-audit/) · [GitHub](https://github.com/xantiagoma/xtandard-audit) · [npm](https://www.npmjs.com/package/@xtandard/audit) |
372
- | **`@xtandard/lib`** | Lightweight, type-safe TypeScript utilities with a zero-dependency core | [Docs](https://me.xantiagoma.com/xtandard/) · [GitHub](https://github.com/xantiagoma/xtandard) · [npm](https://www.npmjs.com/package/@xtandard/lib) |
373
- | **`@xtandard/flags`** | A self-hosted, embeddable, OpenFeature-compatible feature-flag control plane with pluggable storage | [Docs](https://me.xantiagoma.com/xtandard-flags/) · [GitHub](https://github.com/xantiagoma/xtandard-flags) · [npm](https://www.npmjs.com/package/@xtandard/flags) |
374
- | **`@xtandard/webhooks`** | A self-hosted, embeddable, Standard Webhooks-compliant outbound-webhooks control plane: a Svix alternative as a library | [Docs](https://me.xantiagoma.com/xtandard-webhooks/) · [GitHub](https://github.com/xantiagoma/xtandard-webhooks) · [npm](https://www.npmjs.com/package/@xtandard/webhooks) |
375
- | **`@xtandard/xyte`** | A Zyte API-compatible `/v1/extract` client and server that runs on any proxy provider, or none | [Docs](https://me.xantiagoma.com/xyte/) · [GitHub](https://github.com/xantiagoma/xyte) · [npm](https://www.npmjs.com/package/@xtandard/xyte) |
376
- | **xtandard-image** | A self-hosted image and video processing server in Go and libvips: imgproxy-compatible URLs plus the imgix, Cloudinary, ImageKit, Cloudflare and Thumbor dialects, with a TypeScript client (`@xtandard/image`) | [Docs](https://me.xantiagoma.com/xtandard-image/) · [GitHub](https://github.com/xantiagoma/xtandard-image) · [npm](https://www.npmjs.com/package/@xtandard/image) |
369
+ | Project | What it is | Links |
370
+ | ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
371
+ | **`@xtandard/audit`** (this package) | A self-hosted, embeddable, tamper-evident audit-log control plane for B2B SaaS: a WorkOS Audit Logs alternative as a library | [Docs](https://me.xantiagoma.com/xtandard-audit/) · [GitHub](https://github.com/xantiagoma/xtandard-audit) · [npm](https://www.npmjs.com/package/@xtandard/audit) |
372
+ | **`@xtandard/lib`** | Lightweight, type-safe TypeScript utilities with a zero-dependency core | [Docs](https://me.xantiagoma.com/xtandard/) · [GitHub](https://github.com/xantiagoma/xtandard) · [npm](https://www.npmjs.com/package/@xtandard/lib) |
373
+ | **`@xtandard/flags`** | A self-hosted, embeddable, OpenFeature-compatible feature-flag control plane with pluggable storage | [Docs](https://me.xantiagoma.com/xtandard-flags/) · [GitHub](https://github.com/xantiagoma/xtandard-flags) · [npm](https://www.npmjs.com/package/@xtandard/flags) |
374
+ | **`@xtandard/webhooks`** | A self-hosted, embeddable, Standard Webhooks-compliant outbound-webhooks control plane: a Svix alternative as a library | [Docs](https://me.xantiagoma.com/xtandard-webhooks/) · [GitHub](https://github.com/xantiagoma/xtandard-webhooks) · [npm](https://www.npmjs.com/package/@xtandard/webhooks) |
375
+ | **`@xtandard/links`** | Self-hosted, embeddable branded short links with click analytics, conversion attribution and deep links: a Dub / Bitly alternative as a library | [Docs](https://me.xantiagoma.com/xtandard-links/) · [GitHub](https://github.com/xantiagoma/xtandard-links) · [npm](https://www.npmjs.com/package/@xtandard/links) |
376
+ | **`@xtandard/entitlements`** | An embeddable entitlements, plans and usage-metering engine: typed catalog, atomic metering, any billing provider, admin UI and customer portal | [Docs](https://me.xantiagoma.com/xtandard-entitlements/) · [GitHub](https://github.com/xantiagoma/xtandard-entitlements) · [npm](https://www.npmjs.com/package/@xtandard/entitlements) |
377
+ | **`@xtandard/xyte`** | A Zyte API-compatible `/v1/extract` client and server that runs on any proxy provider, or none | [Docs](https://me.xantiagoma.com/xyte/) · [GitHub](https://github.com/xantiagoma/xyte) · [npm](https://www.npmjs.com/package/@xtandard/xyte) |
378
+ | **xtandard-image** | A self-hosted image and video processing server in Go and libvips: imgproxy-compatible URLs plus the imgix, Cloudinary, ImageKit, Cloudflare and Thumbor dialects, with a TypeScript client (`@xtandard/image`) | [Docs](https://me.xantiagoma.com/xtandard-image/) · [GitHub](https://github.com/xantiagoma/xtandard-image) · [npm](https://www.npmjs.com/package/@xtandard/image) |
377
379
 
378
380
  ### Related
379
381
 
package/dist/cli.cjs CHANGED
@@ -220,9 +220,12 @@ async function streamsFromEnv() {
220
220
  }
221
221
  return out;
222
222
  }
223
+ /** `AUTH_MODE`, with an empty value meaning the default `none`. */
224
+ const authModeFromEnv = () => process.env.AUTH_MODE || "none";
223
225
  /** Build the auth + authorization providers from env (mirrors the standalone app). */
224
226
  async function buildAuth() {
225
- if (env("AUTH_MODE", "none") === "basic") {
227
+ const mode = authModeFromEnv();
228
+ if (mode === "basic") {
226
229
  const [{ basicAuth }, { rolesAuthorization }] = await Promise.all([Promise.resolve().then(() => require("./basic-hcXnMF9X.cjs")).then((n) => n.basic_exports), Promise.resolve().then(() => require("./roles-BARtYLSX.cjs")).then((n) => n.roles_exports)]);
227
230
  const passwordHash = env("AUTH_PASSWORD_HASH");
228
231
  const password = env("AUTH_PASSWORD");
@@ -237,6 +240,7 @@ async function buildAuth() {
237
240
  authorization: rolesAuthorization({})
238
241
  };
239
242
  }
243
+ if (mode !== "none") throw new Error(`Unknown AUTH_MODE "${mode}" (expected none or basic)`);
240
244
  const [{ noAuth }, { noAuthorization }] = await Promise.all([Promise.resolve().then(() => require("./none-CGmIIbI8.cjs")).then((n) => n.none_exports), Promise.resolve().then(() => require("./none-Be7r6kHH.cjs")).then((n) => n.none_exports)]);
241
245
  return {
242
246
  auth: noAuth(),
@@ -463,7 +467,7 @@ Environment variables
463
467
  TITLE Navbar wordmark.
464
468
  LOGO_URL Logo image URL.
465
469
  READONLY 1|true Block all mutating operations.
466
- AUTH_MODE none|basic Authentication mode (default none).
470
+ AUTH_MODE none|basic Authentication mode (default none; any other value is rejected).
467
471
  AUTH_USERNAME admin Username for basic auth.
468
472
  AUTH_PASSWORD_HASH scrypt hash (preferred; see docs/AUTH.md).
469
473
  AUTH_PASSWORD Plaintext password (dev only).
@@ -704,15 +708,15 @@ async function run(argv) {
704
708
  const title = env("TITLE", "@xtandard/audit");
705
709
  const logoUrl = env("LOGO_URL");
706
710
  const readonly = isTruthy(env("READONLY"));
707
- const authMode = env("AUTH_MODE", "none");
711
+ const authMode = authModeFromEnv();
708
712
  const portalSecret = env("PORTAL_SECRET");
709
713
  const maintenanceRaw = env("MAINTENANCE_INTERVAL");
714
+ const { auth, authorization } = await buildAuth();
710
715
  const { createFetchHandler } = await Promise.resolve().then(() => require("./create-fetch-handler-D8cTMVX9.cjs")).then((n) => n.create_fetch_handler_exports);
711
- const [storage, signer, streams, { auth, authorization }] = await Promise.all([
716
+ const [storage, signer, streams] = await Promise.all([
712
717
  buildStorage(),
713
718
  signerFromEnv(),
714
- streamsFromEnv(),
715
- buildAuth()
719
+ streamsFromEnv()
716
720
  ]);
717
721
  if (authMode === "none") warn("AUTH_MODE=none — do NOT expose this publicly without authentication.");
718
722
  const retention = retentionFromEnv();
package/dist/cli.cjs.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"cli.cjs","names":["ed25519Signer","hmacSigner","createAuditCore","keysFromJwks","generateSigningKeyPair","EXPORT_CONTENT_TYPES","exportEvents","parseBundle","hmacVerificationKey","verifyBundle"],"sources":["../src/cli.ts"],"sourcesContent":["/**\n * `xtandard-audit` CLI. Operates on the same storage your app/panel uses\n * (configured via `STORAGE_DRIVER` and friends, mirroring the standalone app),\n * so it slots into shell, CI, cron and auditor workflows.\n *\n * Commands: `serve` (panel + streams + retention, no Docker), `record`,\n * `query`, `export`, `verify` (a bundle offline, or a tenant in storage),\n * `prune`, `checkpoint`, `keygen`, `tenants`, `actions`.\n *\n * Storage drivers and sinks are loaded lazily by **dynamic import of their\n * subpath entries** (`entry-storage-<driver>`, `entry-sinks-<kind>`) next to\n * this module, so the CLI only pulls the peer dependency of the driver you\n * pick — and a driver that is not part of a build is a clear runtime error,\n * not a bundling failure.\n *\n * @module\n */\n\nimport type { AuthProvider } from \"./auth/contract.ts\";\nimport type { AuthorizationProvider } from \"./authorization/contract.ts\";\nimport { createAuditCore, type AuditCore, type RetentionOptions } from \"./core.ts\";\nimport { durationToMs } from \"./duration.ts\";\nimport {\n EXPORT_CONTENT_TYPES,\n exportEvents,\n parseBundle,\n verifyBundle,\n type ExportFormat,\n} from \"./export.ts\";\nimport {\n ed25519Signer,\n generateSigningKeyPair,\n hmacSigner,\n hmacVerificationKey,\n keysFromJwks,\n type AuditSigner,\n type AuditVerificationKey,\n type VerifyReport,\n} from \"./integrity.ts\";\nimport type { AuditDuration, AuditEventInput, AuditQuery, JsonObject } from \"./schema.ts\";\nimport type { ActionMap } from \"./standard-schema.ts\";\nimport type { AuditStorage } from \"./storage/contract.ts\";\nimport type { AuditSink, StreamDefinition } from \"./streams.ts\";\n\n/** The storage drivers the CLI knows how to configure from env. */\nexport const CLI_DRIVERS = [\n \"memory\",\n \"file\",\n \"redis\",\n \"postgres\",\n \"mongodb\",\n \"sqlite\",\n \"libsql\",\n] as const;\ntype Driver = (typeof CLI_DRIVERS)[number];\n\nconst env = (key: string, fallback = \"\"): string => process.env[key] ?? fallback;\n\nconst isTruthy = (value: string): boolean => value === \"1\" || value.toLowerCase() === \"true\";\nconst isFalsy = (value: string): boolean => value === \"0\" || value.toLowerCase() === \"false\";\n\nconst warn = (message: string): void => {\n process.stderr.write(`[xtandard/audit] ${message}\\n`);\n};\n\n/** Raised when a lazily-imported subpath entry is not part of this build. */\nexport class MissingModuleError extends Error {\n constructor(message: string) {\n super(message);\n this.name = \"MissingModuleError\";\n }\n}\n\n/**\n * Import a sibling entry module by name: `./<entry>.mjs` in the built package\n * (`dist/`), `./<entry>.ts` when running from source. The specifier is computed\n * so bundlers leave it alone. Errors raised *inside* a found module (e.g. a\n * missing peer dependency) propagate unchanged.\n */\nexport async function importEntry(entry: string): Promise<Record<string, unknown>> {\n for (const ext of [\".mjs\", \".ts\"]) {\n const specifier = `./${entry}${ext}`;\n try {\n return (await import(/* @vite-ignore */ specifier)) as Record<string, unknown>;\n } catch (err) {\n const message = err instanceof Error ? err.message : String(err);\n const code = (err as { code?: string }).code;\n const notFound =\n code === \"ERR_MODULE_NOT_FOUND\" ||\n /Cannot find (module|package)|Failed to load url|failed to resolve|does not exist/i.test(\n message,\n );\n if (notFound && message.includes(entry)) continue;\n throw err;\n }\n }\n throw new MissingModuleError(`Module \"${entry}\" is not available in this build`);\n}\n\n/** Find a factory export by name, else the single export matching `pattern`. */\nfunction pickFactory<T>(\n mod: Record<string, unknown>,\n name: string,\n pattern: RegExp,\n): ((...args: unknown[]) => T) | null {\n if (typeof mod[name] === \"function\") return mod[name] as (...args: unknown[]) => T;\n const candidates = Object.entries(mod).filter(\n ([k, v]) => typeof v === \"function\" && pattern.test(k),\n );\n return candidates.length === 1 ? (candidates[0]![1] as (...args: unknown[]) => T) : null;\n}\n\n/** The storage driver named by `STORAGE_DRIVER` (CLI default: `file`). */\nfunction driverFromEnv(): Driver {\n const raw = env(\"STORAGE_DRIVER\", \"file\") || \"file\";\n if (!(CLI_DRIVERS as readonly string[]).includes(raw)) {\n throw new Error(`Unknown STORAGE_DRIVER \"${raw}\" (expected ${CLI_DRIVERS.join(\" | \")})`);\n }\n return raw as Driver;\n}\n\n/** Driver → [entry module, factory export, options from env]. */\nfunction driverSpec(driver: Driver): [string, string, Record<string, unknown>] {\n switch (driver) {\n case \"memory\":\n return [\"entry-storage-memory\", \"createMemoryStorage\", {}];\n case \"redis\":\n return [\n \"entry-storage-redis\",\n \"createRedisStorage\",\n {\n url: env(\"REDIS_URL\", \"redis://localhost:6379\"),\n prefix: env(\"STORAGE_PREFIX\", \"xtandard:audit\"),\n },\n ];\n case \"postgres\":\n return [\n \"entry-storage-postgres\",\n \"createPostgresStorage\",\n {\n connectionString:\n env(\"DATABASE_URL\") || env(\"POSTGRES_URL\", \"postgres://localhost:5432/postgres\"),\n table: env(\"STORAGE_PG_TABLE\", \"xtandard_audit\"),\n },\n ];\n case \"mongodb\":\n return [\n \"entry-storage-mongodb\",\n \"createMongoStorage\",\n {\n url: env(\"MONGO_URL\", \"mongodb://localhost:27017\"),\n dbName: env(\"MONGO_DB\", \"xtandard_audit\"),\n collectionName: env(\"STORAGE_MONGO_COLLECTION\", \"audit\"),\n },\n ];\n case \"sqlite\":\n // Requires running the CLI under Bun (`bunx xtandard-audit …`).\n return [\n \"entry-storage-sqlite\",\n \"createSqliteStorage\",\n { path: env(\"STORAGE_SQLITE_PATH\", \"./.audit/audit.sqlite\") },\n ];\n case \"libsql\": {\n const authToken = env(\"LIBSQL_AUTH_TOKEN\");\n return [\n \"entry-storage-libsql\",\n \"createLibsqlStorage\",\n {\n url: env(\"LIBSQL_URL\", \"file:./.audit/audit.db\"),\n ...(authToken ? { authToken } : {}),\n },\n ];\n }\n case \"file\":\n return [\n \"entry-storage-file\",\n \"createFileStorage\",\n { dir: env(\"STORAGE_FILE_DIR\", \"./.audit\") },\n ];\n }\n}\n\n/** Build the storage from env, importing the driver's subpath lazily. */\nexport async function buildStorage(): Promise<AuditStorage> {\n const driver = driverFromEnv();\n const [entry, factoryName, options] = driverSpec(driver);\n let mod: Record<string, unknown>;\n try {\n mod = await importEntry(entry);\n } catch (err) {\n if (err instanceof MissingModuleError) {\n throw new Error(\n `Storage driver \"${driver}\" is not available (missing @xtandard/audit/storage/${driver})`,\n );\n }\n throw err;\n }\n const factory = pickFactory<AuditStorage>(mod, factoryName, /^create\\w*Storage$/);\n if (!factory) throw new Error(`@xtandard/audit/storage/${driver} exports no ${factoryName}`);\n return factory(options);\n}\n\n/**\n * A human-readable, log-safe description of where storage persists data — for\n * the `serve` startup banner. Connection-string drivers print only the driver\n * name (never the URL, which may carry credentials).\n */\nasync function describeStorage(): Promise<string> {\n const { resolve } = await import(\"node:path\");\n const driver = driverFromEnv();\n switch (driver) {\n case \"file\":\n return `file → ${resolve(env(\"STORAGE_FILE_DIR\", \"./.audit\"))}`;\n case \"sqlite\":\n return `sqlite → ${resolve(env(\"STORAGE_SQLITE_PATH\", \"./.audit/audit.sqlite\"))}`;\n case \"memory\":\n return \"memory (ephemeral — not persisted)\";\n default:\n return driver;\n }\n}\n\n/** Parse a duration env like `\"365d\"`, warning and ignoring malformed values. */\nfunction parseDurationEnv(name: string): AuditDuration | undefined {\n const raw = env(name);\n if (!raw) return undefined;\n try {\n durationToMs(raw as AuditDuration); // validate eagerly\n return raw as AuditDuration;\n } catch {\n warn(`Ignoring ${name}=\"${raw}\" — expected <number><unit> with unit ms|s|m|h|d (e.g. 365d).`);\n return undefined;\n }\n}\n\n/** Retention from env: `RETENTION_MAX_AGE` / `RETENTION_KEEP_LAST`. */\nexport function retentionFromEnv(): RetentionOptions | undefined {\n const keepRaw = env(\"RETENTION_KEEP_LAST\");\n const keepLast = keepRaw && /^\\d+$/.test(keepRaw) ? Number(keepRaw) : undefined;\n if (keepRaw && keepLast === undefined) {\n warn(`Ignoring RETENTION_KEEP_LAST=\"${keepRaw}\" — expected a number.`);\n }\n const maxAge = parseDurationEnv(\"RETENTION_MAX_AGE\");\n if (keepLast === undefined && !maxAge) return undefined;\n return {\n ...(keepLast !== undefined ? { keepLast } : {}),\n ...(maxAge !== undefined ? { maxAge } : {}),\n };\n}\n\n/** Checkpoint signer from env: `AUDIT_SIGNING_KEY` (Ed25519 private JWK JSON) or `AUDIT_HMAC_SECRET`. */\nexport async function signerFromEnv(): Promise<AuditSigner | undefined> {\n const jwk = env(\"AUDIT_SIGNING_KEY\");\n if (jwk) {\n let parsed: JsonWebKey;\n try {\n parsed = JSON.parse(jwk) as JsonWebKey;\n } catch {\n throw new Error(\n \"AUDIT_SIGNING_KEY must be a private JWK as JSON (see `xtandard-audit keygen`)\",\n );\n }\n return ed25519Signer(parsed);\n }\n const secret = env(\"AUDIT_HMAC_SECRET\");\n return secret ? hmacSigner(secret) : undefined;\n}\n\n/** A stream declared in `AUDIT_STREAMS` (JSON array). */\ninterface StreamEnv {\n name: string;\n /** Sink kind: loads `@xtandard/audit/sinks/<sink>` and calls its `<kind>Sink(options)` factory. */\n sink: string;\n options?: Record<string, unknown>;\n tenants?: string[];\n filter?: StreamDefinition[\"filter\"];\n batchSize?: number;\n startFrom?: \"beginning\" | \"now\";\n checkpoints?: boolean;\n}\n\nconst camel = (kind: string) => kind.replace(/-([a-z])/g, (_, c: string) => c.toUpperCase());\n\n/** Streams from `AUDIT_STREAMS` (JSON array of {@link StreamEnv}). */\nexport async function streamsFromEnv(): Promise<StreamDefinition[]> {\n const raw = env(\"AUDIT_STREAMS\");\n if (!raw) return [];\n let specs: StreamEnv[];\n try {\n specs = JSON.parse(raw) as StreamEnv[];\n if (!Array.isArray(specs)) throw new Error(\"not an array\");\n } catch {\n throw new Error('AUDIT_STREAMS must be a JSON array of { \"name\", \"sink\", \"options\"? , … }');\n }\n const out: StreamDefinition[] = [];\n for (const spec of specs) {\n let mod: Record<string, unknown>;\n try {\n mod = await importEntry(`entry-sinks-${spec.sink}`);\n } catch (err) {\n if (err instanceof MissingModuleError) {\n throw new Error(\n `Sink \"${spec.sink}\" (stream \"${spec.name}\") is not available (missing @xtandard/audit/sinks/${spec.sink})`,\n );\n }\n throw err;\n }\n const factory = pickFactory<AuditSink>(mod, `${camel(spec.sink)}Sink`, /Sink$/);\n if (!factory) throw new Error(`@xtandard/audit/sinks/${spec.sink} exports no sink factory`);\n out.push({\n name: spec.name,\n sink: await factory(spec.options ?? {}),\n ...(spec.tenants ? { tenants: spec.tenants } : {}),\n ...(spec.filter ? { filter: spec.filter } : {}),\n ...(spec.batchSize ? { batchSize: spec.batchSize } : {}),\n ...(spec.startFrom ? { startFrom: spec.startFrom } : {}),\n ...(spec.checkpoints !== undefined ? { checkpoints: spec.checkpoints } : {}),\n });\n }\n return out;\n}\n\n/** Build the auth + authorization providers from env (mirrors the standalone app). */\nasync function buildAuth(): Promise<{ auth: AuthProvider; authorization: AuthorizationProvider }> {\n const mode = env(\"AUTH_MODE\", \"none\");\n if (mode === \"basic\") {\n const [{ basicAuth }, { rolesAuthorization }] = await Promise.all([\n import(\"./auth/basic.ts\"),\n import(\"./authorization/roles.ts\"),\n ]);\n const passwordHash = env(\"AUTH_PASSWORD_HASH\");\n const password = env(\"AUTH_PASSWORD\");\n if (!passwordHash && !password) {\n warn(\"AUTH_MODE=basic but neither AUTH_PASSWORD_HASH nor AUTH_PASSWORD is set.\");\n }\n return {\n auth: basicAuth({\n users: [\n {\n username: env(\"AUTH_USERNAME\", \"admin\"),\n ...(passwordHash ? { passwordHash } : {}),\n ...(password ? { password } : {}),\n roles: [env(\"AUTH_ROLE\", \"admin\")],\n },\n ],\n }),\n authorization: rolesAuthorization({}),\n };\n }\n const [{ noAuth }, { noAuthorization }] = await Promise.all([\n import(\"./auth/none.ts\"),\n import(\"./authorization/none.ts\"),\n ]);\n return { auth: noAuth(), authorization: noAuthorization() };\n}\n\ntype FetchHandler = (request: Request) => Response | Promise<Response>;\n\n/**\n * Serve a web-standard fetch handler under whatever runtime the CLI runs on:\n * `Bun.serve` under `bunx`, a `node:http` bridge under `npx`/Node (streaming\n * response bodies, so exports are never buffered). Resolves once listening.\n */\nasync function startServer(port: number, fetch: FetchHandler): Promise<void> {\n const bun = (globalThis as { Bun?: { serve: (options: unknown) => unknown } }).Bun;\n if (bun) {\n bun.serve({ port, fetch });\n return;\n }\n const { createServer } = await import(\"node:http\");\n const server = createServer((req, res) => {\n void (async () => {\n try {\n const chunks: Buffer[] = [];\n for await (const c of req) chunks.push(c as Buffer);\n const method = req.method ?? \"GET\";\n const headers = new Headers();\n for (const [k, v] of Object.entries(req.headers)) {\n if (v === undefined) continue;\n headers.set(k, Array.isArray(v) ? v.join(\", \") : v);\n }\n const host = req.headers.host ?? `localhost:${port}`;\n const url = `http://${host}${req.url ?? \"/\"}`;\n const hasBody = method !== \"GET\" && method !== \"HEAD\" && chunks.length > 0;\n const request = new Request(url, {\n method,\n headers,\n body: hasBody ? Buffer.concat(chunks) : undefined,\n });\n const response = await fetch(request);\n res.statusCode = response.status;\n response.headers.forEach((value, key) => res.setHeader(key, value));\n if (response.body) {\n for await (const chunk of response.body as unknown as AsyncIterable<Uint8Array>) {\n res.write(chunk);\n }\n }\n res.end();\n } catch (err) {\n res.statusCode = 500;\n res.end(`Internal error: ${err instanceof Error ? err.message : String(err)}`);\n }\n })();\n });\n await new Promise<void>((resolve) => server.listen(port, resolve));\n}\n\ntype Flags = Record<string, string | boolean>;\n\n/** Minimal flag/value argv parser: `--key value`, `--key=value` and `--flag`. */\nexport function parseArgs(argv: string[]): { _: string[]; flags: Flags } {\n const _: string[] = [];\n const flags: Flags = {};\n for (let i = 0; i < argv.length; i++) {\n const a = argv[i]!;\n if (a.startsWith(\"--\")) {\n const eq = a.indexOf(\"=\");\n if (eq > 0) {\n flags[a.slice(2, eq)] = a.slice(eq + 1);\n continue;\n }\n const key = a.slice(2);\n const next = argv[i + 1];\n if (next === undefined || next.startsWith(\"--\")) flags[key] = true;\n else {\n flags[key] = next;\n i++;\n }\n } else _.push(a);\n }\n return { _, flags };\n}\n\nconst str = (flags: Flags, key: string): string | undefined =>\n typeof flags[key] === \"string\" ? (flags[key] as string) : undefined;\n\n/** The query model from flags (same names as the HTTP query parameters). */\nexport function queryFromFlags(flags: Flags): AuditQuery {\n const q: AuditQuery = {};\n const list = (key: string) =>\n str(flags, key)\n ?.split(\",\")\n .map((s) => s.trim())\n .filter(Boolean);\n const actions = list(\"actions\");\n if (actions?.length) q.actions = actions;\n const exclude = list(\"excludeActions\");\n if (exclude?.length) q.excludeActions = exclude;\n for (const k of [\n \"tenant\",\n \"actorId\",\n \"actorType\",\n \"targetType\",\n \"targetId\",\n \"from\",\n \"to\",\n \"search\",\n \"cursor\",\n ] as const) {\n const v = str(flags, k);\n if (v) q[k] = v;\n }\n const outcome = str(flags, \"outcome\");\n if (outcome === \"success\" || outcome === \"failure\") q.outcome = outcome;\n else if (outcome) throw new Error(`Invalid --outcome \"${outcome}\" (success | failure)`);\n const order = str(flags, \"order\");\n if (order === \"asc\" || order === \"desc\") q.order = order;\n else if (order) throw new Error(`Invalid --order \"${order}\" (asc | desc)`);\n const limit = str(flags, \"limit\");\n if (limit) q.limit = Number(limit);\n return q;\n}\n\n/** A core over the env-configured storage (no runner, no timers). */\nasync function makeCore(): Promise<AuditCore<ActionMap>> {\n const [storage, signer] = await Promise.all([buildStorage(), signerFromEnv()]);\n const retention = retentionFromEnv();\n return createAuditCore({\n storage,\n ...(signer ? { signer } : {}),\n ...(retention ? { retention } : {}),\n });\n}\n\n/** Read this package's version from the nearest package.json (dist or src). */\nasync function pkgVersion(): Promise<string> {\n try {\n const { readFile } = await import(\"node:fs/promises\");\n const { fileURLToPath } = await import(\"node:url\");\n const pkg = JSON.parse(\n await readFile(fileURLToPath(new URL(\"../package.json\", import.meta.url)), \"utf8\"),\n ) as { version?: string };\n return pkg.version ?? \"unknown\";\n } catch {\n return \"unknown\";\n }\n}\n\n/**\n * The `verify` exit code: `0` valid and anchored (genesis or a verified\n * checkpoint) with every event covered by a verified checkpoint, `2` valid\n * but the tail (or the start) is not anchored by a signature, `1` invalid.\n */\nexport function verifyExitCode(report: VerifyReport): 0 | 1 | 2 {\n if (!report.ok) return 1;\n if (report.checked === 0) return 0;\n const anchored = report.anchor === \"genesis\" || report.anchor === \"checkpoint\";\n const signed = report.signedThrough !== null && report.signedThrough >= (report.toSeq ?? 0);\n return anchored && signed ? 0 : 2;\n}\n\nfunction describeReport(report: VerifyReport): string {\n const lines = [\n `${report.ok ? \"VALID\" : \"INVALID\"}: ${report.checked} event(s)` +\n (report.fromSeq !== null ? ` (seq ${report.fromSeq}..${report.toSeq})` : \"\") +\n (report.tenant ? ` of tenant \"${report.tenant}\"` : \"\"),\n `anchor: ${report.anchor}; checkpoints verified: ${report.checkpointsVerified}; signed through: ${report.signedThrough ?? \"—\"}`,\n ];\n if (report.erased.length)\n lines.push(`erased: ${report.erased.length} event(s) with erased sections`);\n for (const issue of report.issues) {\n lines.push(\n ` ✗ ${issue.kind}${issue.seq !== undefined ? ` @${issue.seq}` : \"\"}: ${issue.message}`,\n );\n }\n const code = verifyExitCode(report);\n if (code === 2) {\n lines.push(\n report.signedThrough === null\n ? \"warning: no verified checkpoint covers these events (unsigned)\"\n : `warning: events after seq ${report.signedThrough} are not covered by a verified checkpoint`,\n );\n }\n return lines.join(\"\\n\") + \"\\n\";\n}\n\n/** Keys from `--jwks <file|url>`. */\nasync function loadJwks(source: string): Promise<AuditVerificationKey[]> {\n let text: string;\n if (/^https?:\\/\\//.test(source)) {\n const res = await fetch(source);\n if (!res.ok) throw new Error(`GET ${source} → ${res.status}`);\n text = await res.text();\n } else {\n const { readFile } = await import(\"node:fs/promises\");\n text = await readFile(source, \"utf8\");\n }\n return keysFromJwks(JSON.parse(text) as { keys: JsonWebKey[] });\n}\n\nfunction helpText(version: string): string {\n return `xtandard-audit v${version} — self-hosted, tamper-evident audit-log control plane\n\nUsage:\n xtandard-audit <command> [options] # the binary, after: npm i -g @xtandard/audit\n npx @xtandard/audit <command> # without installing (or: bunx @xtandard/audit …)\n\nCommands:\n serve [--port <n>] Run the panel + API + streams + retention (no Docker).\n record --tenant <t> --action <a> --actor <id> [--actor-type <type>]\n [--targets type:id,…] [--metadata '<json>'] [--outcome success|failure]\n [--description <text>]\n record --event '<json>' Record one event (ingest from shell/CI). Prints it.\n query [--tenant <t>] [--actions a,b] [--excludeActions …] [--actorId …] [--actorType …]\n [--targetType …] [--targetId …] [--outcome …] [--from …] [--to …] [--search …]\n [--order asc|desc] [--limit n] [--cursor c] [--json]\n Search events (flags = the HTTP query parameters).\n export --tenant <t> [--format csv|json|jsonl|bundle] [--out <file>] [query flags]\n Stream an export to stdout (or --out).\n verify --bundle <file.jsonl> [--jwks <file|url>] [--hmac-secret <s>]\n verify --tenant <t> [--fromSeq n] [--toSeq n]\n Verify an export bundle offline (or a tenant's chain in\n storage). Exit 0 = valid and anchored by genesis or a\n verified checkpoint; 2 = valid but the tail is not covered\n by a verified checkpoint (unsigned); 1 = invalid.\n prune [--tenant <t>] Apply the retention policy (RETENTION_*).\n checkpoint --tenant <t> Sign a tenant's chain head (needs AUDIT_SIGNING_KEY or\n AUDIT_HMAC_SECRET).\n keygen Print a new Ed25519 private JWK (→ AUDIT_SIGNING_KEY) and\n its public JWKS.\n tenants List tenants with their head seq and retained count.\n actions List the action catalog.\n\nGlobal options:\n -h, --help Show this help.\n -v, --version Print the version.\n\nEnvironment variables\n Storage:\n STORAGE_DRIVER memory | file | redis | postgres | mongodb | sqlite | libsql\n (CLI default: file · Docker default: memory)\n STORAGE_FILE_DIR ./.audit (driver: file)\n REDIS_URL, STORAGE_PREFIX redis://localhost:6379, xtandard:audit (driver: redis)\n DATABASE_URL | POSTGRES_URL, STORAGE_PG_TABLE (driver: postgres)\n MONGO_URL, MONGO_DB, STORAGE_MONGO_COLLECTION (driver: mongodb)\n STORAGE_SQLITE_PATH ./.audit/audit.sqlite (driver: sqlite, Bun only)\n LIBSQL_URL, LIBSQL_AUTH_TOKEN (driver: libsql)\n\n Integrity:\n AUDIT_SIGNING_KEY Ed25519 private JWK (JSON) — signs checkpoints; the public\n key is served at {BASE_PATH}/api/integrity/keys.\n AUDIT_HMAC_SECRET HMAC checkpoint secret (when no AUDIT_SIGNING_KEY).\n\n Retention (kept if EITHER rule keeps it; never past an undelivered stream cursor):\n RETENTION_MAX_AGE e.g. 365d (ms|s|m|h|d)\n RETENTION_KEEP_LAST Keep at most the N most recent events per tenant.\n MAINTENANCE_INTERVAL 1h How often \\`serve\\` prunes; 0|false disables.\n\n Server (\\`serve\\` / standalone):\n PORT 3000 Port to listen on (or --port).\n BASE_PATH \"\" URL prefix, e.g. \"/audit\".\n TITLE Navbar wordmark.\n LOGO_URL Logo image URL.\n READONLY 1|true Block all mutating operations.\n AUTH_MODE none|basic Authentication mode (default none).\n AUTH_USERNAME admin Username for basic auth.\n AUTH_PASSWORD_HASH scrypt hash (preferred; see docs/AUTH.md).\n AUTH_PASSWORD Plaintext password (dev only).\n AUTH_ROLE admin Role of the basic-auth user (admin | auditor | viewer).\n PORTAL_SECRET Enables portal-token access (audpt_… bearer tokens).\n\n Streams (\\`serve\\` / standalone):\n AUDIT_STREAMS JSON array: [{ \"name\": \"siem\", \"sink\": \"http\",\n \"options\": { \"url\": \"https://…\" }, \"startFrom\": \"now\" }]\n STREAM_RUNNER 1 0|false: show stream status but do not run them here.\n\nExamples:\n # Quick local panel (file storage, no auth):\n npx @xtandard/audit serve --port 3004\n\n # Signed checkpoints:\n export AUDIT_SIGNING_KEY=\"$(xtandard-audit keygen | head -1)\"\n\n # Record from CI:\n xtandard-audit record --tenant acme --action deploy.finished --actor ci \\\\\n --metadata '{\"sha\":\"abc123\"}'\n\n # Export a verifiable bundle and verify it against the published keys:\n xtandard-audit export --tenant acme --format bundle --out acme.jsonl\n xtandard-audit verify --bundle acme.jsonl --jwks https://app.example.com/audit/api/integrity/keys\n\nDocs: https://github.com/xantiagoma/xtandard-audit\n`;\n}\n\n/** Entry point. Returns the process exit code. */\nexport async function run(argv: string[]): Promise<number> {\n const { _, flags } = parseArgs(argv);\n const command = _[0];\n\n // `--version` (bare) / `-v` / `version` → print version.\n if (flags.version === true || argv.includes(\"-v\") || command === \"version\") {\n process.stdout.write(`${await pkgVersion()}\\n`);\n return 0;\n }\n\n const wantsHelp = Boolean(flags.help) || argv.includes(\"-h\") || command === \"help\";\n if (!command || wantsHelp) {\n process.stdout.write(helpText(await pkgVersion()));\n // Explicit help request → success; bare invocation with no command → usage error.\n return wantsHelp ? 0 : 1;\n }\n\n try {\n switch (command) {\n case \"keygen\": {\n const { privateJwk, publicJwk } = await generateSigningKeyPair();\n process.stdout.write(\n `${JSON.stringify(privateJwk)}\\n${JSON.stringify({ keys: [{ ...publicJwk, alg: \"Ed25519\", use: \"sig\" }] })}\\n`,\n );\n process.stderr.write(\n \"Line 1: private JWK — set it as AUDIT_SIGNING_KEY (keep it secret).\\n\" +\n \"Line 2: public JWKS — publish it so auditors can verify checkpoints.\\n\",\n );\n return 0;\n }\n case \"tenants\": {\n const core = await makeCore();\n const tenants = await core.listTenants();\n if (tenants.length === 0) process.stdout.write(\"No tenants.\\n\");\n for (const t of tenants) {\n process.stdout.write(\n `${t.key} seq ${t.head.seq} ${t.count ?? 0} event(s)` +\n (t.head.baseSeq && t.head.baseSeq > 1 ? ` (pruned before ${t.head.baseSeq})` : \"\") +\n \"\\n\",\n );\n }\n return 0;\n }\n case \"actions\": {\n const core = await makeCore();\n const actions = await core.listActions();\n if (actions.length === 0) process.stdout.write(\"No actions in the catalog.\\n\");\n for (const a of actions) {\n process.stdout.write(\n `${a.name}${a.group ? ` [${a.group}]` : \"\"}${a.deprecated ? \" (deprecated)\" : \"\"}` +\n `${a.description ? ` ${a.description}` : \"\"}\\n`,\n );\n }\n return 0;\n }\n case \"record\": {\n let input: Partial<AuditEventInput>;\n const eventJson = str(flags, \"event\");\n if (eventJson) {\n try {\n input = JSON.parse(eventJson) as Partial<AuditEventInput>;\n } catch {\n process.stderr.write(\"Invalid --event JSON.\\n\");\n return 1;\n }\n } else {\n const tenant = str(flags, \"tenant\");\n const action = str(flags, \"action\");\n const actorId = str(flags, \"actor\");\n if (!tenant || !action || !actorId) {\n process.stderr.write(\n \"Usage: xtandard-audit record --tenant <t> --action <a> --actor <id> [--metadata '<json>'] [--targets type:id,…]\\n\" +\n \" or: xtandard-audit record --event '<json>'\\n\",\n );\n return 1;\n }\n let metadata: JsonObject | undefined;\n const raw = str(flags, \"metadata\");\n if (raw) {\n try {\n metadata = JSON.parse(raw) as JsonObject;\n } catch {\n process.stderr.write(\"Invalid --metadata JSON.\\n\");\n return 1;\n }\n }\n const targets = str(flags, \"targets\")\n ?.split(\",\")\n .filter(Boolean)\n .map((t) => {\n const i = t.indexOf(\":\");\n return i > 0 ? { type: t.slice(0, i), id: t.slice(i + 1) } : { type: t, id: t };\n });\n const actorType = str(flags, \"actor-type\");\n const outcome = str(flags, \"outcome\");\n const description = str(flags, \"description\");\n input = {\n tenant,\n action,\n actor: { id: actorId, ...(actorType ? { type: actorType } : {}) },\n ...(targets?.length ? { targets } : {}),\n ...(metadata ? { metadata } : {}),\n ...(outcome ? { outcome: outcome as AuditEventInput[\"outcome\"] } : {}),\n ...(description ? { description } : {}),\n };\n }\n const core = await makeCore();\n const event = await core.record(input as AuditEventInput);\n process.stdout.write(`${JSON.stringify(event, null, 2)}\\n`);\n return 0;\n }\n case \"query\": {\n const core = await makeCore();\n const page = await core.query(queryFromFlags(flags));\n if (flags.json) {\n process.stdout.write(`${JSON.stringify(page, null, 2)}\\n`);\n return 0;\n }\n if (page.items.length === 0) process.stdout.write(\"No events.\\n\");\n for (const e of page.items) {\n process.stdout.write(\n `${e.occurredAt} ${e.tenant}#${e.seq} ${e.action} by ${e.actor.id}` +\n (e.targets.length\n ? ` → ${e.targets.map((t) => `${t.type}:${t.id}`).join(\",\")}`\n : \"\") +\n (e.outcome === \"failure\" ? \" (failure)\" : \"\") +\n \"\\n\",\n );\n }\n if (page.pageInfo.hasNextPage) {\n process.stdout.write(`… more: --cursor ${page.pageInfo.endCursor}\\n`);\n }\n return 0;\n }\n case \"export\": {\n const tenant = str(flags, \"tenant\");\n const format = (str(flags, \"format\") ?? \"jsonl\") as ExportFormat;\n if (!tenant) {\n process.stderr.write(\n \"Usage: xtandard-audit export --tenant <t> [--format csv|json|jsonl|bundle] [--out <file>]\\n\",\n );\n return 1;\n }\n if (!(format in EXPORT_CONTENT_TYPES)) {\n process.stderr.write(`Invalid --format \"${format}\" (csv | json | jsonl | bundle).\\n`);\n return 1;\n }\n const core = await makeCore();\n const query = { ...queryFromFlags(flags), tenant };\n delete query.limit;\n delete query.cursor;\n const stream = await exportEvents(core, query, {\n format,\n actor: { id: \"cli\", name: \"xtandard-audit CLI\" },\n });\n const out = str(flags, \"out\");\n if (out) {\n const { createWriteStream } = await import(\"node:fs\");\n const file = createWriteStream(out);\n for await (const chunk of stream as unknown as AsyncIterable<Uint8Array>)\n file.write(chunk);\n await new Promise<void>((resolve, reject) => {\n file.end((err?: Error | null) => (err ? reject(err) : resolve()));\n });\n process.stderr.write(`Exported ${format} → ${out}\\n`);\n } else {\n for await (const chunk of stream as unknown as AsyncIterable<Uint8Array>) {\n process.stdout.write(chunk);\n }\n }\n return 0;\n }\n case \"verify\": {\n const bundlePath = str(flags, \"bundle\");\n const tenant = str(flags, \"tenant\");\n if (!bundlePath && !tenant) {\n process.stderr.write(\n \"Usage: xtandard-audit verify --bundle <file.jsonl> [--jwks <file|url>] [--hmac-secret <s>]\\n\" +\n \" or: xtandard-audit verify --tenant <t> [--fromSeq n] [--toSeq n]\\n\",\n );\n return 1;\n }\n let report: VerifyReport;\n if (bundlePath) {\n const { readFile } = await import(\"node:fs/promises\");\n const text = await readFile(bundlePath, \"utf8\");\n const keys: AuditVerificationKey[] = [];\n const jwks = str(flags, \"jwks\");\n if (jwks) {\n keys.push(...(await loadJwks(jwks)));\n } else {\n // Without --jwks, trust the bundle's own JWKS (and say so).\n const embedded = parseBundle(text).jwks;\n if (embedded?.keys.length) {\n keys.push(...(await keysFromJwks(embedded as { keys: JsonWebKey[] })));\n process.stderr.write(\n \"note: checkpoint signatures verified with the keys embedded in the bundle — pass --jwks <operator's published keys> to not trust the file for them.\\n\",\n );\n }\n }\n const hmac = str(flags, \"hmac-secret\") ?? env(\"AUDIT_HMAC_SECRET\");\n if (hmac) keys.push(hmacVerificationKey(hmac));\n report = await verifyBundle(text, keys.length ? { keys } : {});\n } else {\n const core = await makeCore();\n const fromSeq = str(flags, \"fromSeq\");\n const toSeq = str(flags, \"toSeq\");\n report = await core.verify(tenant!, {\n ...(fromSeq ? { fromSeq: Number(fromSeq) } : {}),\n ...(toSeq ? { toSeq: Number(toSeq) } : {}),\n });\n }\n if (flags.json) process.stdout.write(`${JSON.stringify(report, null, 2)}\\n`);\n else process.stdout.write(describeReport(report));\n return verifyExitCode(report);\n }\n case \"prune\": {\n const core = await makeCore();\n if (!core.options.retention) {\n process.stderr.write(\n \"No retention policy: set RETENTION_MAX_AGE and/or RETENTION_KEEP_LAST.\\n\",\n );\n return 1;\n }\n const tenant = str(flags, \"tenant\");\n const actor = { actor: { id: \"cli\", name: \"xtandard-audit CLI\" } };\n const results = tenant ? [await core.pruneTenant(tenant, actor)] : await core.prune(actor);\n for (const r of results) {\n process.stdout.write(\n `${r.tenant}: pruned ${r.pruned}, first retained seq ${r.baseSeq}\\n`,\n );\n }\n return 0;\n }\n case \"checkpoint\": {\n const tenant = str(flags, \"tenant\");\n if (!tenant) {\n process.stderr.write(\"Usage: xtandard-audit checkpoint --tenant <t>\\n\");\n return 1;\n }\n const core = await makeCore();\n const cp = await core.checkpoint(tenant, {\n actor: { id: \"cli\", name: \"xtandard-audit CLI\" },\n });\n process.stdout.write(`${JSON.stringify(cp, null, 2)}\\n`);\n return 0;\n }\n case \"serve\": {\n const port = Number(str(flags, \"port\") || env(\"PORT\", \"3000\"));\n const basePath = env(\"BASE_PATH\", \"\");\n const title = env(\"TITLE\", \"@xtandard/audit\");\n const logoUrl = env(\"LOGO_URL\");\n const readonly = isTruthy(env(\"READONLY\"));\n const authMode = env(\"AUTH_MODE\", \"none\");\n const portalSecret = env(\"PORTAL_SECRET\");\n const maintenanceRaw = env(\"MAINTENANCE_INTERVAL\");\n\n const { createFetchHandler } = await import(\"./server/create-fetch-handler.ts\");\n const [storage, signer, streams, { auth, authorization }] = await Promise.all([\n buildStorage(),\n signerFromEnv(),\n streamsFromEnv(),\n buildAuth(),\n ]);\n\n if (authMode === \"none\") {\n warn(\"AUTH_MODE=none — do NOT expose this publicly without authentication.\");\n }\n\n const retention = retentionFromEnv();\n const panel = createFetchHandler({\n storage,\n basePath,\n title,\n ...(logoUrl ? { logoUrl } : {}),\n readonly,\n auth,\n authorization,\n ...(signer ? { signer } : {}),\n ...(portalSecret ? { portal: { secret: portalSecret } } : {}),\n ...(retention ? { retention } : {}),\n ...(streams.length ? { streams } : {}),\n ...(isFalsy(env(\"STREAM_RUNNER\", \"1\")) ? { streamRunner: false as const } : {}),\n maintenance:\n maintenanceRaw && isFalsy(maintenanceRaw)\n ? false\n : { interval: (parseDurationEnv(\"MAINTENANCE_INTERVAL\") ?? \"1h\") as AuditDuration },\n });\n\n const normalizedBase =\n basePath && basePath !== \"/\"\n ? basePath.startsWith(\"/\")\n ? basePath\n : `/${basePath}`\n : \"\";\n\n const handler: FetchHandler = (request) => {\n const url = new URL(request.url);\n if (url.pathname === \"/healthcheck\" || url.pathname === `${normalizedBase}/healthcheck`) {\n return new Response(JSON.stringify({ status: \"ok\", title }), {\n headers: { \"content-type\": \"application/json\" },\n });\n }\n return panel.fetch(request);\n };\n\n process.stdout.write(`[xtandard/audit] storage: ${await describeStorage()}\\n`);\n process.stdout.write(\n `[xtandard/audit] signer: ${signer ? `${signer.alg} (${signer.keyId})` : \"none (no checkpoints)\"}\\n`,\n );\n process.stdout.write(\n `[xtandard/audit] streams: ${\n streams.length\n ? `${streams.map((s) => s.name).join(\", \")}${isFalsy(env(\"STREAM_RUNNER\", \"1\")) ? \" (not running here)\" : \"\"}`\n : \"none\"\n }\\n`,\n );\n\n await startServer(port, handler);\n process.stdout.write(\n `[xtandard/audit] listening on http://localhost:${port}${normalizedBase || \"/\"}\\n`,\n );\n // The server owns the process now; never resolve so the bin doesn't exit.\n return await new Promise<number>(() => {});\n }\n default:\n process.stderr.write(`Unknown command: ${command}\\n\\n${helpText(await pkgVersion())}`);\n return 1;\n }\n } catch (err) {\n process.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}\\n`);\n return 1;\n }\n}\n\n// `bun src/cli.ts <command>` (contributors); the published bin calls `run` itself.\nif ((import.meta as ImportMeta & { main?: boolean }).main) {\n void run(process.argv.slice(2)).then((code) => process.exit(code));\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"cli.cjs","names":["ed25519Signer","hmacSigner","createAuditCore","keysFromJwks","generateSigningKeyPair","EXPORT_CONTENT_TYPES","exportEvents","parseBundle","hmacVerificationKey","verifyBundle"],"sources":["../src/cli.ts"],"sourcesContent":["/**\n * `xtandard-audit` CLI. Operates on the same storage your app/panel uses\n * (configured via `STORAGE_DRIVER` and friends, mirroring the standalone app),\n * so it slots into shell, CI, cron and auditor workflows.\n *\n * Commands: `serve` (panel + streams + retention, no Docker), `record`,\n * `query`, `export`, `verify` (a bundle offline, or a tenant in storage),\n * `prune`, `checkpoint`, `keygen`, `tenants`, `actions`.\n *\n * Storage drivers and sinks are loaded lazily by **dynamic import of their\n * subpath entries** (`entry-storage-<driver>`, `entry-sinks-<kind>`) next to\n * this module, so the CLI only pulls the peer dependency of the driver you\n * pick — and a driver that is not part of a build is a clear runtime error,\n * not a bundling failure.\n *\n * @module\n */\n\nimport type { AuthProvider } from \"./auth/contract.ts\";\nimport type { AuthorizationProvider } from \"./authorization/contract.ts\";\nimport { createAuditCore, type AuditCore, type RetentionOptions } from \"./core.ts\";\nimport { durationToMs } from \"./duration.ts\";\nimport {\n EXPORT_CONTENT_TYPES,\n exportEvents,\n parseBundle,\n verifyBundle,\n type ExportFormat,\n} from \"./export.ts\";\nimport {\n ed25519Signer,\n generateSigningKeyPair,\n hmacSigner,\n hmacVerificationKey,\n keysFromJwks,\n type AuditSigner,\n type AuditVerificationKey,\n type VerifyReport,\n} from \"./integrity.ts\";\nimport type { AuditDuration, AuditEventInput, AuditQuery, JsonObject } from \"./schema.ts\";\nimport type { ActionMap } from \"./standard-schema.ts\";\nimport type { AuditStorage } from \"./storage/contract.ts\";\nimport type { AuditSink, StreamDefinition } from \"./streams.ts\";\n\n/** The storage drivers the CLI knows how to configure from env. */\nexport const CLI_DRIVERS = [\n \"memory\",\n \"file\",\n \"redis\",\n \"postgres\",\n \"mongodb\",\n \"sqlite\",\n \"libsql\",\n] as const;\ntype Driver = (typeof CLI_DRIVERS)[number];\n\nconst env = (key: string, fallback = \"\"): string => process.env[key] ?? fallback;\n\nconst isTruthy = (value: string): boolean => value === \"1\" || value.toLowerCase() === \"true\";\nconst isFalsy = (value: string): boolean => value === \"0\" || value.toLowerCase() === \"false\";\n\nconst warn = (message: string): void => {\n process.stderr.write(`[xtandard/audit] ${message}\\n`);\n};\n\n/** Raised when a lazily-imported subpath entry is not part of this build. */\nexport class MissingModuleError extends Error {\n constructor(message: string) {\n super(message);\n this.name = \"MissingModuleError\";\n }\n}\n\n/**\n * Import a sibling entry module by name: `./<entry>.mjs` in the built package\n * (`dist/`), `./<entry>.ts` when running from source. The specifier is computed\n * so bundlers leave it alone. Errors raised *inside* a found module (e.g. a\n * missing peer dependency) propagate unchanged.\n */\nexport async function importEntry(entry: string): Promise<Record<string, unknown>> {\n for (const ext of [\".mjs\", \".ts\"]) {\n const specifier = `./${entry}${ext}`;\n try {\n return (await import(/* @vite-ignore */ specifier)) as Record<string, unknown>;\n } catch (err) {\n const message = err instanceof Error ? err.message : String(err);\n const code = (err as { code?: string }).code;\n const notFound =\n code === \"ERR_MODULE_NOT_FOUND\" ||\n /Cannot find (module|package)|Failed to load url|failed to resolve|does not exist/i.test(\n message,\n );\n if (notFound && message.includes(entry)) continue;\n throw err;\n }\n }\n throw new MissingModuleError(`Module \"${entry}\" is not available in this build`);\n}\n\n/** Find a factory export by name, else the single export matching `pattern`. */\nfunction pickFactory<T>(\n mod: Record<string, unknown>,\n name: string,\n pattern: RegExp,\n): ((...args: unknown[]) => T) | null {\n if (typeof mod[name] === \"function\") return mod[name] as (...args: unknown[]) => T;\n const candidates = Object.entries(mod).filter(\n ([k, v]) => typeof v === \"function\" && pattern.test(k),\n );\n return candidates.length === 1 ? (candidates[0]![1] as (...args: unknown[]) => T) : null;\n}\n\n/** The storage driver named by `STORAGE_DRIVER` (CLI default: `file`). */\nfunction driverFromEnv(): Driver {\n const raw = env(\"STORAGE_DRIVER\", \"file\") || \"file\";\n if (!(CLI_DRIVERS as readonly string[]).includes(raw)) {\n throw new Error(`Unknown STORAGE_DRIVER \"${raw}\" (expected ${CLI_DRIVERS.join(\" | \")})`);\n }\n return raw as Driver;\n}\n\n/** Driver → [entry module, factory export, options from env]. */\nfunction driverSpec(driver: Driver): [string, string, Record<string, unknown>] {\n switch (driver) {\n case \"memory\":\n return [\"entry-storage-memory\", \"createMemoryStorage\", {}];\n case \"redis\":\n return [\n \"entry-storage-redis\",\n \"createRedisStorage\",\n {\n url: env(\"REDIS_URL\", \"redis://localhost:6379\"),\n prefix: env(\"STORAGE_PREFIX\", \"xtandard:audit\"),\n },\n ];\n case \"postgres\":\n return [\n \"entry-storage-postgres\",\n \"createPostgresStorage\",\n {\n connectionString:\n env(\"DATABASE_URL\") || env(\"POSTGRES_URL\", \"postgres://localhost:5432/postgres\"),\n table: env(\"STORAGE_PG_TABLE\", \"xtandard_audit\"),\n },\n ];\n case \"mongodb\":\n return [\n \"entry-storage-mongodb\",\n \"createMongoStorage\",\n {\n url: env(\"MONGO_URL\", \"mongodb://localhost:27017\"),\n dbName: env(\"MONGO_DB\", \"xtandard_audit\"),\n collectionName: env(\"STORAGE_MONGO_COLLECTION\", \"audit\"),\n },\n ];\n case \"sqlite\":\n // Requires running the CLI under Bun (`bunx xtandard-audit …`).\n return [\n \"entry-storage-sqlite\",\n \"createSqliteStorage\",\n { path: env(\"STORAGE_SQLITE_PATH\", \"./.audit/audit.sqlite\") },\n ];\n case \"libsql\": {\n const authToken = env(\"LIBSQL_AUTH_TOKEN\");\n return [\n \"entry-storage-libsql\",\n \"createLibsqlStorage\",\n {\n url: env(\"LIBSQL_URL\", \"file:./.audit/audit.db\"),\n ...(authToken ? { authToken } : {}),\n },\n ];\n }\n case \"file\":\n return [\n \"entry-storage-file\",\n \"createFileStorage\",\n { dir: env(\"STORAGE_FILE_DIR\", \"./.audit\") },\n ];\n }\n}\n\n/** Build the storage from env, importing the driver's subpath lazily. */\nexport async function buildStorage(): Promise<AuditStorage> {\n const driver = driverFromEnv();\n const [entry, factoryName, options] = driverSpec(driver);\n let mod: Record<string, unknown>;\n try {\n mod = await importEntry(entry);\n } catch (err) {\n if (err instanceof MissingModuleError) {\n throw new Error(\n `Storage driver \"${driver}\" is not available (missing @xtandard/audit/storage/${driver})`,\n );\n }\n throw err;\n }\n const factory = pickFactory<AuditStorage>(mod, factoryName, /^create\\w*Storage$/);\n if (!factory) throw new Error(`@xtandard/audit/storage/${driver} exports no ${factoryName}`);\n return factory(options);\n}\n\n/**\n * A human-readable, log-safe description of where storage persists data — for\n * the `serve` startup banner. Connection-string drivers print only the driver\n * name (never the URL, which may carry credentials).\n */\nasync function describeStorage(): Promise<string> {\n const { resolve } = await import(\"node:path\");\n const driver = driverFromEnv();\n switch (driver) {\n case \"file\":\n return `file → ${resolve(env(\"STORAGE_FILE_DIR\", \"./.audit\"))}`;\n case \"sqlite\":\n return `sqlite → ${resolve(env(\"STORAGE_SQLITE_PATH\", \"./.audit/audit.sqlite\"))}`;\n case \"memory\":\n return \"memory (ephemeral — not persisted)\";\n default:\n return driver;\n }\n}\n\n/** Parse a duration env like `\"365d\"`, warning and ignoring malformed values. */\nfunction parseDurationEnv(name: string): AuditDuration | undefined {\n const raw = env(name);\n if (!raw) return undefined;\n try {\n durationToMs(raw as AuditDuration); // validate eagerly\n return raw as AuditDuration;\n } catch {\n warn(`Ignoring ${name}=\"${raw}\" — expected <number><unit> with unit ms|s|m|h|d (e.g. 365d).`);\n return undefined;\n }\n}\n\n/** Retention from env: `RETENTION_MAX_AGE` / `RETENTION_KEEP_LAST`. */\nexport function retentionFromEnv(): RetentionOptions | undefined {\n const keepRaw = env(\"RETENTION_KEEP_LAST\");\n const keepLast = keepRaw && /^\\d+$/.test(keepRaw) ? Number(keepRaw) : undefined;\n if (keepRaw && keepLast === undefined) {\n warn(`Ignoring RETENTION_KEEP_LAST=\"${keepRaw}\" — expected a number.`);\n }\n const maxAge = parseDurationEnv(\"RETENTION_MAX_AGE\");\n if (keepLast === undefined && !maxAge) return undefined;\n return {\n ...(keepLast !== undefined ? { keepLast } : {}),\n ...(maxAge !== undefined ? { maxAge } : {}),\n };\n}\n\n/** Checkpoint signer from env: `AUDIT_SIGNING_KEY` (Ed25519 private JWK JSON) or `AUDIT_HMAC_SECRET`. */\nexport async function signerFromEnv(): Promise<AuditSigner | undefined> {\n const jwk = env(\"AUDIT_SIGNING_KEY\");\n if (jwk) {\n let parsed: JsonWebKey;\n try {\n parsed = JSON.parse(jwk) as JsonWebKey;\n } catch {\n throw new Error(\n \"AUDIT_SIGNING_KEY must be a private JWK as JSON (see `xtandard-audit keygen`)\",\n );\n }\n return ed25519Signer(parsed);\n }\n const secret = env(\"AUDIT_HMAC_SECRET\");\n return secret ? hmacSigner(secret) : undefined;\n}\n\n/** A stream declared in `AUDIT_STREAMS` (JSON array). */\ninterface StreamEnv {\n name: string;\n /** Sink kind: loads `@xtandard/audit/sinks/<sink>` and calls its `<kind>Sink(options)` factory. */\n sink: string;\n options?: Record<string, unknown>;\n tenants?: string[];\n filter?: StreamDefinition[\"filter\"];\n batchSize?: number;\n startFrom?: \"beginning\" | \"now\";\n checkpoints?: boolean;\n}\n\nconst camel = (kind: string) => kind.replace(/-([a-z])/g, (_, c: string) => c.toUpperCase());\n\n/** Streams from `AUDIT_STREAMS` (JSON array of {@link StreamEnv}). */\nexport async function streamsFromEnv(): Promise<StreamDefinition[]> {\n const raw = env(\"AUDIT_STREAMS\");\n if (!raw) return [];\n let specs: StreamEnv[];\n try {\n specs = JSON.parse(raw) as StreamEnv[];\n if (!Array.isArray(specs)) throw new Error(\"not an array\");\n } catch {\n throw new Error('AUDIT_STREAMS must be a JSON array of { \"name\", \"sink\", \"options\"? , … }');\n }\n const out: StreamDefinition[] = [];\n for (const spec of specs) {\n let mod: Record<string, unknown>;\n try {\n mod = await importEntry(`entry-sinks-${spec.sink}`);\n } catch (err) {\n if (err instanceof MissingModuleError) {\n throw new Error(\n `Sink \"${spec.sink}\" (stream \"${spec.name}\") is not available (missing @xtandard/audit/sinks/${spec.sink})`,\n );\n }\n throw err;\n }\n const factory = pickFactory<AuditSink>(mod, `${camel(spec.sink)}Sink`, /Sink$/);\n if (!factory) throw new Error(`@xtandard/audit/sinks/${spec.sink} exports no sink factory`);\n out.push({\n name: spec.name,\n sink: await factory(spec.options ?? {}),\n ...(spec.tenants ? { tenants: spec.tenants } : {}),\n ...(spec.filter ? { filter: spec.filter } : {}),\n ...(spec.batchSize ? { batchSize: spec.batchSize } : {}),\n ...(spec.startFrom ? { startFrom: spec.startFrom } : {}),\n ...(spec.checkpoints !== undefined ? { checkpoints: spec.checkpoints } : {}),\n });\n }\n return out;\n}\n\n/** `AUTH_MODE`, with an empty value meaning the default `none`. */\nconst authModeFromEnv = (): string => process.env.AUTH_MODE || \"none\";\n\n/** Build the auth + authorization providers from env (mirrors the standalone app). */\nasync function buildAuth(): Promise<{ auth: AuthProvider; authorization: AuthorizationProvider }> {\n const mode = authModeFromEnv();\n if (mode === \"basic\") {\n const [{ basicAuth }, { rolesAuthorization }] = await Promise.all([\n import(\"./auth/basic.ts\"),\n import(\"./authorization/roles.ts\"),\n ]);\n const passwordHash = env(\"AUTH_PASSWORD_HASH\");\n const password = env(\"AUTH_PASSWORD\");\n if (!passwordHash && !password) {\n warn(\"AUTH_MODE=basic but neither AUTH_PASSWORD_HASH nor AUTH_PASSWORD is set.\");\n }\n return {\n auth: basicAuth({\n users: [\n {\n username: env(\"AUTH_USERNAME\", \"admin\"),\n ...(passwordHash ? { passwordHash } : {}),\n ...(password ? { password } : {}),\n roles: [env(\"AUTH_ROLE\", \"admin\")],\n },\n ],\n }),\n authorization: rolesAuthorization({}),\n };\n }\n if (mode !== \"none\") throw new Error(`Unknown AUTH_MODE \"${mode}\" (expected none or basic)`);\n const [{ noAuth }, { noAuthorization }] = await Promise.all([\n import(\"./auth/none.ts\"),\n import(\"./authorization/none.ts\"),\n ]);\n return { auth: noAuth(), authorization: noAuthorization() };\n}\n\ntype FetchHandler = (request: Request) => Response | Promise<Response>;\n\n/**\n * Serve a web-standard fetch handler under whatever runtime the CLI runs on:\n * `Bun.serve` under `bunx`, a `node:http` bridge under `npx`/Node (streaming\n * response bodies, so exports are never buffered). Resolves once listening.\n */\nasync function startServer(port: number, fetch: FetchHandler): Promise<void> {\n const bun = (globalThis as { Bun?: { serve: (options: unknown) => unknown } }).Bun;\n if (bun) {\n bun.serve({ port, fetch });\n return;\n }\n const { createServer } = await import(\"node:http\");\n const server = createServer((req, res) => {\n void (async () => {\n try {\n const chunks: Buffer[] = [];\n for await (const c of req) chunks.push(c as Buffer);\n const method = req.method ?? \"GET\";\n const headers = new Headers();\n for (const [k, v] of Object.entries(req.headers)) {\n if (v === undefined) continue;\n headers.set(k, Array.isArray(v) ? v.join(\", \") : v);\n }\n const host = req.headers.host ?? `localhost:${port}`;\n const url = `http://${host}${req.url ?? \"/\"}`;\n const hasBody = method !== \"GET\" && method !== \"HEAD\" && chunks.length > 0;\n const request = new Request(url, {\n method,\n headers,\n body: hasBody ? Buffer.concat(chunks) : undefined,\n });\n const response = await fetch(request);\n res.statusCode = response.status;\n response.headers.forEach((value, key) => res.setHeader(key, value));\n if (response.body) {\n for await (const chunk of response.body as unknown as AsyncIterable<Uint8Array>) {\n res.write(chunk);\n }\n }\n res.end();\n } catch (err) {\n res.statusCode = 500;\n res.end(`Internal error: ${err instanceof Error ? err.message : String(err)}`);\n }\n })();\n });\n await new Promise<void>((resolve) => server.listen(port, resolve));\n}\n\ntype Flags = Record<string, string | boolean>;\n\n/** Minimal flag/value argv parser: `--key value`, `--key=value` and `--flag`. */\nexport function parseArgs(argv: string[]): { _: string[]; flags: Flags } {\n const _: string[] = [];\n const flags: Flags = {};\n for (let i = 0; i < argv.length; i++) {\n const a = argv[i]!;\n if (a.startsWith(\"--\")) {\n const eq = a.indexOf(\"=\");\n if (eq > 0) {\n flags[a.slice(2, eq)] = a.slice(eq + 1);\n continue;\n }\n const key = a.slice(2);\n const next = argv[i + 1];\n if (next === undefined || next.startsWith(\"--\")) flags[key] = true;\n else {\n flags[key] = next;\n i++;\n }\n } else _.push(a);\n }\n return { _, flags };\n}\n\nconst str = (flags: Flags, key: string): string | undefined =>\n typeof flags[key] === \"string\" ? (flags[key] as string) : undefined;\n\n/** The query model from flags (same names as the HTTP query parameters). */\nexport function queryFromFlags(flags: Flags): AuditQuery {\n const q: AuditQuery = {};\n const list = (key: string) =>\n str(flags, key)\n ?.split(\",\")\n .map((s) => s.trim())\n .filter(Boolean);\n const actions = list(\"actions\");\n if (actions?.length) q.actions = actions;\n const exclude = list(\"excludeActions\");\n if (exclude?.length) q.excludeActions = exclude;\n for (const k of [\n \"tenant\",\n \"actorId\",\n \"actorType\",\n \"targetType\",\n \"targetId\",\n \"from\",\n \"to\",\n \"search\",\n \"cursor\",\n ] as const) {\n const v = str(flags, k);\n if (v) q[k] = v;\n }\n const outcome = str(flags, \"outcome\");\n if (outcome === \"success\" || outcome === \"failure\") q.outcome = outcome;\n else if (outcome) throw new Error(`Invalid --outcome \"${outcome}\" (success | failure)`);\n const order = str(flags, \"order\");\n if (order === \"asc\" || order === \"desc\") q.order = order;\n else if (order) throw new Error(`Invalid --order \"${order}\" (asc | desc)`);\n const limit = str(flags, \"limit\");\n if (limit) q.limit = Number(limit);\n return q;\n}\n\n/** A core over the env-configured storage (no runner, no timers). */\nasync function makeCore(): Promise<AuditCore<ActionMap>> {\n const [storage, signer] = await Promise.all([buildStorage(), signerFromEnv()]);\n const retention = retentionFromEnv();\n return createAuditCore({\n storage,\n ...(signer ? { signer } : {}),\n ...(retention ? { retention } : {}),\n });\n}\n\n/** Read this package's version from the nearest package.json (dist or src). */\nasync function pkgVersion(): Promise<string> {\n try {\n const { readFile } = await import(\"node:fs/promises\");\n const { fileURLToPath } = await import(\"node:url\");\n const pkg = JSON.parse(\n await readFile(fileURLToPath(new URL(\"../package.json\", import.meta.url)), \"utf8\"),\n ) as { version?: string };\n return pkg.version ?? \"unknown\";\n } catch {\n return \"unknown\";\n }\n}\n\n/**\n * The `verify` exit code: `0` valid and anchored (genesis or a verified\n * checkpoint) with every event covered by a verified checkpoint, `2` valid\n * but the tail (or the start) is not anchored by a signature, `1` invalid.\n */\nexport function verifyExitCode(report: VerifyReport): 0 | 1 | 2 {\n if (!report.ok) return 1;\n if (report.checked === 0) return 0;\n const anchored = report.anchor === \"genesis\" || report.anchor === \"checkpoint\";\n const signed = report.signedThrough !== null && report.signedThrough >= (report.toSeq ?? 0);\n return anchored && signed ? 0 : 2;\n}\n\nfunction describeReport(report: VerifyReport): string {\n const lines = [\n `${report.ok ? \"VALID\" : \"INVALID\"}: ${report.checked} event(s)` +\n (report.fromSeq !== null ? ` (seq ${report.fromSeq}..${report.toSeq})` : \"\") +\n (report.tenant ? ` of tenant \"${report.tenant}\"` : \"\"),\n `anchor: ${report.anchor}; checkpoints verified: ${report.checkpointsVerified}; signed through: ${report.signedThrough ?? \"—\"}`,\n ];\n if (report.erased.length)\n lines.push(`erased: ${report.erased.length} event(s) with erased sections`);\n for (const issue of report.issues) {\n lines.push(\n ` ✗ ${issue.kind}${issue.seq !== undefined ? ` @${issue.seq}` : \"\"}: ${issue.message}`,\n );\n }\n const code = verifyExitCode(report);\n if (code === 2) {\n lines.push(\n report.signedThrough === null\n ? \"warning: no verified checkpoint covers these events (unsigned)\"\n : `warning: events after seq ${report.signedThrough} are not covered by a verified checkpoint`,\n );\n }\n return lines.join(\"\\n\") + \"\\n\";\n}\n\n/** Keys from `--jwks <file|url>`. */\nasync function loadJwks(source: string): Promise<AuditVerificationKey[]> {\n let text: string;\n if (/^https?:\\/\\//.test(source)) {\n const res = await fetch(source);\n if (!res.ok) throw new Error(`GET ${source} → ${res.status}`);\n text = await res.text();\n } else {\n const { readFile } = await import(\"node:fs/promises\");\n text = await readFile(source, \"utf8\");\n }\n return keysFromJwks(JSON.parse(text) as { keys: JsonWebKey[] });\n}\n\nfunction helpText(version: string): string {\n return `xtandard-audit v${version} — self-hosted, tamper-evident audit-log control plane\n\nUsage:\n xtandard-audit <command> [options] # the binary, after: npm i -g @xtandard/audit\n npx @xtandard/audit <command> # without installing (or: bunx @xtandard/audit …)\n\nCommands:\n serve [--port <n>] Run the panel + API + streams + retention (no Docker).\n record --tenant <t> --action <a> --actor <id> [--actor-type <type>]\n [--targets type:id,…] [--metadata '<json>'] [--outcome success|failure]\n [--description <text>]\n record --event '<json>' Record one event (ingest from shell/CI). Prints it.\n query [--tenant <t>] [--actions a,b] [--excludeActions …] [--actorId …] [--actorType …]\n [--targetType …] [--targetId …] [--outcome …] [--from …] [--to …] [--search …]\n [--order asc|desc] [--limit n] [--cursor c] [--json]\n Search events (flags = the HTTP query parameters).\n export --tenant <t> [--format csv|json|jsonl|bundle] [--out <file>] [query flags]\n Stream an export to stdout (or --out).\n verify --bundle <file.jsonl> [--jwks <file|url>] [--hmac-secret <s>]\n verify --tenant <t> [--fromSeq n] [--toSeq n]\n Verify an export bundle offline (or a tenant's chain in\n storage). Exit 0 = valid and anchored by genesis or a\n verified checkpoint; 2 = valid but the tail is not covered\n by a verified checkpoint (unsigned); 1 = invalid.\n prune [--tenant <t>] Apply the retention policy (RETENTION_*).\n checkpoint --tenant <t> Sign a tenant's chain head (needs AUDIT_SIGNING_KEY or\n AUDIT_HMAC_SECRET).\n keygen Print a new Ed25519 private JWK (→ AUDIT_SIGNING_KEY) and\n its public JWKS.\n tenants List tenants with their head seq and retained count.\n actions List the action catalog.\n\nGlobal options:\n -h, --help Show this help.\n -v, --version Print the version.\n\nEnvironment variables\n Storage:\n STORAGE_DRIVER memory | file | redis | postgres | mongodb | sqlite | libsql\n (CLI default: file · Docker default: memory)\n STORAGE_FILE_DIR ./.audit (driver: file)\n REDIS_URL, STORAGE_PREFIX redis://localhost:6379, xtandard:audit (driver: redis)\n DATABASE_URL | POSTGRES_URL, STORAGE_PG_TABLE (driver: postgres)\n MONGO_URL, MONGO_DB, STORAGE_MONGO_COLLECTION (driver: mongodb)\n STORAGE_SQLITE_PATH ./.audit/audit.sqlite (driver: sqlite, Bun only)\n LIBSQL_URL, LIBSQL_AUTH_TOKEN (driver: libsql)\n\n Integrity:\n AUDIT_SIGNING_KEY Ed25519 private JWK (JSON) — signs checkpoints; the public\n key is served at {BASE_PATH}/api/integrity/keys.\n AUDIT_HMAC_SECRET HMAC checkpoint secret (when no AUDIT_SIGNING_KEY).\n\n Retention (kept if EITHER rule keeps it; never past an undelivered stream cursor):\n RETENTION_MAX_AGE e.g. 365d (ms|s|m|h|d)\n RETENTION_KEEP_LAST Keep at most the N most recent events per tenant.\n MAINTENANCE_INTERVAL 1h How often \\`serve\\` prunes; 0|false disables.\n\n Server (\\`serve\\` / standalone):\n PORT 3000 Port to listen on (or --port).\n BASE_PATH \"\" URL prefix, e.g. \"/audit\".\n TITLE Navbar wordmark.\n LOGO_URL Logo image URL.\n READONLY 1|true Block all mutating operations.\n AUTH_MODE none|basic Authentication mode (default none; any other value is rejected).\n AUTH_USERNAME admin Username for basic auth.\n AUTH_PASSWORD_HASH scrypt hash (preferred; see docs/AUTH.md).\n AUTH_PASSWORD Plaintext password (dev only).\n AUTH_ROLE admin Role of the basic-auth user (admin | auditor | viewer).\n PORTAL_SECRET Enables portal-token access (audpt_… bearer tokens).\n\n Streams (\\`serve\\` / standalone):\n AUDIT_STREAMS JSON array: [{ \"name\": \"siem\", \"sink\": \"http\",\n \"options\": { \"url\": \"https://…\" }, \"startFrom\": \"now\" }]\n STREAM_RUNNER 1 0|false: show stream status but do not run them here.\n\nExamples:\n # Quick local panel (file storage, no auth):\n npx @xtandard/audit serve --port 3004\n\n # Signed checkpoints:\n export AUDIT_SIGNING_KEY=\"$(xtandard-audit keygen | head -1)\"\n\n # Record from CI:\n xtandard-audit record --tenant acme --action deploy.finished --actor ci \\\\\n --metadata '{\"sha\":\"abc123\"}'\n\n # Export a verifiable bundle and verify it against the published keys:\n xtandard-audit export --tenant acme --format bundle --out acme.jsonl\n xtandard-audit verify --bundle acme.jsonl --jwks https://app.example.com/audit/api/integrity/keys\n\nDocs: https://github.com/xantiagoma/xtandard-audit\n`;\n}\n\n/** Entry point. Returns the process exit code. */\nexport async function run(argv: string[]): Promise<number> {\n const { _, flags } = parseArgs(argv);\n const command = _[0];\n\n // `--version` (bare) / `-v` / `version` → print version.\n if (flags.version === true || argv.includes(\"-v\") || command === \"version\") {\n process.stdout.write(`${await pkgVersion()}\\n`);\n return 0;\n }\n\n const wantsHelp = Boolean(flags.help) || argv.includes(\"-h\") || command === \"help\";\n if (!command || wantsHelp) {\n process.stdout.write(helpText(await pkgVersion()));\n // Explicit help request → success; bare invocation with no command → usage error.\n return wantsHelp ? 0 : 1;\n }\n\n try {\n switch (command) {\n case \"keygen\": {\n const { privateJwk, publicJwk } = await generateSigningKeyPair();\n process.stdout.write(\n `${JSON.stringify(privateJwk)}\\n${JSON.stringify({ keys: [{ ...publicJwk, alg: \"Ed25519\", use: \"sig\" }] })}\\n`,\n );\n process.stderr.write(\n \"Line 1: private JWK — set it as AUDIT_SIGNING_KEY (keep it secret).\\n\" +\n \"Line 2: public JWKS — publish it so auditors can verify checkpoints.\\n\",\n );\n return 0;\n }\n case \"tenants\": {\n const core = await makeCore();\n const tenants = await core.listTenants();\n if (tenants.length === 0) process.stdout.write(\"No tenants.\\n\");\n for (const t of tenants) {\n process.stdout.write(\n `${t.key} seq ${t.head.seq} ${t.count ?? 0} event(s)` +\n (t.head.baseSeq && t.head.baseSeq > 1 ? ` (pruned before ${t.head.baseSeq})` : \"\") +\n \"\\n\",\n );\n }\n return 0;\n }\n case \"actions\": {\n const core = await makeCore();\n const actions = await core.listActions();\n if (actions.length === 0) process.stdout.write(\"No actions in the catalog.\\n\");\n for (const a of actions) {\n process.stdout.write(\n `${a.name}${a.group ? ` [${a.group}]` : \"\"}${a.deprecated ? \" (deprecated)\" : \"\"}` +\n `${a.description ? ` ${a.description}` : \"\"}\\n`,\n );\n }\n return 0;\n }\n case \"record\": {\n let input: Partial<AuditEventInput>;\n const eventJson = str(flags, \"event\");\n if (eventJson) {\n try {\n input = JSON.parse(eventJson) as Partial<AuditEventInput>;\n } catch {\n process.stderr.write(\"Invalid --event JSON.\\n\");\n return 1;\n }\n } else {\n const tenant = str(flags, \"tenant\");\n const action = str(flags, \"action\");\n const actorId = str(flags, \"actor\");\n if (!tenant || !action || !actorId) {\n process.stderr.write(\n \"Usage: xtandard-audit record --tenant <t> --action <a> --actor <id> [--metadata '<json>'] [--targets type:id,…]\\n\" +\n \" or: xtandard-audit record --event '<json>'\\n\",\n );\n return 1;\n }\n let metadata: JsonObject | undefined;\n const raw = str(flags, \"metadata\");\n if (raw) {\n try {\n metadata = JSON.parse(raw) as JsonObject;\n } catch {\n process.stderr.write(\"Invalid --metadata JSON.\\n\");\n return 1;\n }\n }\n const targets = str(flags, \"targets\")\n ?.split(\",\")\n .filter(Boolean)\n .map((t) => {\n const i = t.indexOf(\":\");\n return i > 0 ? { type: t.slice(0, i), id: t.slice(i + 1) } : { type: t, id: t };\n });\n const actorType = str(flags, \"actor-type\");\n const outcome = str(flags, \"outcome\");\n const description = str(flags, \"description\");\n input = {\n tenant,\n action,\n actor: { id: actorId, ...(actorType ? { type: actorType } : {}) },\n ...(targets?.length ? { targets } : {}),\n ...(metadata ? { metadata } : {}),\n ...(outcome ? { outcome: outcome as AuditEventInput[\"outcome\"] } : {}),\n ...(description ? { description } : {}),\n };\n }\n const core = await makeCore();\n const event = await core.record(input as AuditEventInput);\n process.stdout.write(`${JSON.stringify(event, null, 2)}\\n`);\n return 0;\n }\n case \"query\": {\n const core = await makeCore();\n const page = await core.query(queryFromFlags(flags));\n if (flags.json) {\n process.stdout.write(`${JSON.stringify(page, null, 2)}\\n`);\n return 0;\n }\n if (page.items.length === 0) process.stdout.write(\"No events.\\n\");\n for (const e of page.items) {\n process.stdout.write(\n `${e.occurredAt} ${e.tenant}#${e.seq} ${e.action} by ${e.actor.id}` +\n (e.targets.length\n ? ` → ${e.targets.map((t) => `${t.type}:${t.id}`).join(\",\")}`\n : \"\") +\n (e.outcome === \"failure\" ? \" (failure)\" : \"\") +\n \"\\n\",\n );\n }\n if (page.pageInfo.hasNextPage) {\n process.stdout.write(`… more: --cursor ${page.pageInfo.endCursor}\\n`);\n }\n return 0;\n }\n case \"export\": {\n const tenant = str(flags, \"tenant\");\n const format = (str(flags, \"format\") ?? \"jsonl\") as ExportFormat;\n if (!tenant) {\n process.stderr.write(\n \"Usage: xtandard-audit export --tenant <t> [--format csv|json|jsonl|bundle] [--out <file>]\\n\",\n );\n return 1;\n }\n if (!(format in EXPORT_CONTENT_TYPES)) {\n process.stderr.write(`Invalid --format \"${format}\" (csv | json | jsonl | bundle).\\n`);\n return 1;\n }\n const core = await makeCore();\n const query = { ...queryFromFlags(flags), tenant };\n delete query.limit;\n delete query.cursor;\n const stream = await exportEvents(core, query, {\n format,\n actor: { id: \"cli\", name: \"xtandard-audit CLI\" },\n });\n const out = str(flags, \"out\");\n if (out) {\n const { createWriteStream } = await import(\"node:fs\");\n const file = createWriteStream(out);\n for await (const chunk of stream as unknown as AsyncIterable<Uint8Array>)\n file.write(chunk);\n await new Promise<void>((resolve, reject) => {\n file.end((err?: Error | null) => (err ? reject(err) : resolve()));\n });\n process.stderr.write(`Exported ${format} → ${out}\\n`);\n } else {\n for await (const chunk of stream as unknown as AsyncIterable<Uint8Array>) {\n process.stdout.write(chunk);\n }\n }\n return 0;\n }\n case \"verify\": {\n const bundlePath = str(flags, \"bundle\");\n const tenant = str(flags, \"tenant\");\n if (!bundlePath && !tenant) {\n process.stderr.write(\n \"Usage: xtandard-audit verify --bundle <file.jsonl> [--jwks <file|url>] [--hmac-secret <s>]\\n\" +\n \" or: xtandard-audit verify --tenant <t> [--fromSeq n] [--toSeq n]\\n\",\n );\n return 1;\n }\n let report: VerifyReport;\n if (bundlePath) {\n const { readFile } = await import(\"node:fs/promises\");\n const text = await readFile(bundlePath, \"utf8\");\n const keys: AuditVerificationKey[] = [];\n const jwks = str(flags, \"jwks\");\n if (jwks) {\n keys.push(...(await loadJwks(jwks)));\n } else {\n // Without --jwks, trust the bundle's own JWKS (and say so).\n const embedded = parseBundle(text).jwks;\n if (embedded?.keys.length) {\n keys.push(...(await keysFromJwks(embedded as { keys: JsonWebKey[] })));\n process.stderr.write(\n \"note: checkpoint signatures verified with the keys embedded in the bundle — pass --jwks <operator's published keys> to not trust the file for them.\\n\",\n );\n }\n }\n const hmac = str(flags, \"hmac-secret\") ?? env(\"AUDIT_HMAC_SECRET\");\n if (hmac) keys.push(hmacVerificationKey(hmac));\n report = await verifyBundle(text, keys.length ? { keys } : {});\n } else {\n const core = await makeCore();\n const fromSeq = str(flags, \"fromSeq\");\n const toSeq = str(flags, \"toSeq\");\n report = await core.verify(tenant!, {\n ...(fromSeq ? { fromSeq: Number(fromSeq) } : {}),\n ...(toSeq ? { toSeq: Number(toSeq) } : {}),\n });\n }\n if (flags.json) process.stdout.write(`${JSON.stringify(report, null, 2)}\\n`);\n else process.stdout.write(describeReport(report));\n return verifyExitCode(report);\n }\n case \"prune\": {\n const core = await makeCore();\n if (!core.options.retention) {\n process.stderr.write(\n \"No retention policy: set RETENTION_MAX_AGE and/or RETENTION_KEEP_LAST.\\n\",\n );\n return 1;\n }\n const tenant = str(flags, \"tenant\");\n const actor = { actor: { id: \"cli\", name: \"xtandard-audit CLI\" } };\n const results = tenant ? [await core.pruneTenant(tenant, actor)] : await core.prune(actor);\n for (const r of results) {\n process.stdout.write(\n `${r.tenant}: pruned ${r.pruned}, first retained seq ${r.baseSeq}\\n`,\n );\n }\n return 0;\n }\n case \"checkpoint\": {\n const tenant = str(flags, \"tenant\");\n if (!tenant) {\n process.stderr.write(\"Usage: xtandard-audit checkpoint --tenant <t>\\n\");\n return 1;\n }\n const core = await makeCore();\n const cp = await core.checkpoint(tenant, {\n actor: { id: \"cli\", name: \"xtandard-audit CLI\" },\n });\n process.stdout.write(`${JSON.stringify(cp, null, 2)}\\n`);\n return 0;\n }\n case \"serve\": {\n const port = Number(str(flags, \"port\") || env(\"PORT\", \"3000\"));\n const basePath = env(\"BASE_PATH\", \"\");\n const title = env(\"TITLE\", \"@xtandard/audit\");\n const logoUrl = env(\"LOGO_URL\");\n const readonly = isTruthy(env(\"READONLY\"));\n const authMode = authModeFromEnv();\n const portalSecret = env(\"PORTAL_SECRET\");\n const maintenanceRaw = env(\"MAINTENANCE_INTERVAL\");\n\n // Auth first: an unknown AUTH_MODE fails before any storage/stream connects.\n const { auth, authorization } = await buildAuth();\n const { createFetchHandler } = await import(\"./server/create-fetch-handler.ts\");\n const [storage, signer, streams] = await Promise.all([\n buildStorage(),\n signerFromEnv(),\n streamsFromEnv(),\n ]);\n\n if (authMode === \"none\") {\n warn(\"AUTH_MODE=none — do NOT expose this publicly without authentication.\");\n }\n\n const retention = retentionFromEnv();\n const panel = createFetchHandler({\n storage,\n basePath,\n title,\n ...(logoUrl ? { logoUrl } : {}),\n readonly,\n auth,\n authorization,\n ...(signer ? { signer } : {}),\n ...(portalSecret ? { portal: { secret: portalSecret } } : {}),\n ...(retention ? { retention } : {}),\n ...(streams.length ? { streams } : {}),\n ...(isFalsy(env(\"STREAM_RUNNER\", \"1\")) ? { streamRunner: false as const } : {}),\n maintenance:\n maintenanceRaw && isFalsy(maintenanceRaw)\n ? false\n : { interval: (parseDurationEnv(\"MAINTENANCE_INTERVAL\") ?? \"1h\") as AuditDuration },\n });\n\n const normalizedBase =\n basePath && basePath !== \"/\"\n ? basePath.startsWith(\"/\")\n ? basePath\n : `/${basePath}`\n : \"\";\n\n const handler: FetchHandler = (request) => {\n const url = new URL(request.url);\n if (url.pathname === \"/healthcheck\" || url.pathname === `${normalizedBase}/healthcheck`) {\n return new Response(JSON.stringify({ status: \"ok\", title }), {\n headers: { \"content-type\": \"application/json\" },\n });\n }\n return panel.fetch(request);\n };\n\n process.stdout.write(`[xtandard/audit] storage: ${await describeStorage()}\\n`);\n process.stdout.write(\n `[xtandard/audit] signer: ${signer ? `${signer.alg} (${signer.keyId})` : \"none (no checkpoints)\"}\\n`,\n );\n process.stdout.write(\n `[xtandard/audit] streams: ${\n streams.length\n ? `${streams.map((s) => s.name).join(\", \")}${isFalsy(env(\"STREAM_RUNNER\", \"1\")) ? \" (not running here)\" : \"\"}`\n : \"none\"\n }\\n`,\n );\n\n await startServer(port, handler);\n process.stdout.write(\n `[xtandard/audit] listening on http://localhost:${port}${normalizedBase || \"/\"}\\n`,\n );\n // The server owns the process now; never resolve so the bin doesn't exit.\n return await new Promise<number>(() => {});\n }\n default:\n process.stderr.write(`Unknown command: ${command}\\n\\n${helpText(await pkgVersion())}`);\n return 1;\n }\n } catch (err) {\n process.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}\\n`);\n return 1;\n }\n}\n\n// `bun src/cli.ts <command>` (contributors); the published bin calls `run` itself.\nif ((import.meta as ImportMeta & { main?: boolean }).main) {\n void run(process.argv.slice(2)).then((code) => process.exit(code));\n}\n"],"mappings":"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"}
package/dist/cli.mjs CHANGED
@@ -219,9 +219,12 @@ async function streamsFromEnv() {
219
219
  }
220
220
  return out;
221
221
  }
222
+ /** `AUTH_MODE`, with an empty value meaning the default `none`. */
223
+ const authModeFromEnv = () => process.env.AUTH_MODE || "none";
222
224
  /** Build the auth + authorization providers from env (mirrors the standalone app). */
223
225
  async function buildAuth() {
224
- if (env("AUTH_MODE", "none") === "basic") {
226
+ const mode = authModeFromEnv();
227
+ if (mode === "basic") {
225
228
  const [{ basicAuth }, { rolesAuthorization }] = await Promise.all([import("./basic-DU_nPrWV.mjs").then((n) => n.n), import("./roles-D7Pg89IJ.mjs").then((n) => n.a)]);
226
229
  const passwordHash = env("AUTH_PASSWORD_HASH");
227
230
  const password = env("AUTH_PASSWORD");
@@ -236,6 +239,7 @@ async function buildAuth() {
236
239
  authorization: rolesAuthorization({})
237
240
  };
238
241
  }
242
+ if (mode !== "none") throw new Error(`Unknown AUTH_MODE "${mode}" (expected none or basic)`);
239
243
  const [{ noAuth }, { noAuthorization }] = await Promise.all([import("./none-CkV5mZsB.mjs").then((n) => n.r), import("./none-DBeBeU0Z.mjs").then((n) => n.n)]);
240
244
  return {
241
245
  auth: noAuth(),
@@ -462,7 +466,7 @@ Environment variables
462
466
  TITLE Navbar wordmark.
463
467
  LOGO_URL Logo image URL.
464
468
  READONLY 1|true Block all mutating operations.
465
- AUTH_MODE none|basic Authentication mode (default none).
469
+ AUTH_MODE none|basic Authentication mode (default none; any other value is rejected).
466
470
  AUTH_USERNAME admin Username for basic auth.
467
471
  AUTH_PASSWORD_HASH scrypt hash (preferred; see docs/AUTH.md).
468
472
  AUTH_PASSWORD Plaintext password (dev only).
@@ -703,15 +707,15 @@ async function run(argv) {
703
707
  const title = env("TITLE", "@xtandard/audit");
704
708
  const logoUrl = env("LOGO_URL");
705
709
  const readonly = isTruthy(env("READONLY"));
706
- const authMode = env("AUTH_MODE", "none");
710
+ const authMode = authModeFromEnv();
707
711
  const portalSecret = env("PORTAL_SECRET");
708
712
  const maintenanceRaw = env("MAINTENANCE_INTERVAL");
713
+ const { auth, authorization } = await buildAuth();
709
714
  const { createFetchHandler } = await import("./create-fetch-handler-BwQQ_IWf.mjs").then((n) => n.n);
710
- const [storage, signer, streams, { auth, authorization }] = await Promise.all([
715
+ const [storage, signer, streams] = await Promise.all([
711
716
  buildStorage(),
712
717
  signerFromEnv(),
713
- streamsFromEnv(),
714
- buildAuth()
718
+ streamsFromEnv()
715
719
  ]);
716
720
  if (authMode === "none") warn("AUTH_MODE=none — do NOT expose this publicly without authentication.");
717
721
  const retention = retentionFromEnv();