simple-webmcp 0.1.0 → 0.3.0

package/dist/{types-D-cwSfEU.d.cts → types-CF8kTj5O.d.cts}

@@ -1,3 +1,55 @@
+type MaybePromise<T> = T | Promise<T>;
+type HookBaseContext<F extends (...args: any) => any> = {
+    invocationId: string;
+    tool: WebMCPTool<F>;
+    contract: ToolContract;
+    signal: AbortSignal;
+    /**
+     * Mutable bag shared across all hooks in a single invocation.
+     * Hooks may read/write to communicate (e.g., startTime, tenantId).
+     * Same reference for before → after/error/denied within one invocation.
+     */
+    metadata: Record<string, unknown>;
+};
+type BeforeContext<F extends (...args: any) => any> = HookBaseContext<F> & {
+    input: unknown;
+};
+type AfterContext<F extends (...args: any) => any> = HookBaseContext<F> & {
+    input: unknown;
+    output: Awaited<ReturnType<F>>;
+};
+type ErrorContext<F extends (...args: any) => any> = HookBaseContext<F> & {
+    input: unknown;
+    error: unknown;
+};
+type DeniedContext<F extends (...args: any) => any> = HookBaseContext<F> & {
+    input: unknown;
+    reason?: string;
+    code?: string;
+};
+type BeforeHookResult = void | {
+    input?: unknown;
+} | {
+    action: 'deny';
+    message?: string;
+    code?: string;
+};
+type AfterHookResult<F extends (...args: any) => any> = void | {
+    output?: Awaited<ReturnType<F>>;
+};
+type ErrorHookResult = void;
+type DeniedHookResult = void;
+type BeforeHook<F extends (...args: any) => any> = (ctx: BeforeContext<F>) => MaybePromise<BeforeHookResult>;
+type AfterHook<F extends (...args: any) => any> = (ctx: AfterContext<F>) => MaybePromise<AfterHookResult<F>>;
+type ErrorHook<F extends (...args: any) => any> = (ctx: ErrorContext<F>) => MaybePromise<ErrorHookResult>;
+type DeniedHook<F extends (...args: any) => any> = (ctx: DeniedContext<F>) => MaybePromise<DeniedHookResult>;
+type WebMCPHooks<F extends (...args: any) => any> = {
+    before?: BeforeHook<F>[];
+    after?: AfterHook<F>[];
+    error?: ErrorHook<F>[];
+    denied?: DeniedHook<F>[];
+};
+
 /**
  * Minimal JSON Schema type used for WebMCP input/output schemas.
  * We keep it loose (Partial) to avoid hard dependency on a specific draft.
@@ -61,6 +113,7 @@ type ToolContract = {
     outputSchema?: JsonSchema;
     annotations?: WebMCPAnnotations;
 };
+
 type WebMCPOptions<F extends (...args: any) => any> = {
     /** Override tool name. Default: fn.name → snake_case */
     name?: string;
@@ -89,6 +142,8 @@ type WebMCPOptions<F extends (...args: any) => any> = {
     enabled?: boolean;
     /** If true, ambiguous inference throws instead of warn */
     strict?: boolean;
+    /** Lifecycle hooks — before/after/error/denied (agent execute only, not direct call) */
+    hooks?: WebMCPHooks<F>;
 };
 type WebMCPTool<F extends (...args: any) => any> = F & {
     readonly __webmcpBrand: true;
@@ -108,8 +163,12 @@ type WebMCPTool<F extends (...args: any) => any> = F & {
     readonly __fn: F;
     readonly __standardSchema?: StandardSchemaV1;
     readonly __outputStandardSchema?: StandardSchemaV1;
+    readonly __hooks?: WebMCPHooks<F>;
+    readonly __webmcpOptions?: WebMCPOptions<F>;
+    readonly __activeSignal?: AbortSignal;
+    readonly __scopeHooks?: WebMCPHooks<any>;
 };
-type RegistrationStatus = 'unregistered' | 'registering' | 'registered' | 'unregistering' | 'error';
+type RegistrationStatus = 'unregistered' | 'registering' | 'registered' | 'unregistering' | 'error' | 'unsupported';
 type ModelContextLike = {
     registerTool: (def: {
         name: string;
@@ -123,4 +182,4 @@ type ModelContextLike = {
     }) => Promise<void>;
 };
 
-export type { FieldDefOrSchema as F, JsonSchema as J, ModelContextLike as M, RegistrationStatus as R, StandardSchemaV1 as S, ToolContract as T, WebMCPOptions as W, WebMCPTool as a, FieldDef as b, WebMCPAnnotations as c };
+export type { AfterContext as A, BeforeContext as B, DeniedContext as D, ErrorContext as E, FieldDefOrSchema as F, JsonSchema as J, ModelContextLike as M, RegistrationStatus as R, StandardSchemaV1 as S, ToolContract as T, WebMCPTool as W, WebMCPOptions as a, WebMCPHooks as b, AfterHook as c, BeforeHook as d, DeniedHook as e, ErrorHook as f, FieldDef as g, WebMCPAnnotations as h };

package/dist/{types-D-cwSfEU.d.ts → types-CF8kTj5O.d.ts}

@@ -1,3 +1,55 @@
+type MaybePromise<T> = T | Promise<T>;
+type HookBaseContext<F extends (...args: any) => any> = {
+    invocationId: string;
+    tool: WebMCPTool<F>;
+    contract: ToolContract;
+    signal: AbortSignal;
+    /**
+     * Mutable bag shared across all hooks in a single invocation.
+     * Hooks may read/write to communicate (e.g., startTime, tenantId).
+     * Same reference for before → after/error/denied within one invocation.
+     */
+    metadata: Record<string, unknown>;
+};
+type BeforeContext<F extends (...args: any) => any> = HookBaseContext<F> & {
+    input: unknown;
+};
+type AfterContext<F extends (...args: any) => any> = HookBaseContext<F> & {
+    input: unknown;
+    output: Awaited<ReturnType<F>>;
+};
+type ErrorContext<F extends (...args: any) => any> = HookBaseContext<F> & {
+    input: unknown;
+    error: unknown;
+};
+type DeniedContext<F extends (...args: any) => any> = HookBaseContext<F> & {
+    input: unknown;
+    reason?: string;
+    code?: string;
+};
+type BeforeHookResult = void | {
+    input?: unknown;
+} | {
+    action: 'deny';
+    message?: string;
+    code?: string;
+};
+type AfterHookResult<F extends (...args: any) => any> = void | {
+    output?: Awaited<ReturnType<F>>;
+};
+type ErrorHookResult = void;
+type DeniedHookResult = void;
+type BeforeHook<F extends (...args: any) => any> = (ctx: BeforeContext<F>) => MaybePromise<BeforeHookResult>;
+type AfterHook<F extends (...args: any) => any> = (ctx: AfterContext<F>) => MaybePromise<AfterHookResult<F>>;
+type ErrorHook<F extends (...args: any) => any> = (ctx: ErrorContext<F>) => MaybePromise<ErrorHookResult>;
+type DeniedHook<F extends (...args: any) => any> = (ctx: DeniedContext<F>) => MaybePromise<DeniedHookResult>;
+type WebMCPHooks<F extends (...args: any) => any> = {
+    before?: BeforeHook<F>[];
+    after?: AfterHook<F>[];
+    error?: ErrorHook<F>[];
+    denied?: DeniedHook<F>[];
+};
+
 /**
  * Minimal JSON Schema type used for WebMCP input/output schemas.
  * We keep it loose (Partial) to avoid hard dependency on a specific draft.
@@ -61,6 +113,7 @@ type ToolContract = {
     outputSchema?: JsonSchema;
     annotations?: WebMCPAnnotations;
 };
+
 type WebMCPOptions<F extends (...args: any) => any> = {
     /** Override tool name. Default: fn.name → snake_case */
     name?: string;
@@ -89,6 +142,8 @@ type WebMCPOptions<F extends (...args: any) => any> = {
     enabled?: boolean;
     /** If true, ambiguous inference throws instead of warn */
     strict?: boolean;
+    /** Lifecycle hooks — before/after/error/denied (agent execute only, not direct call) */
+    hooks?: WebMCPHooks<F>;
 };
 type WebMCPTool<F extends (...args: any) => any> = F & {
     readonly __webmcpBrand: true;
@@ -108,8 +163,12 @@ type WebMCPTool<F extends (...args: any) => any> = F & {
     readonly __fn: F;
     readonly __standardSchema?: StandardSchemaV1;
     readonly __outputStandardSchema?: StandardSchemaV1;
+    readonly __hooks?: WebMCPHooks<F>;
+    readonly __webmcpOptions?: WebMCPOptions<F>;
+    readonly __activeSignal?: AbortSignal;
+    readonly __scopeHooks?: WebMCPHooks<any>;
 };
-type RegistrationStatus = 'unregistered' | 'registering' | 'registered' | 'unregistering' | 'error';
+type RegistrationStatus = 'unregistered' | 'registering' | 'registered' | 'unregistering' | 'error' | 'unsupported';
 type ModelContextLike = {
     registerTool: (def: {
         name: string;
@@ -123,4 +182,4 @@ type ModelContextLike = {
     }) => Promise<void>;
 };
 
-export type { FieldDefOrSchema as F, JsonSchema as J, ModelContextLike as M, RegistrationStatus as R, StandardSchemaV1 as S, ToolContract as T, WebMCPOptions as W, WebMCPTool as a, FieldDef as b, WebMCPAnnotations as c };
+export type { AfterContext as A, BeforeContext as B, DeniedContext as D, ErrorContext as E, FieldDefOrSchema as F, JsonSchema as J, ModelContextLike as M, RegistrationStatus as R, StandardSchemaV1 as S, ToolContract as T, WebMCPTool as W, WebMCPOptions as a, WebMCPHooks as b, AfterHook as c, BeforeHook as d, DeniedHook as e, ErrorHook as f, FieldDef as g, WebMCPAnnotations as h };

package/dist/zod.d.cts

@@ -1,4 +1,4 @@
-import { J as JsonSchema } from './types-D-cwSfEU.cjs';
+import { J as JsonSchema } from './types-CF8kTj5O.cjs';
 
 /**
  * simple-webmcp/zod — optional Zod → JSON Schema converter

package/dist/zod.d.ts

@@ -1,4 +1,4 @@
-import { J as JsonSchema } from './types-D-cwSfEU.js';
+import { J as JsonSchema } from './types-CF8kTj5O.js';
 
 /**
  * simple-webmcp/zod — optional Zod → JSON Schema converter

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "simple-webmcp",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Turn any JS/TS function into a WebMCP tool — function-first, type-safe, lean. One line: webmcp(fn) still callable, auto-registers with React lifecycle or globally.",
   "type": "module",
   "keywords": [
@@ -41,10 +41,28 @@
       "import": "./dist/polyfill.js",
       "require": "./dist/polyfill.cjs"
     },
+    "./dev-polyfill": {
+      "import": "./dist/dev-polyfill.js",
+      "require": "./dist/dev-polyfill.cjs"
+    },
+    "./testing": {
+      "import": "./dist/testing.js",
+      "require": "./dist/testing.cjs"
+    },
     "./zod": {
       "types": "./dist/zod.d.ts",
       "import": "./dist/zod.js",
       "require": "./dist/zod.cjs"
+    },
+    "./inspect": {
+      "types": "./dist/inspect.d.ts",
+      "import": "./dist/inspect.js",
+      "require": "./dist/inspect.cjs"
+    },
+    "./devtools": {
+      "types": "./dist/devtools.d.ts",
+      "import": "./dist/devtools.js",
+      "require": "./dist/devtools.cjs"
     }
   },
   "main": "./dist/index.cjs",
@@ -68,6 +86,14 @@
     "docs:dev": "vitepress dev docs",
     "docs:build": "vitepress build docs",
     "docs:preview": "vitepress preview docs",
+    "changeset": "changeset",
+    "changeset:version": "changeset version",
+    "changeset:publish": "changeset publish",
+    "release": "npm run build && npm run typecheck && npm test && changeset publish",
+    "release:manual:patch": "npm version patch -m 'chore(release): %s' && git push --follow-tags && echo 'Tag pushed — release.yml will publish'",
+    "release:manual:minor": "npm version minor -m 'chore(release): %s' && git push --follow-tags && echo 'Tag pushed — release.yml will publish'",
+    "release:manual:major": "npm version major -m 'chore(release): %s' && git push --follow-tags && echo 'Tag pushed — release.yml will publish'",
+    "changelog": "conventional-changelog -p angular -i CHANGELOG.md -s",
     "prepublishOnly": "npm run build && npm run typecheck && npm test",
     "prepare": "npm run build"
   },
@@ -80,9 +106,12 @@
     }
   },
   "devDependencies": {
+    "@changesets/changelog-github": "^0.5.2",
+    "@changesets/cli": "^2.31.1",
     "@testing-library/react": "^14.3.1",
     "@types/node": "^22.7.4",
     "@types/react": "^18.3.12",
+    "conventional-changelog-cli": "^5.0.0",
     "jsdom": "^25.0.1",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",