@drift-beacon/plugin 0.1.0 → 0.1.1

package/dist/cli.js

@@ -1,11 +1,3 @@
-/**
- * `dbplugin` (Drift Beacon plugins), run through `bin/dbplugin.js`:
- *
- *   dbplugin prepare [root]              Generate .drift-beacon/ (config types and tsconfigs). Lenient: a manifest
- *                                   problem only warns, because this runs as the plugin's postinstall.
- *   dbplugin pack [root] [--out <dir>]   Typecheck, build fresh and write <out>/<id>.zip (default releases/).
- *                                   Prints only the result JSON on stdout.
- */
 import path from "node:path";
 import { parseArgs } from "node:util";
 import { pack } from "./pack.js";

package/dist/dev.js

@@ -1,8 +1 @@
-/**
- * The `pnpm dev` handshake between `driftBeacon()` and the Drift Beacon server. The dev tool writes a
- * marker into the package's `dist/`; the server polls for it, connects to Vite's HMR socket and trusts
- * the socket only after a `welcome` whose `session` equals the marker's. Messages travel as Vite custom
- * events (`{ type: "custom", event, data }`). All wording is rendered on the server; the tool only prints.
- */
-/** File name of the marker in `dist/`. Written as tmp, then renamed, synchronously. Never packed. */
 export const DEV_MARKER = ".drift-beacon-dev.json";

package/dist/errors.js

@@ -1,4 +1,3 @@
-/** Rejection from a platform operation. Check `code` rather than `instanceof`, which differs between SDK copies. */
 export class PluginError extends Error {
     code;
     constructor(code, message) {

package/dist/index.js

@@ -1,8 +1,3 @@
-/**
- * Drift Beacon plugin SDK: the API for main code (runs on the server). Plugin UIs import from `@drift-beacon/plugin/ui`.
- *
- * At run time the plugin host supplies this module, so `driftBeacon()` keeps it external when building main.
- */
 export { PluginError } from "./errors.js";
 export { definePlugin } from "./main.js";
 export { API_VERSION } from "./version.js";

package/dist/internal/collection.js

@@ -7,10 +7,6 @@ function deepFreeze(value) {
     }
     return value;
 }
-/**
- * A collection of plain rows keyed by id, frozen as they arrive. `replace` applies a full set of rows, keeps the
- * object of every unchanged row (so identity only changes when data does) and reports the changes.
- */
 export class Collection {
     rows = new Map();
     cachedList = null;

package/dist/internal/compatibility.js

@@ -1,12 +1,6 @@
 import { API_VERSION } from "../version.js";
-/**
- * API versions this build of Drift Beacon runs: the newest minor of each supported major.
- * Before 1.0 only the current version is listed, because every 0.x minor may break plugins.
- * From 1.0, the previous major stays listed for at least six months after its successor ships.
- */
 export const SUPPORTED_API_VERSIONS = [API_VERSION];
 const API_VERSION_PATTERN = /^(0|[1-9]\d*)\.(0|[1-9]\d*)$/;
-/** Parse a `major.minor` API version; null when malformed. */
 export function parseApiVersion(value) {
     if (typeof value !== "string")
         return null;
@@ -15,11 +9,6 @@ export function parseApiVersion(value) {
         return null;
     return { major: Number(match[1]), minor: Number(match[2]) };
 }
-/**
- * Whether a plugin built for `pluginVersion` runs on a build supporting `supported`.
- * Before 1.0 the minor must match exactly; from 1.0 the major must match and the plugin's
- * minor must not be newer than the host's.
- */
 export function checkApiCompatibility(pluginVersion, supported = SUPPORTED_API_VERSIONS) {
     const plugin = parseApiVersion(pluginVersion);
     if (!plugin) {

package/dist/internal/json-equal.js

@@ -1,4 +1,3 @@
-/** Structural equality for JSON-shaped values such as data rows and storage items. */
 export function jsonEqual(a, b) {
     if (a === b)
         return true;

package/dist/internal/manifest.js

@@ -3,7 +3,6 @@ const STABLE_VERSION = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:\+[0-9A-Za-z
 export const isStableVersion = (value) => typeof value === "string" &&
     STABLE_VERSION.test(value) &&
     (value.split("+")[0] ?? "").split(".").every((part) => Number.isSafeInteger(Number(part)));
-/** Throws a readable error when `manifest` is not a valid plugin manifest. Shared by the server and the pack tool. */
 export function validateManifest(manifest) {
     if (!manifest || typeof manifest !== "object" || Array.isArray(manifest))
         throw new Error("Invalid plugin manifest");

package/dist/internal/models.js

@@ -1,14 +1,3 @@
-/**
- * The models plugins see: `Activity`, `Category` and `Session` objects over the workspace rows.
- *
- * One `WorkspaceModels` per `ctx`. The plugin host builds it for main code; the UI client builds it
- * inside every UI bundle, so this file is part of the UI wire contract: change it only additively
- * within an API version.
- *
- * Every read goes to the latest snapshot in the collections, synchronously. Nothing is applied ahead
- * of a snapshot. Lists are computed once per snapshot, so they keep their identity until the data
- * changes.
- */
 import { PluginError } from "../errors.js";
 const ACTIVITY_FIELDS = [
     "id",
@@ -43,10 +32,6 @@ const SESSION_FIELDS = [
 ];
 const gone = (what) => Promise.reject(new PluginError("not-found", `${what} no longer exists`));
 const compareText = (a, b) => (a < b ? -1 : a > b ? 1 : 0);
-/**
- * Give a model its data fields as enumerable getters, so spreading, `JSON.stringify` and
- * `postMessage` copy the current values, then freeze it.
- */
 function seal(model, fields, data) {
     for (const field of fields) {
         Object.defineProperty(model, field, { enumerable: true, get: () => data()[field] });
@@ -170,11 +155,9 @@ export class WorkspaceModels {
     #activities = new Map();
     #categories = new Map();
     #sessions = new Map();
-    /** The last row seen for each id, so a model whose row was removed keeps its values. */
     #lastActivity = new Map();
     #lastCategory = new Map();
     #lastSession = new Map();
-    /** Session rows with `Date` fields, one per row version. Built per `ctx`: a `Date` can't be frozen. */
     #sessionData = new WeakMap();
     #lists = new Map();
     #listsSnapshot = [];
@@ -183,7 +166,6 @@ export class WorkspaceModels {
         this.rows = options.rows;
         this.#actions = options.actions;
     }
-    /** The reads and actions for `ctx`. */
     apis() {
         return {
             activities: {
@@ -205,9 +187,6 @@ export class WorkspaceModels {
             },
         };
     }
-    // --------------------------------------------------------------------------
-    // Reads
-    // --------------------------------------------------------------------------
     activity(id) {
         return this.rows.activities.get(id) ? this.#activityModel(id) : undefined;
     }
@@ -217,7 +196,6 @@ export class WorkspaceModels {
     session(id) {
         return this.rows.sessions.get(id) ? this.#sessionModel(id) : undefined;
     }
-    /** In the app's order: by category (uncategorized last), then `sortOrder`, then name. */
     activities(filter = {}) {
         const { categoryId, trackingType, includeArchived = false } = filter;
         const key = {
@@ -241,13 +219,11 @@ export class WorkspaceModels {
                 .map((row) => this.#activityModel(row.id));
         });
     }
-    /** By `sortOrder`, then name. */
     categories() {
         return this.#list({ list: "categories" }, () => [...this.rows.categories.list()]
             .sort((a, b) => a.sortOrder - b.sortOrder || compareText(a.name, b.name) || compareText(a.id, b.id))
             .map((row) => this.#categoryModel(row.id)));
     }
-    /** Newest first. */
     sessions(filter = {}) {
         const { activityId, status, mine = false } = filter;
         return this.#list({ list: "sessions", activityId, status, mine }, () => this.rows.sessions
@@ -259,9 +235,6 @@ export class WorkspaceModels {
             .sort((a, b) => b.at - a.at || compareText(a.row.id, b.row.id))
             .map(({ row }) => this.#sessionModel(row.id)));
     }
-    // --------------------------------------------------------------------------
-    // Actions
-    // --------------------------------------------------------------------------
     async start(activityId) {
         return this.#result(await this.#actions.start(activityId));
     }
@@ -274,10 +247,6 @@ export class WorkspaceModels {
     async discard(sessionId) {
         await this.#actions.discard(sessionId);
     }
-    // --------------------------------------------------------------------------
-    // Deliveries
-    // --------------------------------------------------------------------------
-    /** Turn the row changes of a snapshot into model changes. Call it after the collections were replaced. */
     update(changes) {
         return {
             activities: changes.activities.map((change) => this.#change(change, this.#lastActivity, (id) => this.#activityModel(id), (row) => row)),
@@ -285,18 +254,11 @@ export class WorkspaceModels {
             sessions: changes.sessions.map((change) => this.#change(change, this.#lastSession, (id) => this.#sessionModel(id), (row) => this.#toSessionData(row))),
         };
     }
-    /**
-     * The model for a session the app sent outside a snapshot (a live event or an action result):
-     * the snapshot's model, or, when the row isn't in the snapshot, a removed model holding these values.
-     */
     sessionFrom(row) {
         if (!this.rows.sessions.get(row.id))
             this.#lastSession.set(row.id, row);
         return this.#sessionModel(row.id);
     }
-    // --------------------------------------------------------------------------
-    // Rows, for the models
-    // --------------------------------------------------------------------------
     activityRow(id) {
         return latest(this.rows.activities.get(id), this.#lastActivity, id);
     }
@@ -306,9 +268,6 @@ export class WorkspaceModels {
     sessionData(id) {
         return this.#toSessionData(latest(this.rows.sessions.get(id), this.#lastSession, id));
     }
-    // --------------------------------------------------------------------------
-    // Internals
-    // --------------------------------------------------------------------------
     #activityModel(id) {
         let model = this.#activities.get(id);
         if (!model) {
@@ -357,7 +316,6 @@ export class WorkspaceModels {
             throw new PluginError("failed", "Drift Beacon did not return the session");
         return this.sessionFrom(value);
     }
-    /** A list computed once per snapshot: the same frozen array until any collection changes. */
     #list(key, compute) {
         const snapshot = [this.rows.activities.list(), this.rows.categories.list(), this.rows.sessions.list()];
         if (snapshot.some((list, index) => list !== this.#listsSnapshot[index])) {
@@ -373,7 +331,6 @@ export class WorkspaceModels {
         return list;
     }
 }
-/** The row in the snapshot, remembered as the last one seen; otherwise the last one seen. */
 function latest(row, last, id) {
     if (row !== undefined) {
         if (last.get(id) !== row)

package/dist/internal/package-layout.js

@@ -1,8 +1,3 @@
-/**
- * The plugin package: `manifest.json`, `package.json`, `main/index.js` (plus chunks) and `ui/index.html`
- * (plus assets and the manifest icon). Shared by the pack tool and the server. Pure: the web app bundles
- * `/internal`, so no `node:` imports.
- */
 export const PACKAGE_LIMITS = {
     entries: 2000,
     fileBytes: 32 * 2 ** 20,
@@ -10,10 +5,8 @@ export const PACKAGE_LIMITS = {
     archiveBytes: 32 * 2 ** 20,
     manifestBytes: 256 * 2 ** 10,
 };
-/** The `package.json` every package gets: main is ESM. */
 export const PACKAGE_JSON = { type: "module", private: true };
 export const REQUIRED_FILES = ["main/index.js", "ui/index.html"];
-/** manifest.json, package.json, main/** and ui/** (directories: main, ui and below). `name` has no trailing slash. */
 export const isPackagePath = (name, directory) => name.startsWith("main/") ||
     name.startsWith("ui/") ||
     (directory ? name === "main" || name === "ui" : name === "manifest.json" || name === "package.json");

package/dist/internal/protocol.js

@@ -1,4 +1,3 @@
-/** Marks our messages so both sides ignore unrelated `postMessage` traffic (dev tools, HMR). */
 export const UI_CHANNEL = "drift-beacon-plugin";
 export function isUiMessage(value) {
     return (typeof value === "object" &&

package/dist/main.js

@@ -1,14 +1,3 @@
-/**
- * Define a plugin's main code. Export the result as the module's default export:
- *
- * ```ts
- * export default definePlugin({
- *   onStart(ctx) {
- *     ctx.mqtt.subscribe(ctx.config.mqttTopic, (message) => ctx.log.info(message.payload));
- *   },
- * });
- * ```
- */
 export function definePlugin(definition) {
     return definition;
 }

package/dist/pack.js

@@ -6,10 +6,6 @@ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExte
     }
     return path;
 };
-/**
- * Release packaging. `packDirectory` zips a finished package folder (`dbplugin pack` and the server's
- * `plugin:install`); `pack` typechecks a plugin package, builds it fresh into a temp folder and packs that.
- */
 import { spawnSync } from "node:child_process";
 import { existsSync } from "node:fs";
 import { lstat, mkdir, mkdtemp, readdir, readFile, rm, writeFile } from "node:fs/promises";
@@ -20,10 +16,6 @@ import { pathToFileURL } from "node:url";
 import { strToU8, zipSync } from "fflate";
 import { PACKAGE_JSON, PACKAGE_LIMITS, REQUIRED_FILES } from "./internal/package-layout.js";
 import { loadManifest, prepare } from "./prepare.js";
-/**
- * Zip the package in `dir` into `<outDir>/<id>.zip`: its manifest, a generated `package.json`, and `main/**`
- * and `ui/**`. Anything else in `dir` (the dev marker, its `package.json`) is left out. Never runs plugin code.
- */
 export async function packDirectory(dir, outDir) {
     const source = path.resolve(dir);
     const { manifest, bytes: manifestBytes } = loadManifest(source);
@@ -87,12 +79,6 @@ export async function packDirectory(dir, outDir) {
     await writeFile(archivePath, archive);
     return { id: manifest.id, version: manifest.version, tag: `${manifest.id}-${manifest.version}`, asset, archivePath };
 }
-/**
- * Build a release of the plugin package at `root`: prepare, typecheck main and UI with the package's own
- * TypeScript, `vite build` into a fresh temp folder with the package's own Vite, then `packDirectory`. The
- * package's `dist/` is never read or written. Everything printed meanwhile goes to stderr, so a caller's
- * stdout carries only the result.
- */
 export async function pack(root, options = {}) {
     const pkg = path.resolve(root);
     const write = process.stdout.write;
@@ -101,7 +87,6 @@ export async function pack(root, options = {}) {
     try {
         prepare(pkg, { strict: true });
         const require = createRequire(path.join(pkg, "package.json"));
-        // Found through its package.json `bin`: TypeScript 7 doesn't export `typescript/bin/tsc`.
         const typescript = require.resolve("typescript/package.json");
         const { bin } = JSON.parse(await readFile(typescript, "utf8"));
         const tsc = path.join(path.dirname(typescript), bin.tsc);

package/dist/prepare.js

@@ -1,8 +1,3 @@
-/**
- * Writes a plugin package's generated `.drift-beacon/` folder: `config.d.ts` (the `ctx.config` types from
- * manifest.json), the main and UI tsconfigs, and a `.gitignore` that ignores the folder itself. Also reads
- * and checks manifests for `driftBeacon()` and `dbplugin pack` (`loadManifest`).
- */
 import { existsSync, lstatSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import { checkApiCompatibility } from "./internal/compatibility.js";
@@ -22,7 +17,6 @@ const COMPILER_OPTIONS = {
     noFallthroughCasesInSwitch: true,
     noUncheckedSideEffectImports: true,
 };
-// Explicit `types` keep UI typings (React, three.js) out of main; `vite/client` allows CSS and asset imports in the UI.
 const TSCONFIG_MAIN = {
     compilerOptions: { ...COMPILER_OPTIONS, lib: ["ES2023"], types: ["node"] },
     include: ["../main/src", "../vite.config.ts", "./config.d.ts"],
@@ -57,11 +51,6 @@ export function prepare(root, { strict }) {
     writeIfChanged(path.join(out, "tsconfig.ui.json"), `${JSON.stringify(TSCONFIG_UI, null, 2)}\n`);
     return loaded;
 }
-/**
- * `<root>/manifest.json`, the one read of a manifest in the SDK (dev, build, prepare and pack): a regular
- * file within the package limit, valid, and for an `apiVersion` this SDK runs (the server's check). The
- * error names the file.
- */
 export function loadManifest(root) {
     const file = path.join(root, "manifest.json");
     let manifest;
@@ -85,12 +74,6 @@ export function loadManifest(root) {
         throw new Error(`${file}: ${compatibility.message}`);
     return { manifest, bytes };
 }
-/**
- * Augments the SDK's `PluginConfig`. Mirrors the server's config validation: a setting can be missing
- * unless it is required or has a default. The type-only import makes this a module, so `declare module`
- * augments instead of declaring an ambient module, and it loads the SDK entry into every program: the UI
- * imports only `@drift-beacon/plugin/ui`, and an augmentation of a module the program never loads has no effect.
- */
 function configTypes(configuration) {
     const lines = [
         "// Generated by dbplugin prepare from manifest.json. Do not edit.",
@@ -113,7 +96,6 @@ const valueType = (item) => item.type !== "dropdown"
     : item.data.length === 0
         ? "string"
         : [...new Set(item.data.map((option) => JSON.stringify(option.value)))].join(" | ");
-/** Leaves the file (and its mtime) alone when it already has `content`, so editors and watchers stay quiet. */
 function writeIfChanged(file, content) {
     if (existsSync(file) && readFileSync(file, "utf8") === content)
         return;

package/dist/types.js

@@ -1,10 +1 @@
-/**
- * Data and APIs shared by plugin main code (server) and UIs (iframe).
- *
- * Workspace data comes as models: an `Activity`, `Category` or `Session` with its fields, links,
- * derived values and actions. Models read the latest snapshot the app sent, synchronously; there is
- * one model per row for the life of a `ctx`, and `model.data` is its plain, frozen row. Later API
- * versions may add fields and new values to string unions such as `trackingType`, so plugins must
- * ignore what they don't recognise.
- */
 export {};

package/dist/ui.js

@@ -1,11 +1,3 @@
-/**
- * The UI client: runs inside a plugin's iframe and talks to the Drift Beacon web app.
- *
- * ```ts
- * const ctx = await connect();
- * ctx.onDataChange(render);
- * ```
- */
 import { PluginError } from "./errors.js";
 import { Collection } from "./internal/collection.js";
 import { jsonEqual } from "./internal/json-equal.js";
@@ -17,7 +9,6 @@ export { API_VERSION } from "./version.js";
 const HELLO_INTERVAL_MS = 250;
 const REQUEST_TIMEOUT_MS = 10_000;
 let connection = null;
-/** Connect to the Drift Beacon web app. Resolves once the app accepts this UI; later calls return the same context. */
 export function connect(options = {}) {
     connection ??= open(options.timeoutMs ?? 10_000);
     return connection;
@@ -59,7 +50,6 @@ function open(timeoutMs) {
         };
         window.addEventListener("message", onMessage);
         const sayHello = () => post({ channel: UI_CHANNEL, type: "hello", apiVersion: API_VERSION });
-        // Repeat until answered: the app may still be setting up when the UI first loads.
         const hello = setInterval(sayHello, HELLO_INTERVAL_MS);
         sayHello();
         const timeout = setTimeout(() => {
@@ -86,12 +76,7 @@ class UiClient {
     storageListeners = new Set();
     storage = new Map();
     serverStorage;
-    /** Keys with writes the app hasn't answered; older pushes must not revert them. */
     pendingWrites = new Map();
-    /**
-     * Keys written since the app last sent storage, with the latest write's ID. The app may answer a
-     * write before its next push, so an answered write stays in place until that push arrives.
-     */
     writesSincePush = new Map();
     nextWrite = 0;
     pending = new Map();
@@ -140,7 +125,6 @@ class UiClient {
     }
     receive(message) {
         if (message.type === "welcome") {
-            // A reconnect: identity is unchanged, so only the state is new.
             this.receive({
                 channel: message.channel,
                 type: "state",
@@ -174,7 +158,6 @@ class UiClient {
         }
         notify(this.dataListeners, (listener) => listener());
     }
-    /** Replace all three collections before telling anyone, so callbacks see one consistent snapshot. */
     applyData(data) {
         const changes = this.models.update({
             activities: this.rows.activities.replace(data.activities),
@@ -188,7 +171,6 @@ class UiClient {
         for (const change of changes.sessions)
             notify(this.sessionListeners, (listener) => listener(change));
     }
-    /** Apply the app's storage, keeping local values for keys with unconfirmed writes. Returns whether anything changed. */
     reconcileStorage() {
         const isProtected = (key) => this.pendingWrites.has(key) || this.writesSincePush.has(key);
         const next = new Map();
@@ -225,7 +207,6 @@ class UiClient {
                 : { method: "storage.set", params: { key, value } });
         }
         catch (error) {
-            // Roll back to the app's value, unless a later local write replaced this one.
             if (this.writesSincePush.get(key) === writeId)
                 this.writesSincePush.delete(key);
             throw error;

package/dist/version.js

@@ -1,5 +1 @@
-/**
- * The plugin API version this SDK describes, `major.minor`. It matches the package version's
- * major and minor. Before 1.0 every minor version may break plugins.
- */
 export const API_VERSION = "0.1";

package/dist/vite.js

@@ -6,18 +6,6 @@ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExte
     }
     return path;
 };
-/**
- * `driftBeacon()` (`@drift-beacon/plugin/vite`): the Vite plugin of a plugin package. The UI is the author's
- * own Vite app rooted at `ui/`; this plugin builds main next to it, so `dist/` is exactly the release package.
- *
- * `vite build` builds main once the UI is written. `vite` (`pnpm dev`) serves the UI with HMR, watch-builds main
- * into `dist/` and keeps the manifest, the icon and the config types in sync. It writes a marker (dev.ts) that
- * the Drift Beacon server polls; the server then connects to Vite's HMR socket and sends lines to print here.
- *
- * Through `link:`, a bare `vite` import from here would resolve to Cartridge's copy, whose types never match
- * another copy's. So vite is only a type here: at run time the plugin loads the project's own vite, and the
- * public signature names no vite type.
- */
 import { createHash, randomUUID } from "node:crypto";
 import { existsSync, mkdirSync, readdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import { createRequire } from "node:module";
@@ -27,12 +15,7 @@ import { stripVTControlCharacters, styleText } from "node:util";
 import { DEV_MARKER } from "./dev.js";
 import { PACKAGE_JSON } from "./internal/package-layout.js";
 import { prepare } from "./prepare.js";
-/** How long `pnpm dev` waits for a Drift Beacon server before saying how to connect one. */
 const HINT_DELAY_MS = 5_000;
-/**
- * The Vite plugin for a Drift Beacon plugin package: `plugins: [driftBeacon()]`. It owns `root`, `base` and
- * `build.outDir`. Typed as `{ name: string }` so it fits any Vite version's `plugins`.
- */
 export function driftBeacon() {
     let pkg = "";
     let dist = "";
@@ -44,7 +27,6 @@ export function driftBeacon() {
             if (env.isPreview)
                 return;
             pkg = path.resolve(config.root ?? process.cwd());
-            // Read, not assumed: `dbplugin pack` redirects the whole build into a temp folder through `build.outDir`.
             dist = config.build?.outDir ? path.resolve(pkg, config.build.outDir) : path.join(pkg, "dist");
             for (const file of ["ui/index.html", "main/src/index.ts"]) {
                 if (!existsSync(path.join(pkg, file)))
@@ -55,14 +37,11 @@ export function driftBeacon() {
                 throw new Error("driftBeacon(): a custom server.hmr port or path is not supported");
             }
             ({ manifest, bytes: manifestBytes } = prepare(pkg, { strict: true }));
-            // `dist/ui` is outside the root `ui/`, so Vite only empties it when asked to.
             return { root: path.join(pkg, "ui"), base: "./", build: { outDir: path.join(dist, "ui"), emptyOutDir: true } };
         },
-        // `vite` (`pnpm dev`). A Vite restart creates the new server before closing the old one: both share the state.
         configureServer(server) {
             serveDev(server, devStates.get(pkg) ?? startDev(pkg, dist, manifest, manifestBytes, server.config.logger));
         },
-        // `vite build` (and `dbplugin pack`). Runs after the UI is written (and Vite has copied `ui/public/` into `dist/ui/`).
         async writeBundle() {
             const vite = await loadVite(pkg);
             await vite.build(mainBuild(vite, pkg, { outDir: path.join(dist, "main"), minify: true, sourcemap: false, logLevel: "warn" }));
@@ -73,16 +52,12 @@ export function driftBeacon() {
     };
     return plugin;
 }
-/** The project's own vite: through `link:`, a bare import would resolve to the SDK's copy. */
 const loadVite = async (pkg) => import(__rewriteRelativeImportExtension(pathToFileURL(createRequire(path.join(pkg, "package.json")).resolve("vite")).href));
-/** Main as one ESM file, with every dependency bundled except the SDK, which the plugin host supplies. */
 function mainBuild(vite, pkg, options) {
-    // One file on both Vite 7 (Rollup) and Vite 8 (Rolldown, which deprecates `inlineDynamicImports`).
     const single = "rolldownVersion" in vite ? { codeSplitting: false } : { inlineDynamicImports: true };
     return {
         configFile: false,
         root: pkg,
-        // Vite copies publicDir in every build: a stray `<pkg>/public/` must not reach `dist/main/`.
         publicDir: false,
         logLevel: options.logLevel,
         build: {
@@ -101,13 +76,10 @@ function mainBuild(vite, pkg, options) {
         ssr: { noExternal: true },
     };
 }
-// On globalThis, so the state survives whatever reloads this module; keyed by package root, so one process
-// (a test file) can serve several roots.
 const DEV_STATES = Symbol.for("drift-beacon.dev");
 const shared = globalThis;
 shared[DEV_STATES] ??= new Map();
 const devStates = shared[DEV_STATES];
-/** Once per root: seed `dist/` and start the main watch build. */
 function startDev(pkg, dist, manifest, bytes, logger) {
     writeAtomic(path.join(dist, "manifest.json"), bytes);
     writeAtomic(path.join(dist, "package.json"), `${JSON.stringify(PACKAGE_JSON, null, 2)}\n`);
@@ -133,16 +105,11 @@ function startDev(pkg, dist, manifest, bytes, logger) {
     });
     return state;
 }
-/**
- * Builds main into `.drift-beacon/main-next/` on every save, then moves the files into `dist/main/`: never a
- * half-written bundle in `dist/`, and at the same depth, so the map's relative sources still resolve.
- */
 async function watchMain(state) {
     const vite = await loadVite(state.pkg);
     const staging = path.join(state.pkg, ".drift-beacon/main-next");
     const options = { outDir: staging, minify: false, sourcemap: true, watch: {}, logLevel: "silent" };
     const watcher = (await vite.build(mainBuild(vite, state.pkg, options)));
-    // Vite closes each event's bundle itself.
     watcher.on("event", (event) => {
         if (event.code === "BUNDLE_END") {
             try {
@@ -158,7 +125,6 @@ async function watchMain(state) {
             }
         }
         else if (event.code === "ERROR") {
-            // dist/ is untouched, so the server keeps the last good build.
             const reason = shorten(state, event.error.message).replaceAll(/\n\s*\n/g, "\n");
             print(state.logger, {
                 level: "error",
@@ -168,13 +134,11 @@ async function watchMain(state) {
     });
     return watcher;
 }
-/** Per dev server: the manifest and icon watchers, the marker, and the server's socket. */
 function serveDev(server, state) {
     state.servers += 1;
     state.logger = server.config.logger;
     const manifestFile = path.join(state.pkg, "manifest.json");
     server.watcher.add(manifestFile);
-    // Vite already watches its root `ui/`, so the icon's changes arrive here too.
     server.watcher.on("all", (event, file) => {
         if (file === manifestFile && event !== "unlink")
             updateManifest(state);
@@ -183,7 +147,6 @@ function serveDev(server, state) {
     });
     server.httpServer?.on("listening", () => {
         state.uiUrl = server.resolvedUrls?.local[0] ?? null;
-        // Even before main has built: the server can connect and serve the UI meanwhile.
         writeDevMarker(state);
         clearTimeout(state.hint);
         state.hint = setTimeout(() => {
@@ -191,7 +154,6 @@ function serveDev(server, state) {
                 print(state.logger, { level: "warn", text: noServerHint(state) });
         }, HINT_DELAY_MS).unref();
     });
-    // On the dev server's own close: its http server emits "close" only if it listened, and has none in middleware mode.
     const close = server.close.bind(server);
     let open = true;
     server.close = () => {
@@ -201,12 +163,11 @@ function serveDev(server, state) {
         }
         return close();
     };
-    // Vite custom events over the HMR socket. Never `server.ws.send`: it broadcasts, plugin iframes included.
     server.ws.on("drift-beacon:hello", (data, client) => {
         if (data?.session !== state.session)
             return;
         const welcome = { v: 1, session: state.session, pluginId: state.manifest.id };
-        client.send("drift-beacon:welcome", welcome); // this socket only
+        client.send("drift-beacon:welcome", welcome);
         clearTimeout(state.hint);
         const { socket } = client;
         state.socket = socket;
@@ -222,7 +183,6 @@ function serveDev(server, state) {
             print(state.logger, data);
     });
 }
-/** One dev server closed: the last one for the root stops the main watch build and forgets the root. */
 function release(state) {
     if (--state.servers > 0)
         return;
@@ -231,16 +191,13 @@ function release(state) {
         devStates.delete(state.pkg);
     void state.watcher.then((watcher) => watcher?.close());
 }
-/** A saved manifest: checked, copied, and its config types and icon refreshed. An invalid one keeps the old copy. */
 function updateManifest(state) {
     try {
         const { manifest, bytes } = prepare(state.pkg, { strict: true });
-        // A missing icon was already reported under its name; say it again only for a new name.
         const renamed = manifest.icon !== state.manifest.icon;
         state.manifest = manifest;
         state.manifestBytes = bytes;
         syncIcon(state, renamed);
-        // Copies the manifest.
         writeDevMarker(state);
     }
     catch (error) {
@@ -250,7 +207,6 @@ function updateManifest(state) {
         });
     }
 }
-/** Copies the manifest icon from `ui/public/` into `dist/ui/` (Vite does it in a build), or removes a deleted one. */
 function syncIcon(state, warnMissing) {
     const { icon } = state.manifest;
     if (!icon)
@@ -275,7 +231,6 @@ function syncIcon(state, warnMissing) {
         });
     }
 }
-/** Moves every staged file into `to`, maps first and `index.js` last, so the new index.js never meets an old map. */
 function moveFiles(from, to) {
     const rank = (file) => (file === "index.js" ? 2 : file.endsWith(".map") ? 0 : 1);
     const files = readdirSync(from, { recursive: true, withFileTypes: true })
@@ -287,10 +242,6 @@ function moveFiles(from, to) {
         renameSync(path.join(from, file), path.join(to, file));
     }
 }
-/**
- * Writes the dev marker for what is in `dist/` now; true when its build id changed. The manifest, `package.json`
- * and a missing icon are written first, so a `dist/` deleted while `pnpm dev` runs is whole again.
- */
 function writeDevMarker(state) {
     writeAtomic(path.join(state.dist, "manifest.json"), state.manifestBytes);
     writeAtomic(path.join(state.dist, "package.json"), `${JSON.stringify(PACKAGE_JSON, null, 2)}\n`);
@@ -307,7 +258,6 @@ const noServerHint = (state) => [
     `The server connects when it finds dist/${DEV_MARKER} in a folder directly`,
     `under its DEV_PLUGINS_PATH. Run it in development mode with DEV_PLUGINS_PATH=${path.dirname(state.pkg)}`,
 ].join("\n");
-/** Plain text with package paths made relative, for messages that come from Vite or the file system. */
 const shorten = (state, text) => stripVTControlCharacters(text).replaceAll(`${state.pkg}${path.sep}`, "").trim();
 const TIME = new Intl.DateTimeFormat(undefined, { hour: "numeric", minute: "numeric", second: "numeric" });
 const STYLES = {
@@ -316,11 +266,6 @@ const STYLES = {
     warn: "yellow",
     error: "red",
 };
-/**
- * Prints a line (from the server, or about the local build) through Vite's logger, timed like Vite's own lines
- * but tagged `[beacon]` (Vite's `timestamp` option would tag it `[vite]`). The first line is coloured by level;
- * the others are dimmed and indented under it.
- */
 function print(logger, { level, text }) {
     const time = TIME.format(new Date());
     const [first = "", ...rest] = String(text).split("\n");
@@ -336,21 +281,12 @@ function print(logger, { level, text }) {
     else
         logger.info(message);
 }
-// ============================================================================
-// Shared
-// ============================================================================
-/** Writes the marker for what is in `dist/` now and returns its build id. */
 function writeMarker(dist, { pluginId, session, uiUrl }) {
     const buildId = hashDist(dist);
-    // The HMR socket shares the UI's host and port; a relative base serves it at `/`.
     const marker = { v: 1, pluginId, buildId, session, uiUrl, wsUrl: uiUrl?.replace(/^http/, "ws") ?? null };
     writeAtomic(path.join(dist, DEV_MARKER), `${JSON.stringify(marker, null, 2)}\n`);
     return buildId;
 }
-/**
- * The build id: sha256 of what the server loads, first 16 hex characters. Null until main is built. It
- * covers `ui/index.html` so a UI-only build still refreshes an open static UI.
- */
 function hashDist(dist) {
     if (!existsSync(path.join(dist, "main/index.js")))
         return null;
@@ -362,7 +298,6 @@ function hashDist(dist) {
     }
     return hash.digest("hex").slice(0, 16);
 }
-/** Writes through a temporary file and a rename, so the server never reads a partial file. */
 function writeAtomic(file, content) {
     mkdirSync(path.dirname(file), { recursive: true });
     writeFileSync(`${file}.tmp`, content);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drift-beacon/plugin",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "The Drift Beacon plugin SDK: APIs for plugin main code and UIs, the driftBeacon() Vite plugin and the dbplugin CLI",
   "license": "MIT",
   "author": {
@@ -38,8 +38,15 @@
   },
   "files": [
     "bin",
-    "dist",
-    "!dist/**/*.map"
+    "dist/**/*.js",
+    "!dist/internal.js",
+    "dist/index.d.ts",
+    "dist/ui.d.ts",
+    "dist/vite.d.ts",
+    "dist/main.d.ts",
+    "dist/types.d.ts",
+    "dist/errors.d.ts",
+    "dist/version.d.ts"
   ],
   "publishConfig": {
     "access": "public"
@@ -65,7 +72,7 @@
     "vite": "7.1.2"
   },
   "scripts": {
-    "build": "rm -rf dist && tsc -p tsconfig.json",
+    "build": "rm -rf dist && tsc -p tsconfig.json --removeComments && tsc -p tsconfig.json --emitDeclarationOnly",
     "clean": "rm -rf dist",
     "typecheck": "tsc --noEmit && node scripts/api-report.mjs --check",
     "api:update": "node scripts/api-report.mjs"

package/dist/cli.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=cli.d.ts.map

package/dist/dev.d.ts

@@ -1,38 +0,0 @@
-/**
- * The `pnpm dev` handshake between `driftBeacon()` and the Drift Beacon server. The dev tool writes a
- * marker into the package's `dist/`; the server polls for it, connects to Vite's HMR socket and trusts
- * the socket only after a `welcome` whose `session` equals the marker's. Messages travel as Vite custom
- * events (`{ type: "custom", event, data }`). All wording is rendered on the server; the tool only prints.
- */
-/** File name of the marker in `dist/`. Written as tmp, then renamed, synchronously. Never packed. */
-export declare const DEV_MARKER = ".drift-beacon-dev.json";
-export interface DevMarker {
-    readonly v: 1;
-    /** `manifest.id`; the server routes logs and the dev UI URL by it. */
-    readonly pluginId: string;
-    /** Hash of the built package; null until `dist/main/index.js` exists. A new id means a new build. */
-    readonly buildId: string | null;
-    /** One per `pnpm dev` process and package root; null after `vite build`. */
-    readonly session: string | null;
-    /** The dev server's UI URL, for example `http://localhost:5174/`. */
-    readonly uiUrl: string | null;
-    /** The dev server's HMR socket, for example `ws://localhost:5174/`. */
-    readonly wsUrl: string | null;
-}
-/** Server → tool, event `drift-beacon:hello`. */
-export interface DevHello {
-    readonly v: 1;
-    readonly session: string;
-}
-/** Tool → server, event `drift-beacon:welcome`, sent only to the socket that said hello. */
-export interface DevWelcome {
-    readonly v: 1;
-    readonly session: string;
-    readonly pluginId: string;
-}
-/** Server → tool, event `drift-beacon:print`: one line (or block) for the plugin's terminal. */
-export interface DevPrint {
-    readonly level: "info" | "success" | "warn" | "error";
-    readonly text: string;
-}
-//# sourceMappingURL=dev.d.ts.map

package/dist/internal/actions.d.ts

@@ -1,35 +0,0 @@
-/**
- * Requests an instance's main code sends to the server through its plugin host. The server runs them
- * as the instance's user in the instance's workspace.
- */
-export type PluginAction = {
-    readonly name: "startSession";
-    readonly activityId: string;
-} | {
-    readonly name: "endSession";
-    readonly sessionId: string;
-} | {
-    readonly name: "markPoint";
-    readonly activityId: string;
-} | {
-    readonly name: "discardSession";
-    readonly sessionId: string;
-} | {
-    readonly name: "storageSet";
-    readonly key: string;
-    readonly value: unknown;
-} | {
-    readonly name: "storageRemove";
-    readonly key: string;
-} | {
-    readonly name: "mqttSubscribe";
-    readonly topic: string;
-} | {
-    readonly name: "mqttUnsubscribe";
-    readonly topic: string;
-} | {
-    readonly name: "mqttPublish";
-    readonly topic: string;
-    readonly payload: string;
-};
-//# sourceMappingURL=actions.d.ts.map

package/dist/internal/collection.d.ts

@@ -1,15 +0,0 @@
-import type { RowChange } from "./rows.ts";
-/**
- * A collection of plain rows keyed by id, frozen as they arrive. `replace` applies a full set of rows, keeps the
- * object of every unchanged row (so identity only changes when data does) and reports the changes.
- */
-export declare class Collection<T extends {
-    readonly id: string;
-}> {
-    private rows;
-    private cachedList;
-    list(): readonly T[];
-    get(id: string): T | undefined;
-    replace(incoming: readonly T[]): RowChange<T>[];
-}
-//# sourceMappingURL=collection.d.ts.map

package/dist/internal/compatibility.d.ts

@@ -1,26 +0,0 @@
-/**
- * API versions this build of Drift Beacon runs: the newest minor of each supported major.
- * Before 1.0 only the current version is listed, because every 0.x minor may break plugins.
- * From 1.0, the previous major stays listed for at least six months after its successor ships.
- */
-export declare const SUPPORTED_API_VERSIONS: readonly string[];
-export interface ApiVersion {
-    readonly major: number;
-    readonly minor: number;
-}
-/** Parse a `major.minor` API version; null when malformed. */
-export declare function parseApiVersion(value: unknown): ApiVersion | null;
-export type ApiCompatibility = {
-    readonly compatible: true;
-} | {
-    readonly compatible: false;
-    readonly reason: "invalid" | "needs-newer-app" | "needs-plugin-update";
-    readonly message: string;
-};
-/**
- * Whether a plugin built for `pluginVersion` runs on a build supporting `supported`.
- * Before 1.0 the minor must match exactly; from 1.0 the major must match and the plugin's
- * minor must not be newer than the host's.
- */
-export declare function checkApiCompatibility(pluginVersion: unknown, supported?: readonly string[]): ApiCompatibility;
-//# sourceMappingURL=compatibility.d.ts.map

package/dist/internal/json-equal.d.ts

@@ -1,3 +0,0 @@
-/** Structural equality for JSON-shaped values such as data rows and storage items. */
-export declare function jsonEqual(a: unknown, b: unknown): boolean;
-//# sourceMappingURL=json-equal.d.ts.map

package/dist/internal/manifest.d.ts

@@ -1,51 +0,0 @@
-interface ConfigurationItemBase {
-    name: string;
-    title: string;
-    description?: string;
-    required?: boolean;
-}
-export interface StringConfigurationItem extends ConfigurationItemBase {
-    type: "string";
-    default?: string;
-    placeholder?: string;
-}
-export interface NumberConfigurationItem extends ConfigurationItemBase {
-    type: "number";
-    default?: number;
-    minimum?: number;
-    maximum?: number;
-}
-export interface BooleanConfigurationItem extends ConfigurationItemBase {
-    type: "boolean";
-    default?: boolean;
-}
-export interface DropdownConfigurationItem extends ConfigurationItemBase {
-    type: "dropdown";
-    default?: string;
-    data: ReadonlyArray<{
-        readonly title: string;
-        readonly value: string;
-    }>;
-}
-/** One setting declared in `manifest.json`; drives the settings form and config validation. */
-export type ConfigurationItem = StringConfigurationItem | NumberConfigurationItem | BooleanConfigurationItem | DropdownConfigurationItem;
-export interface PluginManifest {
-    id: string;
-    name: string;
-    version: string;
-    /** Plugin API version (`major.minor`) the plugin was built for. */
-    apiVersion: string;
-    description: string;
-    author: {
-        name: string;
-        email?: string;
-    };
-    category: "plugin" | "utility" | "ui";
-    icon: string;
-    configuration: readonly ConfigurationItem[];
-}
-export declare const isStableVersion: (value: unknown) => value is string;
-/** Throws a readable error when `manifest` is not a valid plugin manifest. Shared by the server and the pack tool. */
-export declare function validateManifest(manifest: unknown): asserts manifest is PluginManifest;
-export {};
-//# sourceMappingURL=manifest.d.ts.map

package/dist/internal/models.d.ts

@@ -1,62 +0,0 @@
-import type { ActivitiesApi, Activity, ActivityFilter, CategoriesApi, Category, Change, Session, SessionData, SessionFilter, SessionsApi } from "../types.ts";
-import type { Collection } from "./collection.ts";
-import type { ActivityRow, CategoryRow, SessionRow, WorkspaceRowChanges } from "./rows.ts";
-export interface WorkspaceCollections {
-    readonly activities: Collection<ActivityRow>;
-    readonly categories: Collection<CategoryRow>;
-    readonly sessions: Collection<SessionRow>;
-}
-/** Session operations. Each resolves with the session's row once the snapshot containing the result has arrived. */
-export interface SessionActions {
-    start(activityId: string): Promise<unknown>;
-    end(sessionId: string): Promise<unknown>;
-    mark(activityId: string): Promise<unknown>;
-    discard(sessionId: string): Promise<unknown>;
-}
-export interface ModelChanges {
-    readonly activities: readonly Change<Activity>[];
-    readonly categories: readonly Change<Category>[];
-    readonly sessions: readonly Change<Session>[];
-}
-/** The reads and actions of `ctx.activities`, `ctx.categories` and `ctx.sessions`. Contexts add the events. */
-export interface ModelApis {
-    readonly activities: Omit<ActivitiesApi, "onChange">;
-    readonly categories: Omit<CategoriesApi, "onChange">;
-    readonly sessions: Omit<SessionsApi, "onChange">;
-}
-export declare class WorkspaceModels {
-    #private;
-    readonly userId: string;
-    readonly rows: WorkspaceCollections;
-    constructor(options: {
-        readonly userId: string;
-        readonly rows: WorkspaceCollections;
-        readonly actions: SessionActions;
-    });
-    /** The reads and actions for `ctx`. */
-    apis(): ModelApis;
-    activity(id: string): Activity | undefined;
-    category(id: string): Category | undefined;
-    session(id: string): Session | undefined;
-    /** In the app's order: by category (uncategorized last), then `sortOrder`, then name. */
-    activities(filter?: ActivityFilter): readonly Activity[];
-    /** By `sortOrder`, then name. */
-    categories(): readonly Category[];
-    /** Newest first. */
-    sessions(filter?: SessionFilter): readonly Session[];
-    start(activityId: string): Promise<Session>;
-    end(sessionId: string): Promise<Session>;
-    mark(activityId: string): Promise<Session>;
-    discard(sessionId: string): Promise<void>;
-    /** Turn the row changes of a snapshot into model changes. Call it after the collections were replaced. */
-    update(changes: WorkspaceRowChanges): ModelChanges;
-    /**
-     * The model for a session the app sent outside a snapshot (a live event or an action result):
-     * the snapshot's model, or, when the row isn't in the snapshot, a removed model holding these values.
-     */
-    sessionFrom(row: SessionRow): Session;
-    activityRow(id: string): ActivityRow;
-    categoryRow(id: string): CategoryRow;
-    sessionData(id: string): SessionData;
-}
-//# sourceMappingURL=models.d.ts.map

package/dist/internal/package-layout.d.ts

@@ -1,21 +0,0 @@
-/**
- * The plugin package: `manifest.json`, `package.json`, `main/index.js` (plus chunks) and `ui/index.html`
- * (plus assets and the manifest icon). Shared by the pack tool and the server. Pure: the web app bundles
- * `/internal`, so no `node:` imports.
- */
-export declare const PACKAGE_LIMITS: {
-    readonly entries: 2000;
-    readonly fileBytes: number;
-    readonly totalBytes: number;
-    readonly archiveBytes: number;
-    readonly manifestBytes: number;
-};
-/** The `package.json` every package gets: main is ESM. */
-export declare const PACKAGE_JSON: {
-    readonly type: "module";
-    readonly private: true;
-};
-export declare const REQUIRED_FILES: readonly ["main/index.js", "ui/index.html"];
-/** manifest.json, package.json, main/** and ui/** (directories: main, ui and below). `name` has no trailing slash. */
-export declare const isPackagePath: (name: string, directory: boolean) => boolean;
-//# sourceMappingURL=package-layout.d.ts.map

package/dist/internal/protocol.d.ts

@@ -1,96 +0,0 @@
-/**
- * Messages between a plugin UI (iframe) and the web app hosting it, over `postMessage`.
- *
- * The UI client ships inside every published UI bundle, so this protocol is frozen into
- * them: change it only additively within an API version. The UI opens with `hello`; nothing
- * else flows until the host answers `welcome` or `reject`.
- */
-import type { PluginErrorCode, PluginInfo, UserInfo, WorkspaceInfo } from "../types.ts";
-import type { WorkspaceRows } from "./rows.ts";
-/** Marks our messages so both sides ignore unrelated `postMessage` traffic (dev tools, HMR). */
-export declare const UI_CHANNEL = "drift-beacon-plugin";
-/** Workspace data sent to a UI, as rows. */
-export type UiData = WorkspaceRows;
-export type UiRequest = {
-    readonly method: "sessions.start";
-    readonly params: {
-        readonly activityId: string;
-    };
-} | {
-    readonly method: "sessions.end";
-    readonly params: {
-        readonly sessionId: string;
-    };
-} | {
-    readonly method: "sessions.mark";
-    readonly params: {
-        readonly activityId: string;
-    };
-} | {
-    readonly method: "sessions.discard";
-    readonly params: {
-        readonly sessionId: string;
-    };
-} | {
-    readonly method: "storage.set";
-    readonly params: {
-        readonly key: string;
-        readonly value: unknown;
-    };
-} | {
-    readonly method: "storage.remove";
-    readonly params: {
-        readonly key: string;
-    };
-};
-export type UiToHostMessage = {
-    readonly channel: typeof UI_CHANNEL;
-    readonly type: "hello";
-    readonly apiVersion: string;
-} | ({
-    readonly channel: typeof UI_CHANNEL;
-    readonly type: "request";
-    readonly id: string;
-} & UiRequest);
-export interface UiError {
-    readonly code: PluginErrorCode;
-    readonly message: string;
-}
-export type HostToUiMessage = {
-    readonly channel: typeof UI_CHANNEL;
-    readonly type: "welcome";
-    readonly apiVersion: string;
-    readonly plugin: PluginInfo;
-    readonly user: UserInfo;
-    readonly workspace: WorkspaceInfo;
-    readonly config: Readonly<Record<string, unknown>>;
-    readonly data: UiData;
-    readonly storage: Readonly<Record<string, unknown>>;
-} | {
-    readonly channel: typeof UI_CHANNEL;
-    readonly type: "reject";
-    readonly reason: string;
-}
-/** The app restarted its side of the connection; the UI answers with `hello` and gets a new `welcome`. */
- | {
-    readonly channel: typeof UI_CHANNEL;
-    readonly type: "reconnect";
-} | {
-    /** Replaces whichever parts are present. */
-    readonly channel: typeof UI_CHANNEL;
-    readonly type: "state";
-    readonly config?: Readonly<Record<string, unknown>>;
-    readonly data?: UiData;
-    readonly storage?: Readonly<Record<string, unknown>>;
-} | {
-    readonly channel: typeof UI_CHANNEL;
-    readonly type: "response";
-    readonly id: string;
-    readonly result?: unknown;
-    readonly error?: UiError;
-};
-export declare function isUiMessage(value: unknown): value is {
-    channel: typeof UI_CHANNEL;
-    type: string;
-};
-//# sourceMappingURL=protocol.d.ts.map

package/dist/internal/rows.d.ts

@@ -1,41 +0,0 @@
-/**
- * Workspace data as it travels from the app to plugins: to plugin hosts over IPC and to plugin
- * UIs over `postMessage`. Plugins never see rows; the model layer (`models.ts`) wraps them.
- */
-import type { ActivityData, CategoryData } from "../types.ts";
-export type ActivityRow = ActivityData;
-export type CategoryRow = CategoryData;
-export interface SessionRow {
-    readonly id: string;
-    readonly activityId: string;
-    readonly type: "span" | "point";
-    readonly status: "live" | "completed";
-    readonly memberIds: readonly string[];
-    /** ISO timestamp: when a span started, or when a point was marked. */
-    readonly startedAt: string;
-    /** ISO timestamp when a span ended; null while live and for points. */
-    readonly endedAt: string | null;
-}
-export interface WorkspaceRows {
-    readonly activities: readonly ActivityRow[];
-    readonly categories: readonly CategoryRow[];
-    readonly sessions: readonly SessionRow[];
-}
-/** One change to a collection of rows. */
-export type RowChange<T> = {
-    readonly type: "added";
-    readonly item: T;
-} | {
-    readonly type: "updated";
-    readonly item: T;
-    readonly previous: T;
-} | {
-    readonly type: "removed";
-    readonly item: T;
-};
-export interface WorkspaceRowChanges {
-    readonly activities: readonly RowChange<ActivityRow>[];
-    readonly categories: readonly RowChange<CategoryRow>[];
-    readonly sessions: readonly RowChange<SessionRow>[];
-}
-//# sourceMappingURL=rows.d.ts.map

package/dist/internal.d.ts

@@ -1,17 +0,0 @@
-/**
- * Platform-only entry used by the plugin host, the web app and the server. Not part of the plugin API.
- * Public entries never import this file; SDK modules may import `internal/*` directly. Publishing drops
- * only its export key.
- */
-export * from "./dev.ts";
-export type { PluginAction } from "./internal/actions.ts";
-export { Collection } from "./internal/collection.ts";
-export { type ApiCompatibility, type ApiVersion, checkApiCompatibility, parseApiVersion, SUPPORTED_API_VERSIONS, } from "./internal/compatibility.ts";
-export { jsonEqual } from "./internal/json-equal.ts";
-export { type BooleanConfigurationItem, type ConfigurationItem, type DropdownConfigurationItem, isStableVersion, type NumberConfigurationItem, type PluginManifest, type StringConfigurationItem, validateManifest, } from "./internal/manifest.ts";
-export { type ModelApis, type ModelChanges, type SessionActions, type WorkspaceCollections, WorkspaceModels, } from "./internal/models.ts";
-export { isPackagePath, PACKAGE_JSON, PACKAGE_LIMITS, REQUIRED_FILES } from "./internal/package-layout.ts";
-export * from "./internal/protocol.ts";
-export type { ActivityRow, CategoryRow, RowChange, SessionRow, WorkspaceRowChanges, WorkspaceRows, } from "./internal/rows.ts";
-export type { PluginErrorCode } from "./types.ts";
-//# sourceMappingURL=internal.d.ts.map

package/dist/internal.js

@@ -1,13 +0,0 @@
-/**
- * Platform-only entry used by the plugin host, the web app and the server. Not part of the plugin API.
- * Public entries never import this file; SDK modules may import `internal/*` directly. Publishing drops
- * only its export key.
- */
-export * from "./dev.js";
-export { Collection } from "./internal/collection.js";
-export { checkApiCompatibility, parseApiVersion, SUPPORTED_API_VERSIONS, } from "./internal/compatibility.js";
-export { jsonEqual } from "./internal/json-equal.js";
-export { isStableVersion, validateManifest, } from "./internal/manifest.js";
-export { WorkspaceModels, } from "./internal/models.js";
-export { isPackagePath, PACKAGE_JSON, PACKAGE_LIMITS, REQUIRED_FILES } from "./internal/package-layout.js";
-export * from "./internal/protocol.js";

package/dist/pack.d.ts

@@ -1,24 +0,0 @@
-export interface PackResult {
-    readonly id: string;
-    readonly version: string;
-    readonly tag: string;
-    readonly asset: string;
-    readonly archivePath: string;
-}
-/**
- * Zip the package in `dir` into `<outDir>/<id>.zip`: its manifest, a generated `package.json`, and `main/**`
- * and `ui/**`. Anything else in `dir` (the dev marker, its `package.json`) is left out. Never runs plugin code.
- */
-export declare function packDirectory(dir: string, outDir: string): Promise<PackResult>;
-export interface PackOptions {
-    /** Where the zip goes. Default `<root>/releases`. */
-    readonly out?: string;
-}
-/**
- * Build a release of the plugin package at `root`: prepare, typecheck main and UI with the package's own
- * TypeScript, `vite build` into a fresh temp folder with the package's own Vite, then `packDirectory`. The
- * package's `dist/` is never read or written. Everything printed meanwhile goes to stderr, so a caller's
- * stdout carries only the result.
- */
-export declare function pack(root: string, options?: PackOptions): Promise<PackResult>;
-//# sourceMappingURL=pack.d.ts.map

package/dist/prepare.d.ts

@@ -1,28 +0,0 @@
-import { type PluginManifest } from "./internal/manifest.ts";
-export interface PrepareOptions {
-    /**
-     * Throw on manifest problems (dev, build and pack). When false (`dbplugin prepare`, run on install), warn
-     * and leave `.drift-beacon/` as it was, so a manifest typo never fails `pnpm install`.
-     */
-    readonly strict: boolean;
-}
-/** A package's `manifest.json`: parsed and checked, with its bytes. */
-export interface LoadedManifest {
-    readonly manifest: PluginManifest;
-    readonly bytes: Buffer;
-}
-/**
- * Generate `<root>/.drift-beacon/` from the manifest, and return the manifest (`loadManifest`). Files are
- * rewritten only when their content changes.
- */
-export declare function prepare(root: string, options: {
-    readonly strict: true;
-}): LoadedManifest;
-export declare function prepare(root: string, options: PrepareOptions): LoadedManifest | null;
-/**
- * `<root>/manifest.json`, the one read of a manifest in the SDK (dev, build, prepare and pack): a regular
- * file within the package limit, valid, and for an `apiVersion` this SDK runs (the server's check). The
- * error names the file.
- */
-export declare function loadManifest(root: string): LoadedManifest;
-//# sourceMappingURL=prepare.d.ts.map