@comty.io/core 0.1.7 → 0.1.8

package/README.md

@@ -37,12 +37,15 @@ import { initComty } from '@comty.io/core';
 
 await initComty({
   projectKey: 'YOUR_PROJECT_KEY',
-  apiUrl: 'https://YOUR_COMTY_API',
 });
 ```
 
 Call once from your application entry. Server rendering is safe: it does nothing until called in a browser. Repeated calls with the same options reuse the document's instance. Reload the page to change its project or API URL. Register the site's domain in Comty to use shared comments.
 
+The project key is the only required option for hosted Comty. The SDK connects to `https://api.comty.io` by default, including when your application runs on localhost. You do not need an API URL environment variable or your own Comty server. Set `apiUrl` only when using a different Comty API, such as `http://localhost:4000` for developing Comty itself or the URL of a self-hosted installation.
+
+The browser entry also works in production. If Comty should only appear in development or preview, conditionally call `initComty` in your application. To include production, do not guard initialization with a development-only flag. The Vite companion below is a separate development-only integration.
+
 ## Color tokens
 
 Element inspection shows a copyable CSS custom-property name above foreground/background colors when the winning declaration can be identified. It handles ordinary selectors, `:where()`, inline styles, inheritance, `!important`, active media/supports rules and named top-level cascade layers. Semantic aliases retain their declared name. No extra line is rendered for literal colors or uncertain provenance (including inaccessible stylesheets, shadow/scoped or nested cascades, and unsupported functional selectors).
@@ -81,7 +84,7 @@ export default defineConfig({
 });
 ```
 
-Keep your existing plugins. Run your normal dev command and open `http://localhost:<vite-port>`. The plugin injects the SDK and starts the companion automatically. It is disabled for production builds. Choose the installed coding agent with `agent: 'codex' | 'claude' | 'cursor' | 'gemini' | 'grok'`. The optional `model` setting accepts a model ID from the selected agent; omit it to use that agent's default. A project key is optional in local Agent mode; set `projectKey` and `apiUrl` in the plugin options if you also want shared Comty comments.
+Keep your existing plugins. Run your normal dev command and open `http://localhost:<vite-port>`. The plugin injects the SDK and starts the companion automatically. It is disabled for production builds. Choose the installed coding agent with `agent: 'codex' | 'claude' | 'cursor' | 'gemini' | 'grok'`. The optional `model` setting accepts a model ID from the selected agent; omit it to use that agent's default. A project key is optional in local Agent mode; set `projectKey` in the plugin options if you also want shared Comty comments. Set `apiUrl` only for a local or self-hosted Comty API.
 
 ## Other development servers
 

package/comty-sdk.js

@@ -3585,7 +3585,7 @@ function initComty(options = {}) {
     } catch { return Promise.reject(new TypeError("Comty: companion must share the page origin")); }
   }
   const projectKey = options.projectKey || (agent ? "local" : undefined);
-  const apiUrl = options.apiUrl || "http://localhost:4000";
+  const apiUrl = options.apiUrl || "https://api.comty.io";
   if (typeof projectKey !== "string" || !projectKey.trim()) {
     return Promise.reject(new TypeError("Comty: projectKey is required"));
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@comty.io/core",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "Comty visual comments, inspector and local agent tools",
   "type": "module",
   "license": "UNLICENSED",

package/src/browser.d.ts

@@ -1,7 +1,7 @@
 export interface ComtyOptions {
   /** Project key from your Comty dashboard. */
   projectKey?: string;
-  /** Absolute URL of your Comty API. Defaults to http://localhost:4000. */
+  /** Defaults to https://api.comty.io. Override for a local or self-hosted Comty API. */
   apiUrl?: string;
   /** Set automatically by comty dev; not needed in application code. */
   agent?: { url: string; token: string };

package/src/browser.js

@@ -21,7 +21,7 @@ export function initComty(options = {}) {
     } catch { return Promise.reject(new TypeError("Comty: companion must share the page origin")); }
   }
   const projectKey = options.projectKey || (agent ? "local" : undefined);
-  const apiUrl = options.apiUrl || "http://localhost:4000";
+  const apiUrl = options.apiUrl || "https://api.comty.io";
   if (typeof projectKey !== "string" || !projectKey.trim()) {
     return Promise.reject(new TypeError("Comty: projectKey is required"));
   }