@happyvertical/smrt-types 0.45.3 → 0.47.0

package/dist/index.d.ts

@@ -577,6 +577,12 @@ export declare interface DomainKnowledgeObject {
     tableStrategy?: 'cti' | 'sti';
     conflictColumns?: string[];
     surfaces: DomainKnowledgeSurface[];
+    /**
+     * Public methods a generated surface withheld, with the reason for each.
+     * Omitted entirely when nothing was withheld, so an artifact for a fully
+     * exposed object is unchanged (#2686).
+     */
+    withheldSurfaces?: DomainKnowledgeWithheldSurface[];
     relationshipFeatures: string[];
     tags: string[];
     summary?: string;
@@ -656,6 +662,29 @@ export declare interface DomainKnowledgeViewIntent {
     sourceFile: string;
 }
 
+/**
+ * A public method a generated surface deliberately does NOT expose, and why.
+ *
+ * Silence is the failure mode this closes: before #2686 a method that produced
+ * no route simply did not appear, leaving an author to guess whether they had
+ * mistyped a name, hit an `exclude`, or written a signature no HTTP caller can
+ * satisfy. `reason` is human-readable prose; `code` is the stable key to react
+ * to programmatically.
+ */
+export declare interface DomainKnowledgeWithheldSurface {
+    kind: DomainKnowledgeSurfaceKind;
+    /** The method name that was withheld. */
+    operation: string;
+    /**
+     * Stable rejection key — `not-wireable`, `excluded`, `not-included`,
+     * `withheld`, `lifecycle-method`, `no-receiver`, `api-disabled`.
+     */
+    code: string;
+    /** Human-readable explanation, e.g. why a parameter cannot cross a wire. */
+    reason: string;
+    objectName?: string;
+}
+
 /** User↔Tenant↔Role junction. Runtime class: `@happyvertical/smrt-users:Membership`. */
 export declare interface Membership extends SmrtEntityFields {
     userId?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-types",
-  "version": "0.45.3",
+  "version": "0.47.0",
   "description": "Shared type definitions for the HAVE SDK",
   "type": "module",
   "main": "./dist/index.js",