@usebetterdev/audit-cli 0.4.0-beta.1 → 0.4.0-beta.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 usebetter
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/cli.js

@@ -1,39 +1 @@
 #!/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usebetterdev/audit-cli",
-  "version": "0.4.0-beta.1",
+  "version": "0.4.0-beta.3",
   "repository": "github:usebetter-dev/usebetter",
   "bugs": "https://github.com/usebetter-dev/usebetter/issues",
   "homepage": "https://github.com/usebetter-dev/usebetter#readme",
@@ -14,18 +14,14 @@
     "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"
-  },
+  "files": [
+    "dist"
+  ],
   "dependencies": {
     "@clack/prompts": "^0.10.0",
-    "@usebetterdev/audit-core": "workspace:*",
     "commander": "^12.1.0",
-    "picocolors": "^1.1.0"
+    "picocolors": "^1.1.0",
+    "@usebetterdev/audit-core": "0.4.0-beta.3"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",
@@ -35,5 +31,10 @@
   },
   "engines": {
     "node": ">=22"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
   }
-}
+}

package/dist/check.d.ts

@@ -1,17 +0,0 @@
-/**
- * `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

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

package/dist/check.js.map

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

package/dist/chunk-2G3BRX4J.js

@@ -1,12 +0,0 @@
-#!/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

@@ -1 +0,0 @@
-{"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

@@ -1,12 +0,0 @@
-#!/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

@@ -1 +0,0 @@
-{"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

@@ -1,12 +0,0 @@
-#!/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

@@ -1 +0,0 @@
-{"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

@@ -1,16 +0,0 @@
-#!/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

@@ -1 +0,0 @@
-{"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

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

package/dist/cli.js.map

@@ -1 +0,0 @@
-{"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

@@ -1,19 +0,0 @@
-/**
- * `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

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

package/dist/migrate.js.map

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

package/dist/purge.d.ts

@@ -1,15 +0,0 @@
-/**
- * `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

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

package/dist/purge.js.map

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

package/dist/stats.d.ts

@@ -1,19 +0,0 @@
-/**
- * `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

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

package/dist/stats.js.map

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