@usebetterdev/audit-cli 0.4.0-beta.1

package/dist/check.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `better-audit check` — Verify audit_logs table exists and the ORM adapter
+ * is correctly capturing mutations.
+ *
+ * Checks:
+ *   1. audit_logs table exists with all required columns
+ *   2. Indexes are present
+ *   3. ORM adapter is installed and responds to a test mutation
+ *
+ * TODO: Connect to DB and run checks.
+ */
+interface CheckOptions {
+    config?: string;
+}
+declare function check(options?: CheckOptions): Promise<void>;
+
+export { type CheckOptions, check };

package/dist/check.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import {
+  check
+} from "./chunk-2LFMRHGS.js";
+export {
+  check
+};
+//# sourceMappingURL=check.js.map

package/dist/check.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-2G3BRX4J.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+
+// src/migrate.ts
+async function migrate(options = {}) {
+  console.log("[better-audit] migrate \u2014 not yet implemented");
+  void options;
+}
+
+export {
+  migrate
+};
+//# sourceMappingURL=chunk-2G3BRX4J.js.map

package/dist/chunk-2G3BRX4J.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/migrate.ts"],"sourcesContent":["/**\n * `better-audit migrate` — Generate and apply the audit_logs table migration.\n *\n * Generates appropriate DDL for the configured database:\n *   - Postgres: JSONB columns, TIMESTAMPTZ, INET, GIN indexes\n *   - MySQL:    JSON columns, DATETIME(6), standard indexes\n *   - SQLite:   TEXT columns for JSON, standard indexes\n *\n * TODO: Connect to DB via adapter config and run migration.\n */\n\nexport interface MigrateOptions {\n  /** Config file path (default: better-audit.config.ts) */\n  config?: string;\n  /** Output SQL to stdout instead of applying it */\n  dryRun?: boolean;\n}\n\nexport async function migrate(options: MigrateOptions = {}): Promise<void> {\n  console.log(\"[better-audit] migrate — not yet implemented\");\n  void options;\n}\n"],"mappings":";;;AAkBA,eAAsB,QAAQ,UAA0B,CAAC,GAAkB;AACzE,UAAQ,IAAI,mDAA8C;AAC1D,OAAK;AACP;","names":[]}

package/dist/chunk-2LFMRHGS.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+
+// src/check.ts
+async function check(options = {}) {
+  console.log("[better-audit] check \u2014 not yet implemented");
+  void options;
+}
+
+export {
+  check
+};
+//# sourceMappingURL=chunk-2LFMRHGS.js.map

package/dist/chunk-2LFMRHGS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/check.ts"],"sourcesContent":["/**\n * `better-audit check` — Verify audit_logs table exists and the ORM adapter\n * is correctly capturing mutations.\n *\n * Checks:\n *   1. audit_logs table exists with all required columns\n *   2. Indexes are present\n *   3. ORM adapter is installed and responds to a test mutation\n *\n * TODO: Connect to DB and run checks.\n */\n\nexport interface CheckOptions {\n  config?: string;\n}\n\nexport async function check(options: CheckOptions = {}): Promise<void> {\n  console.log(\"[better-audit] check — not yet implemented\");\n  void options;\n}\n"],"mappings":";;;AAgBA,eAAsB,MAAM,UAAwB,CAAC,GAAkB;AACrE,UAAQ,IAAI,iDAA4C;AACxD,OAAK;AACP;","names":[]}

package/dist/chunk-3MHCJHIZ.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+
+// src/stats.ts
+async function stats(options = {}) {
+  console.log("[better-audit] stats \u2014 not yet implemented");
+  void options;
+}
+
+export {
+  stats
+};
+//# sourceMappingURL=chunk-3MHCJHIZ.js.map

package/dist/chunk-3MHCJHIZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/stats.ts"],"sourcesContent":["/**\n * `better-audit stats` — Show audit log statistics.\n *\n * Outputs:\n *   - Total log count\n *   - Events per day (last 7 / 30 days)\n *   - Top actors (by event count)\n *   - Top tables (by event count)\n *   - Severity distribution\n *\n * TODO: Connect to DB and run aggregation queries.\n */\n\nexport interface StatsOptions {\n  config?: string;\n  since?: string;\n}\n\nexport async function stats(options: StatsOptions = {}): Promise<void> {\n  console.log(\"[better-audit] stats — not yet implemented\");\n  void options;\n}\n"],"mappings":";;;AAkBA,eAAsB,MAAM,UAAwB,CAAC,GAAkB;AACrE,UAAQ,IAAI,iDAA4C;AACxD,OAAK;AACP;","names":[]}

package/dist/chunk-MG36ZYWA.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+
+// src/purge.ts
+async function purge(options = {}) {
+  if (options.dryRun) {
+    console.log("[better-audit] purge --dry-run \u2014 not yet implemented");
+  } else {
+    console.log("[better-audit] purge \u2014 not yet implemented");
+  }
+  void options;
+}
+
+export {
+  purge
+};
+//# sourceMappingURL=chunk-MG36ZYWA.js.map

package/dist/chunk-MG36ZYWA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/purge.ts"],"sourcesContent":["/**\n * `better-audit purge` — Delete audit logs older than the configured retention period.\n *\n * Always run with --dry-run first to preview what will be deleted.\n *\n * TODO: Connect to DB and run DELETE query with retention window.\n */\n\nexport interface PurgeOptions {\n  config?: string;\n  /** Preview rows to be deleted without deleting them. */\n  dryRun?: boolean;\n}\n\nexport async function purge(options: PurgeOptions = {}): Promise<void> {\n  if (options.dryRun) {\n    console.log(\"[better-audit] purge --dry-run — not yet implemented\");\n  } else {\n    console.log(\"[better-audit] purge — not yet implemented\");\n  }\n  void options;\n}\n"],"mappings":";;;AAcA,eAAsB,MAAM,UAAwB,CAAC,GAAkB;AACrE,MAAI,QAAQ,QAAQ;AAClB,YAAQ,IAAI,2DAAsD;AAAA,EACpE,OAAO;AACL,YAAQ,IAAI,iDAA4C;AAAA,EAC1D;AACA,OAAK;AACP;","names":[]}

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+#!/usr/bin/env node
+import {
+  check
+} from "./chunk-2LFMRHGS.js";
+import {
+  migrate
+} from "./chunk-2G3BRX4J.js";
+import {
+  purge
+} from "./chunk-MG36ZYWA.js";
+import {
+  stats
+} from "./chunk-3MHCJHIZ.js";
+
+// src/cli.ts
+import { Command } from "commander";
+var program = new Command().name("better-audit").description("CLI for better-audit \u2014 compliance-ready audit logging").version("0.1.0");
+program.command("migrate").description("Generate and apply the audit_logs table migration").option("-c, --config <path>", "Config file path", "better-audit.config.ts").option("--dry-run", "Print SQL without applying it").action(async (opts) => {
+  const migrateOpts = { config: opts.config };
+  if (opts.dryRun !== void 0) migrateOpts.dryRun = opts.dryRun;
+  await migrate(migrateOpts);
+});
+program.command("check").description("Verify the audit_logs table and ORM adapter are working").option("-c, --config <path>", "Config file path", "better-audit.config.ts").action(async (opts) => {
+  await check({ config: opts.config });
+});
+program.command("stats").description("Show audit log statistics").option("-c, --config <path>", "Config file path", "better-audit.config.ts").option("--since <period>", "Time window (e.g. 30d)", "30d").action(async (opts) => {
+  await stats({ config: opts.config, since: opts.since });
+});
+program.command("purge").description("Delete audit logs older than the retention period").option("-c, --config <path>", "Config file path", "better-audit.config.ts").option("--dry-run", "Preview rows to be deleted without deleting them").action(async (opts) => {
+  const purgeOpts = { config: opts.config };
+  if (opts.dryRun !== void 0) purgeOpts.dryRun = opts.dryRun;
+  await purge(purgeOpts);
+});
+program.parseAsync(process.argv).catch((err) => {
+  console.error(err);
+  process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { Command } from \"commander\";\nimport { migrate } from \"./migrate.js\";\nimport { check } from \"./check.js\";\nimport { stats } from \"./stats.js\";\nimport { purge } from \"./purge.js\";\n\nconst program = new Command()\n  .name(\"better-audit\")\n  .description(\"CLI for better-audit — compliance-ready audit logging\")\n  .version(\"0.1.0\");\n\nprogram\n  .command(\"migrate\")\n  .description(\"Generate and apply the audit_logs table migration\")\n  .option(\"-c, --config <path>\", \"Config file path\", \"better-audit.config.ts\")\n  .option(\"--dry-run\", \"Print SQL without applying it\")\n  .action(async (opts: { config: string; dryRun?: boolean }) => {\n    const migrateOpts: Parameters<typeof migrate>[0] = { config: opts.config };\n    if (opts.dryRun !== undefined) migrateOpts.dryRun = opts.dryRun;\n    await migrate(migrateOpts);\n  });\n\nprogram\n  .command(\"check\")\n  .description(\"Verify the audit_logs table and ORM adapter are working\")\n  .option(\"-c, --config <path>\", \"Config file path\", \"better-audit.config.ts\")\n  .action(async (opts: { config: string }) => {\n    await check({ config: opts.config });\n  });\n\nprogram\n  .command(\"stats\")\n  .description(\"Show audit log statistics\")\n  .option(\"-c, --config <path>\", \"Config file path\", \"better-audit.config.ts\")\n  .option(\"--since <period>\", \"Time window (e.g. 30d)\", \"30d\")\n  .action(async (opts: { config: string; since: string }) => {\n    await stats({ config: opts.config, since: opts.since });\n  });\n\nprogram\n  .command(\"purge\")\n  .description(\"Delete audit logs older than the retention period\")\n  .option(\"-c, --config <path>\", \"Config file path\", \"better-audit.config.ts\")\n  .option(\"--dry-run\", \"Preview rows to be deleted without deleting them\")\n  .action(async (opts: { config: string; dryRun?: boolean }) => {\n    const purgeOpts: Parameters<typeof purge>[0] = { config: opts.config };\n    if (opts.dryRun !== undefined) purgeOpts.dryRun = opts.dryRun;\n    await purge(purgeOpts);\n  });\n\nprogram.parseAsync(process.argv).catch((err: unknown) => {\n  console.error(err);\n  process.exit(1);\n});\n"],"mappings":";;;;;;;;;;;;;;;;AACA,SAAS,eAAe;AAMxB,IAAM,UAAU,IAAI,QAAQ,EACzB,KAAK,cAAc,EACnB,YAAY,4DAAuD,EACnE,QAAQ,OAAO;AAElB,QACG,QAAQ,SAAS,EACjB,YAAY,mDAAmD,EAC/D,OAAO,uBAAuB,oBAAoB,wBAAwB,EAC1E,OAAO,aAAa,+BAA+B,EACnD,OAAO,OAAO,SAA+C;AAC5D,QAAM,cAA6C,EAAE,QAAQ,KAAK,OAAO;AACzE,MAAI,KAAK,WAAW,OAAW,aAAY,SAAS,KAAK;AACzD,QAAM,QAAQ,WAAW;AAC3B,CAAC;AAEH,QACG,QAAQ,OAAO,EACf,YAAY,yDAAyD,EACrE,OAAO,uBAAuB,oBAAoB,wBAAwB,EAC1E,OAAO,OAAO,SAA6B;AAC1C,QAAM,MAAM,EAAE,QAAQ,KAAK,OAAO,CAAC;AACrC,CAAC;AAEH,QACG,QAAQ,OAAO,EACf,YAAY,2BAA2B,EACvC,OAAO,uBAAuB,oBAAoB,wBAAwB,EAC1E,OAAO,oBAAoB,0BAA0B,KAAK,EAC1D,OAAO,OAAO,SAA4C;AACzD,QAAM,MAAM,EAAE,QAAQ,KAAK,QAAQ,OAAO,KAAK,MAAM,CAAC;AACxD,CAAC;AAEH,QACG,QAAQ,OAAO,EACf,YAAY,mDAAmD,EAC/D,OAAO,uBAAuB,oBAAoB,wBAAwB,EAC1E,OAAO,aAAa,kDAAkD,EACtE,OAAO,OAAO,SAA+C;AAC5D,QAAM,YAAyC,EAAE,QAAQ,KAAK,OAAO;AACrE,MAAI,KAAK,WAAW,OAAW,WAAU,SAAS,KAAK;AACvD,QAAM,MAAM,SAAS;AACvB,CAAC;AAEH,QAAQ,WAAW,QAAQ,IAAI,EAAE,MAAM,CAAC,QAAiB;AACvD,UAAQ,MAAM,GAAG;AACjB,UAAQ,KAAK,CAAC;AAChB,CAAC;","names":[]}

package/dist/migrate.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `better-audit migrate` — Generate and apply the audit_logs table migration.
+ *
+ * Generates appropriate DDL for the configured database:
+ *   - Postgres: JSONB columns, TIMESTAMPTZ, INET, GIN indexes
+ *   - MySQL:    JSON columns, DATETIME(6), standard indexes
+ *   - SQLite:   TEXT columns for JSON, standard indexes
+ *
+ * TODO: Connect to DB via adapter config and run migration.
+ */
+interface MigrateOptions {
+    /** Config file path (default: better-audit.config.ts) */
+    config?: string;
+    /** Output SQL to stdout instead of applying it */
+    dryRun?: boolean;
+}
+declare function migrate(options?: MigrateOptions): Promise<void>;
+
+export { type MigrateOptions, migrate };

package/dist/migrate.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import {
+  migrate
+} from "./chunk-2G3BRX4J.js";
+export {
+  migrate
+};
+//# sourceMappingURL=migrate.js.map

package/dist/migrate.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/purge.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `better-audit purge` — Delete audit logs older than the configured retention period.
+ *
+ * Always run with --dry-run first to preview what will be deleted.
+ *
+ * TODO: Connect to DB and run DELETE query with retention window.
+ */
+interface PurgeOptions {
+    config?: string;
+    /** Preview rows to be deleted without deleting them. */
+    dryRun?: boolean;
+}
+declare function purge(options?: PurgeOptions): Promise<void>;
+
+export { type PurgeOptions, purge };

package/dist/purge.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import {
+  purge
+} from "./chunk-MG36ZYWA.js";
+export {
+  purge
+};
+//# sourceMappingURL=purge.js.map

package/dist/purge.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/stats.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `better-audit stats` — Show audit log statistics.
+ *
+ * Outputs:
+ *   - Total log count
+ *   - Events per day (last 7 / 30 days)
+ *   - Top actors (by event count)
+ *   - Top tables (by event count)
+ *   - Severity distribution
+ *
+ * TODO: Connect to DB and run aggregation queries.
+ */
+interface StatsOptions {
+    config?: string;
+    since?: string;
+}
+declare function stats(options?: StatsOptions): Promise<void>;
+
+export { type StatsOptions, stats };

package/dist/stats.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import {
+  stats
+} from "./chunk-3MHCJHIZ.js";
+export {
+  stats
+};
+//# sourceMappingURL=stats.js.map

package/dist/stats.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@usebetterdev/audit-cli",
+  "version": "0.4.0-beta.1",
+  "repository": "github:usebetter-dev/usebetter",
+  "bugs": "https://github.com/usebetter-dev/usebetter/issues",
+  "homepage": "https://github.com/usebetter-dev/usebetter#readme",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "type": "module",
+  "main": "./dist/cli.js",
+  "bin": {
+    "better-audit": "./dist/cli.js",
+    "audit-cli": "./dist/cli.js"
+  },
+  "files": ["dist"],
+  "scripts": {
+    "prepare": "mkdir -p dist && test -f dist/cli.js || echo '#!/usr/bin/env node' > dist/cli.js",
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.10.0",
+    "@usebetterdev/audit-core": "workspace:*",
+    "commander": "^12.1.0",
+    "picocolors": "^1.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "tsup": "^8.3.5",
+    "typescript": "~5.7.2",
+    "vitest": "^2.1.6"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}