@ainyc/canonry 1.0.1 → 1.1.0

package/README.md

@@ -197,6 +197,33 @@ Access it at [http://localhost:4100](http://localhost:4100) after running `canon
 
 - Node.js >= 20
 - At least one provider API key (or a local LLM endpoint)
+- A C++ toolchain for building `better-sqlite3` native bindings (only needed if prebuilt binaries aren't available for your platform)
+
+### Native dependency setup
+
+Canonry uses `better-sqlite3` for its embedded database. Prebuilt binaries are downloaded automatically for most platforms, but if `npm install` fails with a `node-gyp` error, you need to install build tools:
+
+**macOS:**
+```bash
+xcode-select --install
+```
+
+**Debian / Ubuntu:**
+```bash
+sudo apt-get install -y python3 make g++
+```
+
+**Alpine Linux (Docker):**
+```bash
+apk add --no-cache python3 make g++ gcc musl-dev
+```
+
+**Windows:**
+```bash
+npm install -g windows-build-tools
+```
+
+If you're running in a minimal Docker image or CI environment without these tools, the install will fail. See the [better-sqlite3 troubleshooting guide](https://github.com/WiseLibs/better-sqlite3/blob/master/docs/troubleshooting.md) for additional help.
 
 ## Development
 

package/dist/{chunk-ONZDY6Q4.js → chunk-W6AJ2472.js}

@@ -60,6 +60,7 @@ function configExists() {
 }
 
 // src/server.ts
+import { createRequire } from "module";
 import fs2 from "fs";
 import path2 from "path";
 import { fileURLToPath } from "url";
@@ -3507,6 +3508,8 @@ var Notifier = class {
 };
 
 // src/server.ts
+var _require = createRequire(import.meta.url);
+var { version: PKG_VERSION } = _require("../package.json");
 var DEFAULT_QUOTA = {
   maxConcurrency: 2,
   maxRequestsPerMinute: 10,
@@ -3684,7 +3687,7 @@ async function createServer(opts) {
   app.get("/health", async () => ({
     status: "ok",
     service: "canonry",
-    version: "0.1.0"
+    version: PKG_VERSION
   }));
   scheduler.start();
   app.addHook("onClose", async () => {

package/dist/cli.js

@@ -9,7 +9,7 @@ import {
   loadConfig,
   migrate,
   saveConfig
-} from "./chunk-ONZDY6Q4.js";
+} from "./chunk-W6AJ2472.js";
 
 // src/cli.ts
 import { parseArgs } from "util";
@@ -36,11 +36,11 @@ var DEFAULT_QUOTA = {
   maxRequestsPerMinute: 10,
   maxRequestsPerDay: 500
 };
-async function initCommand() {
+async function initCommand(opts) {
   console.log("Initializing canonry...\n");
-  if (configExists()) {
+  if (configExists() && !opts?.force) {
     console.log(`Config already exists at ${getConfigPath()}`);
-    console.log("To reinitialize, delete the config file first.");
+    console.log('To reinitialize, run "canonry init --force".');
     return;
   }
   const configDir = getConfigDir();
@@ -109,13 +109,14 @@ Config saved to ${getConfigPath()}`);
 async function serveCommand() {
   const config = loadConfig();
   const port = parseInt(process.env.CANONRY_PORT ?? "4100", 10);
+  const host = process.env.CANONRY_HOST ?? "127.0.0.1";
   const db = createClient(config.database);
   migrate(db);
   const app = await createServer({ config, db });
   try {
-    await app.listen({ host: "0.0.0.0", port });
+    await app.listen({ host, port });
     console.log(`
-Canonry server running at http://localhost:${port}`);
+Canonry server running at http://${host === "0.0.0.0" ? "localhost" : host}:${port}`);
     console.log("Press Ctrl+C to stop.\n");
   } catch (err) {
     app.log.error(err);
@@ -668,11 +669,12 @@ function printNotification(n) {
 }
 
 // src/cli.ts
+import { createRequire } from "module";
 var USAGE = `
 canonry \u2014 AEO monitoring CLI
 
 Usage:
-  canonry init                        Initialize config and database
+  canonry init [--force]               Initialize config and database
   canonry serve                       Start the local server
   canonry project create <name>       Create a project
   canonry project list                List all projects
@@ -707,6 +709,7 @@ Usage:
 
 Options:
   --port <port>        Server port (default: 4100)
+  --host <host>        Server bind address (default: 127.0.0.1)
   --domain <domain>    Canonical domain for project create
   --country <code>     Country code (default: US)
   --language <lang>    Language code (default: en)
@@ -718,7 +721,8 @@ Options:
   --webhook <url>      Webhook URL for notifications
   --events <list>      Comma-separated notification events
 `.trim();
-var VERSION = "0.1.0";
+var _require = createRequire(import.meta.url);
+var { version: VERSION } = _require("../package.json");
 async function main() {
   const args = process.argv.slice(2);
   if (args.length === 0 || args.includes("--help") || args.includes("-h")) {
@@ -732,18 +736,22 @@ async function main() {
   const command = args[0];
   try {
     switch (command) {
-      case "init":
-        await initCommand();
+      case "init": {
+        const initForce = args.includes("--force") || args.includes("-f");
+        await initCommand({ force: initForce });
         break;
+      }
       case "serve": {
         const { values } = parseArgs({
           args: args.slice(1),
           options: {
-            port: { type: "string", short: "p", default: "4100" }
+            port: { type: "string", short: "p", default: "4100" },
+            host: { type: "string", short: "H" }
           },
           allowPositionals: false
         });
         process.env.CANONRY_PORT = values.port;
+        if (values.host) process.env.CANONRY_HOST = values.host;
         await serveCommand();
         break;
       }

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+import { FastifyInstance } from 'fastify';
+import { DatabaseClient } from '@ainyc/canonry-db';
+import { ProviderQuotaPolicy } from '@ainyc/canonry-contracts';
+
+interface ProviderConfigEntry {
+    apiKey?: string;
+    baseUrl?: string;
+    model?: string;
+    quota?: ProviderQuotaPolicy;
+}
+interface CanonryConfig {
+    apiUrl: string;
+    database: string;
+    apiKey: string;
+    port?: number;
+    geminiApiKey?: string;
+    geminiModel?: string;
+    geminiQuota?: ProviderQuotaPolicy;
+    providers?: {
+        gemini?: ProviderConfigEntry;
+        openai?: ProviderConfigEntry;
+        claude?: ProviderConfigEntry;
+        local?: ProviderConfigEntry;
+    };
+}
+declare function loadConfig(): CanonryConfig;
+
+declare function createServer(opts: {
+    config: CanonryConfig;
+    db: DatabaseClient;
+    open?: boolean;
+}): Promise<FastifyInstance>;
+
+export { type CanonryConfig, createServer, loadConfig };

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   createServer,
   loadConfig
-} from "./chunk-ONZDY6Q4.js";
+} from "./chunk-W6AJ2472.js";
 export {
   createServer,
   loadConfig

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ainyc/canonry",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "type": "module",
   "license": "AGPL-3.0-only",
   "bin": {
@@ -8,16 +8,16 @@
   },
   "exports": {
     ".": {
-      "types": "./src/index.ts",
+      "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     }
   },
-  "types": "./src/index.ts",
+  "types": "./dist/index.d.ts",
   "files": [
     "bin/",
     "dist/",
     "assets/",
-    "src/",
+    "package.json",
     "README.md"
   ],
   "engines": {
@@ -31,7 +31,7 @@
     "drizzle-orm": "^0.45.1",
     "fastify": "^5.4.0",
     "node-cron": "^4.2.1",
-    "openai": "^4.85.0",
+    "openai": "^6.0.0",
     "pino-pretty": "^13.1.3",
     "yaml": "^2.7.1",
     "zod": "^4.1.12"
@@ -43,11 +43,11 @@
     "tsx": "^4.19.0",
     "@ainyc/canonry-api-routes": "0.0.0",
     "@ainyc/canonry-contracts": "0.0.0",
-    "@ainyc/canonry-db": "0.0.0",
-    "@ainyc/canonry-provider-gemini": "0.0.0",
     "@ainyc/canonry-provider-claude": "0.0.0",
+    "@ainyc/canonry-provider-gemini": "0.0.0",
+    "@ainyc/canonry-provider-local": "0.0.0",
     "@ainyc/canonry-provider-openai": "0.0.0",
-    "@ainyc/canonry-provider-local": "0.0.0"
+    "@ainyc/canonry-db": "0.0.0"
   },
   "scripts": {
     "build": "tsup && tsx build-web.ts",