@harborclient/sdk 1.0.0 → 1.0.1

package/dist/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/build/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEpD;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gEAAgE;IAChE,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;IACpC;;;OAGG;IACH,IAAI,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACjD;AAwCD;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqDrF;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAiB7E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/build/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEpD;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gEAAgE;IAChE,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;IACpC;;;OAGG;IACH,IAAI,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACjD;AAwCD;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqDrF;AAYD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAiB7E"}

package/dist/build/index.js

@@ -79,6 +79,15 @@ export async function buildRenderer(options = {}) {
         copyAssets(copy);
     }
 }
+/**
+ * Escapes a string for use as a literal in a RegExp.
+ *
+ * @param value - Raw string to escape.
+ * @returns Regex-safe literal.
+ */
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
 /**
  * esbuild plugin that stubs Node built-in modules with empty exports.
  *
@@ -93,7 +102,7 @@ export function nodeBuiltinStubsPlugin(moduleNames) {
         name: 'node-builtins-stub',
         setup(build) {
             for (const moduleName of moduleNames) {
-                build.onResolve({ filter: new RegExp(`^${moduleName}$`) }, () => ({
+                build.onResolve({ filter: new RegExp(`^${escapeRegExp(moduleName)}$`) }, () => ({
                     path: moduleName,
                     namespace: 'node-stub'
                 }));

package/dist/client.d.ts

@@ -1,2 +1,2 @@
-export * from './index';
-export * from './runtime/index';
+export * from './index.js';
+export * from './runtime/index.js';

package/dist/components/portalToBody.d.ts

@@ -4,7 +4,8 @@ import type { ReactNode, ReactPortal } from 'react';
  * the sidebar or other overflow-hidden plugin webview containers.
  *
  * @param node - Modal element to render.
- * @returns Portal into document.body, or the node unchanged when document is unavailable.
+ * @returns Portal into document.body.
+ * @throws When `document` is unavailable (SSR, tests, or misconfigured host).
  */
 export declare function portalToBody(node: ReactNode): ReactPortal;
 //# sourceMappingURL=portalToBody.d.ts.map

package/dist/components/portalToBody.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"portalToBody.d.ts","sourceRoot":"","sources":["../../src/components/portalToBody.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAEpD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,WAAW,CAKzD"}
+{"version":3,"file":"portalToBody.d.ts","sourceRoot":"","sources":["../../src/components/portalToBody.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAEpD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,WAAW,CAKzD"}

package/dist/components/portalToBody.js

@@ -4,11 +4,12 @@ import { createPortal } from '@harborclient/sdk/react-dom';
  * the sidebar or other overflow-hidden plugin webview containers.
  *
  * @param node - Modal element to render.
- * @returns Portal into document.body, or the node unchanged when document is unavailable.
+ * @returns Portal into document.body.
+ * @throws When `document` is unavailable (SSR, tests, or misconfigured host).
  */
 export function portalToBody(node) {
-    if (typeof document !== 'undefined') {
-        return createPortal(node, document.body);
+    if (typeof document === 'undefined') {
+        throw new Error('portalToBody requires a DOM document');
     }
-    return node;
+    return createPortal(node, document.body);
 }

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export type * from './types';
+export type * from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,YAAY,CAAC"}

package/dist/main.d.ts

@@ -1,2 +1,2 @@
-export type { CodeEditorSetup, CodeEditorTheme, Disposable, EchoServerIncomingRequest, EchoServerStartResult, EchoServerStatus, MainPluginContext, PluginHttp, PluginHttpRequest, PluginHttpResponse, PluginIpc, PluginScriptCollectionInit, PluginScriptContext, PluginScriptContextInit, PluginScriptEnvironmentInit, PluginScriptKeyValue, PluginScriptRequestInit, PluginScriptResponseInit, PluginScriptRunResult, PluginScripts, PluginScriptTestResult, PluginServer, PluginStorage, ScriptPhase } from './types';
+export type { CodeEditorSetup, CodeEditorTheme, Disposable, EchoServerIncomingRequest, EchoServerStartResult, EchoServerStatus, MainPluginContext, PluginHttp, PluginHttpRequest, PluginHttpResponse, PluginIpc, PluginScriptCollectionInit, PluginScriptContext, PluginScriptContextInit, PluginScriptEnvironmentInit, PluginScriptKeyValue, PluginScriptRequestInit, PluginScriptResponseInit, PluginScriptRunResult, PluginScripts, PluginScriptTestResult, PluginServer, PluginStorage, ScriptPhase } from './types.js';
 //# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,eAAe,EACf,eAAe,EACf,UAAU,EACV,yBAAyB,EACzB,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,iBAAiB,EACjB,kBAAkB,EAClB,SAAS,EACT,0BAA0B,EAC1B,mBAAmB,EACnB,uBAAuB,EACvB,2BAA2B,EAC3B,oBAAoB,EACpB,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACrB,aAAa,EACb,sBAAsB,EACtB,YAAY,EACZ,aAAa,EACb,WAAW,EACZ,MAAM,SAAS,CAAC"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,eAAe,EACf,eAAe,EACf,UAAU,EACV,yBAAyB,EACzB,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,iBAAiB,EACjB,kBAAkB,EAClB,SAAS,EACT,0BAA0B,EAC1B,mBAAmB,EACnB,uBAAuB,EACvB,2BAA2B,EAC3B,oBAAoB,EACpB,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACrB,aAAa,EACb,sBAAsB,EACtB,YAAY,EACZ,aAAa,EACb,WAAW,EACZ,MAAM,YAAY,CAAC"}

package/dist/runtime/index.d.ts

@@ -1,5 +1,5 @@
 import type * as React from 'react';
-import type { Disposable, PluginContext, ThemeContribution } from '../types';
+import type { Disposable, PluginContext, ThemeContribution } from '../types.js';
 
 /**
  * Installs the HarborClient renderer React instance for plugin JSX and hooks.

package/dist/runtime/jsx-dev-runtime.d.ts

@@ -1,6 +1,6 @@
 import type * as React from 'react';
 
-export { Fragment } from './jsx-runtime';
+export { Fragment } from './jsx-runtime.js';
 
 /**
  * Development JSX runtime entry; delegates to the production jsx helper.

package/dist/runtime/store.d.ts

@@ -41,7 +41,8 @@ export interface StorageStore<T> {
      */
     reloadFromStorage(): Promise<void>;
     /**
-     * Updates the in-memory snapshot, notifies subscribers, and persists to storage.
+     * Persists to storage, then updates the in-memory snapshot and notifies subscribers.
+     * Rejects when persistence fails; the snapshot is left unchanged.
      *
      * @param next - New snapshot value.
      */
@@ -93,6 +94,10 @@ export declare function createExternalStore<T>(initial: T): {
 /**
  * Creates a storage-backed external store for sharing state across plugin webviews.
  *
+ * Hydrates from storage asynchronously on creation. Synchronous {@link StorageStore.getSnapshot}
+ * may return `parse(undefined)` until hydration completes; use {@link StorageStore.useValue}
+ * or await {@link StorageStore.reloadFromStorage} when you need the persisted value before reading.
+ *
  * Separate plugin webviews do not share memory; use {@link syncOnWindowFocus} to
  * reload when another surface writes storage.
  *

package/dist/runtime/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/runtime/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAE5C;;;;;OAKG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAE5C;;OAEG;IACH,WAAW,IAAI,CAAC,CAAC;IAEjB;;OAEG;IACH,QAAQ,IAAI,CAAC,CAAC;IAEd;;OAEG;IACH,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB,CAAC,CAAC;IAC1C,4CAA4C;IAC5C,OAAO,EAAE,WAAW,CAAC;IAErB,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;IAEZ;;;;;OAKG;IACH,KAAK,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,CAAC,CAAC;IAE3B;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC;IAEjC;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,yFAAyF;IACzF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG;IAClD,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;IAChD,WAAW,EAAE,MAAM,CAAC,CAAC;IACrB,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;CAC7B,CAkBA;AAYD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,EAAE,yBAAyB,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CA+C5F;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,UAAU,CAO1F;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,YAAY,CAAC,OAAO,CAAC,GAAG,YAAY,CAAC,OAAO,CAAC,EAAE,EACvD,OAAO,CAAC,EAAE,wBAAwB,GACjC,UAAU,CA0BZ"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/runtime/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAE5C;;;;;OAKG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAE5C;;OAEG;IACH,WAAW,IAAI,CAAC,CAAC;IAEjB;;OAEG;IACH,QAAQ,IAAI,CAAC,CAAC;IAEd;;OAEG;IACH,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB,CAAC,CAAC;IAC1C,4CAA4C;IAC5C,OAAO,EAAE,WAAW,CAAC;IAErB,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;IAEZ;;;;;OAKG;IACH,KAAK,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,CAAC,CAAC;IAE3B;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC;IAEjC;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,yFAAyF;IACzF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG;IAClD,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;IAChD,WAAW,EAAE,MAAM,CAAC,CAAC;IACrB,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;CAC7B,CAkBA;AAYD;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,EAAE,yBAAyB,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAkD5F;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,UAAU,CAO1F;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,YAAY,CAAC,OAAO,CAAC,GAAG,YAAY,CAAC,OAAO,CAAC,EAAE,EACvD,OAAO,CAAC,EAAE,wBAAwB,GACjC,UAAU,CA0BZ"}

package/dist/runtime/store.js

@@ -35,6 +35,10 @@ function defaultEquals(a, b) {
 /**
  * Creates a storage-backed external store for sharing state across plugin webviews.
  *
+ * Hydrates from storage asynchronously on creation. Synchronous {@link StorageStore.getSnapshot}
+ * may return `parse(undefined)` until hydration completes; use {@link StorageStore.useValue}
+ * or await {@link StorageStore.reloadFromStorage} when you need the persisted value before reading.
+ *
  * Separate plugin webviews do not share memory; use {@link syncOnWindowFocus} to
  * reload when another surface writes storage.
  *
@@ -58,7 +62,8 @@ export function createStorageStore(options) {
         }
     }
     /**
-     * Updates the snapshot, notifies subscribers, and persists when the value changed.
+     * Persists when the value changed, then updates the snapshot and notifies subscribers.
+     * Rejects when persistence fails; the snapshot is left unchanged.
      *
      * @param next - New snapshot value.
      */
@@ -67,8 +72,8 @@ export function createStorageStore(options) {
         if (equals(current, next)) {
             return;
         }
-        external.setState(next);
         await storage.set(key, next);
+        external.setState(next);
     }
     /**
      * React hook returning the current storage-backed snapshot.
@@ -76,6 +81,7 @@ export function createStorageStore(options) {
     function useValue() {
         return useSyncExternalStore(external.subscribe, external.getSnapshot, external.getSnapshot);
     }
+    void reloadFromStorage();
     return {
         subscribe: external.subscribe,
         getSnapshot: external.getSnapshot,

package/dist/runtime/store.ts

@@ -49,7 +49,8 @@ export interface StorageStore<T> {
   reloadFromStorage(): Promise<void>;
 
   /**
-   * Updates the in-memory snapshot, notifies subscribers, and persists to storage.
+   * Persists to storage, then updates the in-memory snapshot and notifies subscribers.
+   * Rejects when persistence fails; the snapshot is left unchanged.
    *
    * @param next - New snapshot value.
    */
@@ -137,6 +138,10 @@ function defaultEquals<T>(a: T, b: T): boolean {
 /**
  * Creates a storage-backed external store for sharing state across plugin webviews.
  *
+ * Hydrates from storage asynchronously on creation. Synchronous {@link StorageStore.getSnapshot}
+ * may return `parse(undefined)` until hydration completes; use {@link StorageStore.useValue}
+ * or await {@link StorageStore.reloadFromStorage} when you need the persisted value before reading.
+ *
  * Separate plugin webviews do not share memory; use {@link syncOnWindowFocus} to
  * reload when another surface writes storage.
  *
@@ -162,7 +167,8 @@ export function createStorageStore<T>(options: CreateStorageStoreOptions<T>): St
   }
 
   /**
-   * Updates the snapshot, notifies subscribers, and persists when the value changed.
+   * Persists when the value changed, then updates the snapshot and notifies subscribers.
+   * Rejects when persistence fails; the snapshot is left unchanged.
    *
    * @param next - New snapshot value.
    */
@@ -171,8 +177,8 @@ export function createStorageStore<T>(options: CreateStorageStoreOptions<T>): St
     if (equals(current, next)) {
       return;
     }
-    external.setState(next);
     await storage.set(key, next);
+    external.setState(next);
   }
 
   /**
@@ -182,6 +188,8 @@ export function createStorageStore<T>(options: CreateStorageStoreOptions<T>): St
     return useSyncExternalStore(external.subscribe, external.getSnapshot, external.getSnapshot);
   }
 
+  void reloadFromStorage();
+
   return {
     subscribe: external.subscribe,
     getSnapshot: external.getSnapshot,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harborclient/sdk",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "TypeScript SDK for HarborClient plugin development.",
   "keywords": [
     "harborclient",
@@ -201,7 +201,8 @@
     "vitepress-plugin-mermaid": "^2.0.17"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.build.json && node scripts/copy-runtime.mjs",
+    "build": "tsc -p tsconfig.build.json && node scripts/copy-runtime.mjs && node scripts/assert-dist-publishable.mjs",
+    "attw": "attw --profile esm-only --no-summary",
     "format": "prettier --write .",
     "format:check": "prettier --check .",
     "lint": "eslint --cache .",

package/dist/components/enhanceControl.test.d.ts

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

package/dist/components/enhanceControl.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"enhanceControl.test.d.ts","sourceRoot":"","sources":["../../src/components/enhanceControl.test.ts"],"names":[],"mappings":""}

package/dist/components/enhanceControl.test.js

@@ -1,83 +0,0 @@
-import { describe, expect, it } from '@jest/globals';
-import { createElement, Fragment, isValidElement } from 'react';
-import { enhanceControl } from './enhanceControl.js';
-/** Stand-in for {@link Input} — function component that forwards props to a native input. */
-function TextInput(props) {
-    return createElement('input', { type: 'text', ...props });
-}
-function propsOf(node) {
-    if (!isValidElement(node)) {
-        throw new Error('Expected a valid React element');
-    }
-    return node.props;
-}
-describe('enhanceControl', () => {
-    it('merges aria-describedby and aria-invalid on a form component', () => {
-        const result = enhanceControl(createElement(TextInput), {
-            describedBy: 'field-error',
-            invalid: true
-        });
-        expect(propsOf(result)['aria-describedby']).toBe('field-error');
-        expect(propsOf(result)['aria-invalid']).toBe(true);
-    });
-    it('includes description id in aria-describedby without setting aria-invalid', () => {
-        const result = enhanceControl(createElement(TextInput), {
-            describedBy: 'api-key-description'
-        });
-        expect(propsOf(result)['aria-describedby']).toBe('api-key-description');
-        expect(propsOf(result)['aria-invalid']).toBeUndefined();
-    });
-    it('merges description and error ids in aria-describedby', () => {
-        const result = enhanceControl(createElement(TextInput), {
-            describedBy: 'api-key-description api-key-error',
-            invalid: true
-        });
-        expect(propsOf(result)['aria-describedby']).toBe('api-key-description api-key-error');
-        expect(propsOf(result)['aria-invalid']).toBe(true);
-    });
-    it('merges with an existing aria-describedby value', () => {
-        const result = enhanceControl(createElement(TextInput, { 'aria-describedby': 'existing' }), {
-            describedBy: 'field-error'
-        });
-        expect(propsOf(result)['aria-describedby']).toBe('existing field-error');
-    });
-    it('enhances a control wrapped in a div', () => {
-        const wrapped = createElement('div', null, createElement(TextInput));
-        const result = enhanceControl(wrapped, { describedBy: 'field-error' });
-        const inner = propsOf(result).children;
-        expect(propsOf(inner)['aria-describedby']).toBe('field-error');
-    });
-    it('enhances a native input wrapped in a div', () => {
-        const wrapped = createElement('div', null, createElement('input', { type: 'text' }));
-        const result = enhanceControl(wrapped, { describedBy: 'field-error' });
-        const inner = propsOf(result).children;
-        expect(propsOf(inner)['aria-describedby']).toBe('field-error');
-    });
-    it('unwraps a single-element array', () => {
-        const result = enhanceControl([createElement(TextInput)], { describedBy: 'field-error' });
-        expect(propsOf(result)['aria-describedby']).toBe('field-error');
-    });
-    it('enhances a control wrapped in a fragment', () => {
-        const wrapped = createElement(Fragment, null, createElement(TextInput));
-        const result = enhanceControl(wrapped, { describedBy: 'field-error' });
-        const inner = propsOf(result).children;
-        expect(propsOf(inner)['aria-describedby']).toBe('field-error');
-    });
-    it('leaves multiple siblings unchanged', () => {
-        const child = [createElement(TextInput), createElement('span')];
-        const result = enhanceControl(child, { describedBy: 'field-error' });
-        expect(result).toBe(child);
-    });
-    it('sets id when the control has none', () => {
-        const result = enhanceControl(createElement('input', { type: 'checkbox' }), {
-            id: 'auto-id'
-        });
-        expect(propsOf(result).id).toBe('auto-id');
-    });
-    it('preserves an existing id', () => {
-        const result = enhanceControl(createElement('input', { id: 'existing-id', type: 'checkbox' }), {
-            id: 'auto-id'
-        });
-        expect(propsOf(result).id).toBe('existing-id');
-    });
-});

package/dist/components/utils.test.d.ts

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

package/dist/components/utils.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.test.d.ts","sourceRoot":"","sources":["../../src/components/utils.test.ts"],"names":[],"mappings":""}

package/dist/components/utils.test.js

@@ -1,44 +0,0 @@
-import { describe, expect, it } from '@jest/globals';
-import { resolveMenuTypeahead, resolveTabListKeyAction } from './utils.js';
-describe('resolveTabListKeyAction', () => {
-    it('returns null for unhandled keys', () => {
-        expect(resolveTabListKeyAction('Enter', 0, 3)).toBeNull();
-        expect(resolveTabListKeyAction('Tab', 1, 3)).toBeNull();
-    });
-    it('returns null when itemCount is zero', () => {
-        expect(resolveTabListKeyAction('ArrowRight', 0, 0)).toBeNull();
-    });
-    it('moves forward and backward with arrow keys', () => {
-        expect(resolveTabListKeyAction('ArrowRight', 0, 3)).toBe(1);
-        expect(resolveTabListKeyAction('ArrowDown', 1, 3)).toBe(2);
-        expect(resolveTabListKeyAction('ArrowLeft', 0, 3)).toBe(2);
-        expect(resolveTabListKeyAction('ArrowUp', 2, 3)).toBe(1);
-    });
-    it('jumps to first and last enabled items with Home and End', () => {
-        expect(resolveTabListKeyAction('Home', 2, 3)).toBe(0);
-        expect(resolveTabListKeyAction('End', 0, 3)).toBe(2);
-    });
-    it('skips disabled indices when navigating', () => {
-        expect(resolveTabListKeyAction('ArrowRight', 0, 3, { disabledIndices: [1] })).toBe(2);
-        expect(resolveTabListKeyAction('ArrowLeft', 2, 3, { disabledIndices: [1] })).toBe(0);
-        expect(resolveTabListKeyAction('Home', 2, 3, { disabledIndices: [0] })).toBe(1);
-        expect(resolveTabListKeyAction('End', 0, 3, { disabledIndices: [2] })).toBe(1);
-    });
-});
-describe('resolveMenuTypeahead', () => {
-    const labels = ['Rename', 'Duplicate', 'Delete'];
-    it('returns null for non-printable keys', () => {
-        expect(resolveMenuTypeahead(labels, 0, 'Enter', '')).toBeNull();
-        expect(resolveMenuTypeahead(labels, 0, ' ', 'd')).toBeNull();
-    });
-    it('matches the next item whose label starts with the typed prefix', () => {
-        expect(resolveMenuTypeahead(labels, 0, 'd', '')).toEqual({ index: 1, buffer: 'd' });
-        expect(resolveMenuTypeahead(labels, 1, 'e', 'd')).toEqual({ index: 2, buffer: 'de' });
-    });
-    it('wraps the search from the current index', () => {
-        expect(resolveMenuTypeahead(labels, 2, 'r', '')).toEqual({ index: 0, buffer: 'r' });
-    });
-    it('returns null when no label matches the prefix', () => {
-        expect(resolveMenuTypeahead(labels, 0, 'z', '')).toBeNull();
-    });
-});

package/dist/http/resolveRequest.test.d.ts

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

package/dist/http/resolveRequest.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"resolveRequest.test.d.ts","sourceRoot":"","sources":["../../src/http/resolveRequest.test.ts"],"names":[],"mappings":""}

package/dist/http/resolveRequest.test.js

@@ -1,41 +0,0 @@
-import { describe, expect, it } from '@jest/globals';
-import { resolveRequest } from './resolveRequest.js';
-import { substituteVariables } from './substitute.js';
-describe('substituteVariables', () => {
-    it('replaces known placeholders', () => {
-        expect(substituteVariables('{{host}}/api', { host: 'https://example.com' })).toBe('https://example.com/api');
-    });
-});
-describe('resolveRequest', () => {
-    it('merges collection auth and variables', () => {
-        const context = {
-            draft: {
-                method: 'POST',
-                url: '{{base}}/users',
-                params: [{ key: 'page', value: '1', enabled: true }],
-                headers: [{ key: 'X-Test', value: '1', enabled: true }],
-                body: '{"ok":true}',
-                auth: {
-                    type: 'none',
-                    basic: { username: '', password: '' },
-                    bearer: { token: '' }
-                },
-                body_type: 'json'
-            },
-            response: null,
-            readOnly: true,
-            collectionAuth: {
-                type: 'bearer',
-                basic: { username: '', password: '' },
-                bearer: { token: '{{token}}' }
-            },
-            collectionHeaders: [{ key: 'Accept', value: 'application/json', enabled: true }],
-            variables: { base: 'https://api.test', token: 'secret' },
-            requestKey: 'POST https://api.test/users'
-        };
-        const resolved = resolveRequest(context);
-        expect(resolved.url).toBe('https://api.test/users?page=1');
-        expect(resolved.headers.Authorization).toBe('Bearer secret');
-        expect(resolved.headers['Content-Type']).toBe('application/json');
-    });
-});

package/dist/http/substitute.test.d.ts

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

package/dist/http/substitute.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"substitute.test.d.ts","sourceRoot":"","sources":["../../src/http/substitute.test.ts"],"names":[],"mappings":""}

package/dist/http/substitute.test.js

@@ -1,93 +0,0 @@
-import { describe, expect, it } from '@jest/globals';
-import { resolveAuthVariables, substituteKeyValueRows, substituteVariables } from './substitute.js';
-describe('substituteVariables', () => {
-    it('replaces known placeholders', () => {
-        expect(substituteVariables('{{host}}/api', { host: 'https://example.com' })).toBe('https://example.com/api');
-    });
-    it('allows whitespace inside braces', () => {
-        expect(substituteVariables('{{ host }}/api', { host: 'https://example.com' })).toBe('https://example.com/api');
-    });
-    it('supports dotted and hyphenated keys', () => {
-        expect(substituteVariables('{{api.base}}-{{api-key}}', {
-            'api.base': 'https://example.com',
-            'api-key': 'secret'
-        })).toBe('https://example.com-secret');
-    });
-    it('replaces multiple placeholders in one string', () => {
-        expect(substituteVariables('{{scheme}}://{{host}}/{{path}}', {
-            scheme: 'https',
-            host: 'example.com',
-            path: 'users'
-        })).toBe('https://example.com/users');
-    });
-    it('leaves unknown placeholders unchanged', () => {
-        expect(substituteVariables('{{missing}}/api', { host: 'https://example.com' })).toBe('{{missing}}/api');
-    });
-    it('replaces with empty string when variable is defined as empty', () => {
-        expect(substituteVariables('prefix{{token}}suffix', { token: '' })).toBe('prefixsuffix');
-    });
-    it('returns text unchanged when there are no placeholders', () => {
-        expect(substituteVariables('plain text', { host: 'https://example.com' })).toBe('plain text');
-    });
-    it('resolves dynamic variables when not in the runtime map', () => {
-        const result = substituteVariables('prefix{{$timestamp}}suffix', {});
-        expect(result).not.toContain('{{');
-        expect(result).toMatch(/^prefix\d+suffix$/);
-    });
-    it('prefers runtime variables over dynamic variables', () => {
-        expect(substituteVariables('{{$timestamp}}', { $timestamp: 'fixed' })).toBe('fixed');
-    });
-});
-describe('resolveAuthVariables', () => {
-    const auth = {
-        type: 'basic',
-        basic: {
-            username: '{{user}}',
-            password: '{{pass}}'
-        },
-        bearer: {
-            token: '{{token}}'
-        }
-    };
-    it('substitutes basic and bearer credential fields', () => {
-        const substitute = (text) => text.replace('{{user}}', 'alice').replace('{{pass}}', 'secret').replace('{{token}}', 'tok');
-        expect(resolveAuthVariables(auth, substitute)).toEqual({
-            type: 'basic',
-            basic: {
-                username: 'alice',
-                password: 'secret'
-            },
-            bearer: {
-                token: 'tok'
-            }
-        });
-    });
-    it('preserves auth type and structure', () => {
-        const substitute = (text) => text;
-        const resolved = resolveAuthVariables(auth, substitute);
-        expect(resolved.type).toBe('basic');
-        expect(resolved.basic).toEqual(auth.basic);
-        expect(resolved.bearer).toEqual(auth.bearer);
-    });
-});
-describe('substituteKeyValueRows', () => {
-    it('substitutes values while preserving row metadata', () => {
-        const rows = [
-            { key: 'Accept', value: '{{accept}}', enabled: true },
-            { key: 'X-Api-Key', value: 'static', enabled: false }
-        ];
-        expect(substituteKeyValueRows(rows, { accept: 'application/json' })).toEqual([
-            { key: 'Accept', value: 'application/json', enabled: true },
-            { key: 'X-Api-Key', value: 'static', enabled: false }
-        ]);
-    });
-    it('leaves unknown placeholders in row values', () => {
-        const rows = [{ key: 'Host', value: '{{host}}', enabled: true }];
-        expect(substituteKeyValueRows(rows, {})).toEqual([
-            { key: 'Host', value: '{{host}}', enabled: true }
-        ]);
-    });
-    it('returns an empty array for no rows', () => {
-        expect(substituteKeyValueRows([], { host: 'example.com' })).toEqual([]);
-    });
-});

package/dist/pluginDatabaseApi.test.d.ts

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

package/dist/pluginDatabaseApi.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"pluginDatabaseApi.test.d.ts","sourceRoot":"","sources":["../src/pluginDatabaseApi.test.ts"],"names":[],"mappings":""}

package/dist/pluginDatabaseApi.test.js

@@ -1,65 +0,0 @@
-import { describe, expect, it, jest } from '@jest/globals';
-import { createPluginDatabaseApi } from './runtime/pluginDatabaseApi.js';
-/**
- * Builds a mock database backend for unit tests.
- */
-function createMockBackend() {
-    return {
-        query: jest.fn(async () => undefined),
-        exec: jest.fn(async () => undefined),
-        beginTransaction: jest.fn(async () => 'txn-1'),
-        endTransaction: jest.fn(async () => undefined)
-    };
-}
-describe('createPluginDatabaseApi', () => {
-    it('forwards get, all, and run with the correct query modes', async () => {
-        const backend = createMockBackend();
-        backend.query
-            .mockResolvedValueOnce({ id: 1 })
-            .mockResolvedValueOnce([{ id: 1 }, { id: 2 }])
-            .mockResolvedValueOnce({ changes: 1, lastInsertRowid: 42 });
-        const db = createPluginDatabaseApi(backend);
-        await expect(db.get('SELECT 1', [1])).resolves.toEqual({ id: 1 });
-        await expect(db.all('SELECT *', [2])).resolves.toEqual([{ id: 1 }, { id: 2 }]);
-        await expect(db.run('INSERT INTO t VALUES (?)', [3])).resolves.toEqual({
-            changes: 1,
-            lastInsertRowid: 42
-        });
-        expect(backend.query).toHaveBeenNthCalledWith(1, 'get', 'SELECT 1', [1], undefined);
-        expect(backend.query).toHaveBeenNthCalledWith(2, 'all', 'SELECT *', [2], undefined);
-        expect(backend.query).toHaveBeenNthCalledWith(3, 'run', 'INSERT INTO t VALUES (?)', [3], undefined);
-    });
-    it('forwards exec unchanged', async () => {
-        const backend = createMockBackend();
-        const db = createPluginDatabaseApi(backend);
-        await db.exec('CREATE TABLE t (id INTEGER)');
-        expect(backend.exec).toHaveBeenCalledWith('CREATE TABLE t (id INTEGER)');
-    });
-    it('commits successful transactions and passes txnId to tx helpers', async () => {
-        const backend = createMockBackend();
-        backend.query.mockResolvedValue({ changes: 1, lastInsertRowid: 1 });
-        const db = createPluginDatabaseApi(backend);
-        const result = await db.transaction(async (tx) => {
-            await tx.run('INSERT INTO t VALUES (?)', [1]);
-            await tx.all('SELECT * FROM t');
-            return 'done';
-        });
-        expect(result).toBe('done');
-        expect(backend.beginTransaction).toHaveBeenCalledTimes(1);
-        expect(backend.endTransaction).toHaveBeenCalledWith('txn-1', 'commit');
-        expect(backend.query).toHaveBeenCalledWith('run', 'INSERT INTO t VALUES (?)', [1], 'txn-1');
-        expect(backend.query).toHaveBeenCalledWith('all', 'SELECT * FROM t', undefined, 'txn-1');
-    });
-    it('rolls back failed transactions', async () => {
-        const backend = createMockBackend();
-        const db = createPluginDatabaseApi(backend);
-        const boom = new Error('boom');
-        await expect(db.transaction(async (tx) => {
-            await tx.run('INSERT INTO t VALUES (?)', [1]);
-            throw boom;
-        })).rejects.toThrow(boom);
-        expect(backend.beginTransaction).toHaveBeenCalledTimes(1);
-        expect(backend.endTransaction).toHaveBeenCalledWith('txn-1', 'rollback');
-        expect(backend.endTransaction).not.toHaveBeenCalledWith('txn-1', 'commit');
-    });
-});

package/dist/runtime/index.test.d.ts

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

package/dist/runtime/index.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../src/runtime/index.test.ts"],"names":[],"mappings":""}