@happyvertical/smrt-web 0.42.6 → 0.43.0

package/dist/index.d.ts

@@ -532,6 +532,10 @@ export declare interface RegisterWebMcpToolsOptions {
     basePath?: string;
     /** Injectable fetch (tests / SSR-safe wrappers). */
     fetchFn?: typeof fetch;
+    /** Shared smrt-web cache handle used by page collections. */
+    client?: SmrtWebClient;
+    /** Optional cache scope matching the page collection's scope. */
+    scope?: string;
     /**
      * Override how a definition's CRUD fetchers are built. Defaults to
      * {@link createDefinitionFetchers}; the primary seam for testing `execute`
@@ -571,6 +575,8 @@ export declare interface SmrtCrudFetchers {
     create(data: Record<string, unknown>): Promise<unknown>;
     update?(id: string, data: Record<string, unknown>): Promise<unknown>;
     delete?(id: string): Promise<unknown>;
+    /** Invoke a generated custom action route. */
+    custom?(action: string, args: Record<string, unknown>, route?: SmrtWebToolRouteDescriptor): Promise<unknown>;
 }
 
 /**
@@ -726,6 +732,12 @@ export declare interface SmrtWebCollection<TData extends object> {
      * server outcome (see {@link SmrtWebTransaction}).
      */
     insert(row: SmrtWebRow<TData>): SmrtWebTransaction;
+    /** Optimistically update a row and persist it through the REST surface. */
+    update(key: string, changes: Omit<Partial<SmrtWebRow<TData>>, 'id'>): SmrtWebTransaction;
+    /** Optimistically delete a row and persist it through the REST surface. */
+    delete(key: string): SmrtWebTransaction;
+    /** Execute a custom action and invalidate this collection's related caches. */
+    action(action: string, args: Record<string, unknown>, route?: SmrtWebToolRouteDescriptor): Promise<unknown>;
 }
 
 export declare interface SmrtWebCollectionDefinition<TData extends object = object> {
@@ -1077,6 +1089,17 @@ export declare interface SmrtWebSubscription {
     unsubscribe(): void;
 }
 
+export declare interface SmrtWebToolRouteDescriptor {
+    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    scope: 'item' | 'collection';
+    /** Route segments below the collection endpoint; dynamic segments use `[x]`. */
+    path: string[];
+    /** Transport names rewritten by the tool schema (e.g. `actionId` → `id`). */
+    parameterAliases?: Record<string, string>;
+    /** The generated method accepts one `options` bag as its sole argument. */
+    optionsBag?: boolean;
+}
+
 /**
  * A pending optimistic mutation. Await {@link isPersisted} to observe the
  * server outcome: it resolves once the write has been persisted through the
@@ -1213,6 +1236,8 @@ export declare interface WebToolDescriptor {
     inputSchema: Record<string, unknown>;
     /** True for non-mutating reads → WebMCP `annotations.readOnlyHint`. */
     readOnly: boolean;
+    /** Generated custom-route transport metadata. */
+    route?: SmrtWebToolRouteDescriptor;
 }
 
 /**