@theaiplatform/miniapp-sdk 0.3.3 → 0.4.0

package/dist/testing/tap.test.schema.json

@@ -0,0 +1,361 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://the-ai-platform.dev/schemas/tap.test.schema.json",
+  "title": "The AI Platform miniapp test descriptor",
+  "description": "Strict schema-v2 descriptor for deterministic miniapp test profiles and matrix entries. Required origins, effects, credentials, and capabilities are preflight requirements only and never grant host authority.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "packageId",
+    "configPath",
+    "profiles",
+    "matrix"
+  ],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "const": "https://the-ai-platform.dev/schemas/tap.test.schema.json"
+    },
+    "schemaVersion": {
+      "type": "integer",
+      "const": 2
+    },
+    "packageId": {
+      "$ref": "#/$defs/packageId"
+    },
+    "configPath": {
+      "$ref": "#/$defs/confinedPath"
+    },
+    "testMatch": {
+      "$ref": "#/$defs/testMatch"
+    },
+    "profiles": {
+      "type": "object",
+      "minProperties": 1,
+      "maxProperties": 64,
+      "propertyNames": {
+        "$ref": "#/$defs/id"
+      },
+      "additionalProperties": {
+        "$ref": "#/$defs/profile"
+      }
+    },
+    "matrix": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 256,
+      "items": {
+        "$ref": "#/$defs/matrixEntry"
+      }
+    },
+    "waivers": {
+      "type": "array",
+      "maxItems": 128,
+      "items": {
+        "$ref": "#/$defs/waiver"
+      }
+    }
+  },
+  "$defs": {
+    "trimmed": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 256,
+      "pattern": "^\\S(?:.*\\S)?$"
+    },
+    "id": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "pattern": "^[a-z0-9][a-z0-9._:-]*$"
+    },
+    "actionId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "pattern": "^(?:\\*|do:\\*|[a-z0-9][a-z0-9._:-]*)$"
+    },
+    "capabilityId": {
+      "type": "string",
+      "minLength": 8,
+      "maxLength": 2048,
+      "pattern": "^(?:action:[a-z0-9][a-z0-9._:-]*|effect:[a-z0-9][a-z0-9._-]*:\\S+)$"
+    },
+    "effectToken": {
+      "type": "string",
+      "minLength": 10,
+      "maxLength": 2048,
+      "pattern": "^effect:[a-z0-9][a-z0-9._-]*:\\S+$"
+    },
+    "packageId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 256,
+      "pattern": "^[A-Za-z0-9@][A-Za-z0-9@/._:-]*$"
+    },
+    "confinedPath": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 1024,
+      "pattern": "^(?!/)(?![A-Za-z]:)(?!.*(?:^|/)\\.\\.(?:/|$))(?!.*\\\\)(?!.*//)(?!.*(?:^|/)\\.(?:/|$)).+$"
+    },
+    "confinedGlob": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 1024,
+      "pattern": "^(?!/)(?![A-Za-z]:)(?!.*(?:^|/)\\.\\.(?:/|$))(?!.*\\\\)(?!.*//)(?!.*(?:^|/)\\.(?:/|$)).+$"
+    },
+    "testMatch": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 128,
+      "uniqueItems": true,
+      "items": {
+        "$ref": "#/$defs/confinedGlob"
+      }
+    },
+    "stringIdSet": {
+      "type": "array",
+      "maxItems": 128,
+      "uniqueItems": true,
+      "items": {
+        "$ref": "#/$defs/id"
+      }
+    },
+    "fileSet": {
+      "type": "array",
+      "maxItems": 64,
+      "uniqueItems": true,
+      "items": {
+        "allOf": [
+          {
+            "$ref": "#/$defs/confinedPath"
+          },
+          {
+            "type": "string",
+            "pattern": "\\.json$"
+          }
+        ]
+      }
+    },
+    "originSet": {
+      "type": "array",
+      "maxItems": 128,
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "minLength": 8,
+        "maxLength": 2048,
+        "pattern": "^https?://[^/?#]+$"
+      }
+    },
+    "viewport": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["width", "height"],
+      "properties": {
+        "width": {
+          "type": "integer",
+          "minimum": 320,
+          "maximum": 8192
+        },
+        "height": {
+          "type": "integer",
+          "minimum": 200,
+          "maximum": 8192
+        }
+      }
+    },
+    "environment": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "viewport",
+        "locale",
+        "timezone",
+        "theme",
+        "reducedMotion",
+        "seed"
+      ],
+      "properties": {
+        "viewport": {
+          "$ref": "#/$defs/viewport"
+        },
+        "locale": {
+          "type": "string",
+          "minLength": 2,
+          "maxLength": 64,
+          "pattern": "^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$"
+        },
+        "timezone": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "theme": {
+          "enum": ["light", "dark"]
+        },
+        "reducedMotion": {
+          "type": "boolean"
+        },
+        "seed": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 4294967295
+        },
+        "fixedNow": {
+          "type": "string",
+          "minLength": 20,
+          "maxLength": 64,
+          "format": "date-time",
+          "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,9})?Z$"
+        }
+      }
+    },
+    "capturePolicy": {
+      "enum": ["off", "failure-only", "always"]
+    },
+    "artifacts": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["trace", "screenshots"],
+      "properties": {
+        "trace": {
+          "$ref": "#/$defs/capturePolicy"
+        },
+        "screenshots": {
+          "$ref": "#/$defs/capturePolicy"
+        },
+        "maxBytes": {
+          "type": "integer",
+          "minimum": 1024,
+          "maximum": 67108864
+        }
+      }
+    },
+    "profile": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "surface",
+        "target",
+        "mode",
+        "permissionScenario",
+        "environment",
+        "artifacts"
+      ],
+      "properties": {
+        "surface": {
+          "$ref": "#/$defs/id"
+        },
+        "target": {
+          "enum": [
+            "desktop",
+            "mobile",
+            "quickjs",
+            "worker",
+            "node",
+            "workflow-host"
+          ]
+        },
+        "mode": {
+          "enum": ["surface", "live"]
+        },
+        "permissionScenario": {
+          "$ref": "#/$defs/id"
+        },
+        "deniedActions": {
+          "type": "array",
+          "maxItems": 128,
+          "uniqueItems": true,
+          "items": {
+            "$ref": "#/$defs/actionId"
+          }
+        },
+        "fixtureFiles": {
+          "$ref": "#/$defs/fileSet"
+        },
+        "httpRouteFiles": {
+          "$ref": "#/$defs/fileSet"
+        },
+        "requiredOrigins": {
+          "$ref": "#/$defs/originSet"
+        },
+        "requiredEffects": {
+          "type": "array",
+          "maxItems": 128,
+          "uniqueItems": true,
+          "items": {
+            "$ref": "#/$defs/effectToken"
+          }
+        },
+        "credentialSlots": {
+          "type": "array",
+          "maxItems": 64,
+          "uniqueItems": true,
+          "items": {
+            "$ref": "#/$defs/id"
+          }
+        },
+        "environment": {
+          "$ref": "#/$defs/environment"
+        },
+        "artifacts": {
+          "$ref": "#/$defs/artifacts"
+        }
+      }
+    },
+    "matrixEntry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "profile"],
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/id"
+        },
+        "profile": {
+          "$ref": "#/$defs/id"
+        },
+        "testMatch": {
+          "$ref": "#/$defs/testMatch"
+        },
+        "capabilities": {
+          "type": "array",
+          "maxItems": 128,
+          "uniqueItems": true,
+          "items": {
+            "$ref": "#/$defs/capabilityId"
+          }
+        }
+      }
+    },
+    "waiver": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["capability", "reason"],
+      "properties": {
+        "capability": {
+          "$ref": "#/$defs/capabilityId"
+        },
+        "reason": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 2048,
+          "pattern": "^\\S(?:[\\s\\S]*\\S)?$"
+        },
+        "issue": {
+          "type": "string",
+          "minLength": 8,
+          "maxLength": 2048,
+          "format": "uri"
+        },
+        "expiresAt": {
+          "type": "string",
+          "maxLength": 64,
+          "format": "date-time"
+        }
+      }
+    }
+  }
+}

package/dist/ui/wasm.js

@@ -9313,7 +9313,8 @@ const iconVariants = cva('', {
 });
 function icon_Icon({ className, color, icon: IconComponent, size, ...props }) {
     const iconSize = ICON_SIZES[size ?? 'default'];
-    return /*#__PURE__*/ __rspack_external_react.createElement(IconComponent, {
+    const RenderIcon = IconComponent;
+    return /*#__PURE__*/ __rspack_external_react.createElement(RenderIcon, {
         "aria-hidden": "true",
         size: iconSize,
         className: utils_cn(iconVariants({

package/dist/ui.d.ts

@@ -9,7 +9,6 @@ import { GroupProps } from 'react-resizable-panels';
 import { HTMLAttributes } from 'react';
 import { JSX } from 'react/jsx-runtime';
 import * as LabelPrimitive from '@radix-ui/react-label';
-import type { LucideIcon } from 'lucide-react';
 import { PanelProps } from 'react-resizable-panels';
 import * as ProgressPrimitive from '@radix-ui/react-progress';
 import * as RadioGroupPrimitive from '@radix-ui/react-radio-group';
@@ -429,8 +428,19 @@ declare const headingVariants: (props?: ({
  */
 export declare function Icon({ className, color, icon: IconComponent, size, ...props }: IconProps): JSX.Element;
 
-declare interface IconProps extends Omit<React_2.ComponentPropsWithoutRef<LucideIcon>, 'color' | 'size'>, VariantProps<typeof iconVariants> {
-    icon: LucideIcon;
+/**
+ * Patch-stable callable shape for Lucide-compatible icons.
+ *
+ * Lucide's public `LucideIcon` type embeds the physical React type instance
+ * from its installation. Re-exporting it makes linked SDKs reject otherwise
+ * compatible consumer Lucide/React patches. The never-argument callable
+ * proves this is a component without coupling its props or return value.
+ */
+export declare type IconComponent = (...arguments_: never[]) => unknown;
+
+export declare interface IconProps extends Omit<React_2.SVGProps<SVGSVGElement>, 'absoluteStrokeWidth' | 'color' | 'ref' | 'size'>, VariantProps<typeof iconVariants> {
+    absoluteStrokeWidth?: boolean;
+    icon: IconComponent;
 }
 
 /**
@@ -520,7 +530,7 @@ export declare namespace MiniAppIconButton {
 }
 
 export declare interface MiniAppIconButtonProps extends Omit<ButtonProps, 'children'> {
-    icon: LucideIcon;
+    icon: IconComponent;
     label: string;
     tooltipSide?: React_2.ComponentProps<typeof TooltipContent>['side'];
 }

package/dist/ui.js

@@ -9727,7 +9727,8 @@ const iconVariants = cva('', {
 });
 function icon_Icon({ className, color, icon: IconComponent, size, ...props }) {
     const iconSize = ICON_SIZES[size ?? 'default'];
-    return /*#__PURE__*/ __rspack_external_react.createElement(IconComponent, {
+    const RenderIcon = IconComponent;
+    return /*#__PURE__*/ __rspack_external_react.createElement(RenderIcon, {
         "aria-hidden": "true",
         size: iconSize,
         className: cn(iconVariants({

package/dist/vscode-webview.d.ts

@@ -10,6 +10,19 @@ declare type MiniAppJsonValue = null | boolean | number | string | MiniAppJsonVa
  */
 export declare function mountVsCodeWebview(container: HTMLElement, context: TapFederatedSurfaceMountContext, options: TapVsCodeWebviewBridgeOptions): TapVsCodeWebviewMount;
 
+/**
+ * Host-owned entropy for release-scoped identifiers.
+ *
+ * Ordinary TAP surfaces use the browser's cryptographically strong UUID
+ * source. Test Lab mounts derive a deterministic stream from the selected
+ * profile seed and exact frame identity, then reset it before each mount so
+ * app-owned state is reproducible without weakening production identifiers,
+ * colliding across retained remounts, or relying on ambient test globals.
+ */
+declare interface TapFederatedSurfaceEntropy {
+    randomUUID(): string;
+}
+
 /**
  * Read-only authority projected by TAP for the exact package release/frame.
  * A candidate frame starts without authority and may only perform host-backed
@@ -40,6 +53,7 @@ declare interface TapFederatedSurfaceMountContext {
     readonly channelId?: string;
     readonly conversationId?: string;
     readonly events: TapPackageEventPublisher;
+    readonly entropy: TapFederatedSurfaceEntropy;
     readonly hostAuthority: TapFederatedSurfaceHostAuthority;
 }
 

package/dist/web.d.ts

@@ -136,6 +136,29 @@ declare type MiniAppAuthApi = {
     getUserProfile(): MiniAppMaybePromise<MiniAppUserProfile | null>;
 };
 
+/**
+ * Read-only authorization introspection for custom surface behavior.
+ *
+ * The host rejects action IDs that are not declared by the exact mounted
+ * surface. A declared action resolves to the current dynamic allow/deny
+ * decision without executing the action.
+ */
+declare type MiniAppAuthorizationApi = {
+    check(options: MiniAppAuthorizationCheckOptions): Promise<MiniAppAuthorizationCheckResult>;
+};
+
+/** Canonical autonomy requested for one descriptor-declared package action. */
+declare type MiniAppAuthorizationAutonomy = 'listen' | 'plan' | 'do';
+
+declare type MiniAppAuthorizationCheckOptions = {
+    actionId: string;
+    autonomy: MiniAppAuthorizationAutonomy;
+};
+
+declare type MiniAppAuthorizationCheckResult = {
+    allowed: boolean;
+};
+
 /**
  * @capability miniapp-platform
  */
@@ -358,6 +381,7 @@ export declare type MiniAppPlatformApi = {
     navigation: {
         open(options: OpenNavigationOptions): void | Promise<void>;
     };
+    authorization: MiniAppAuthorizationApi;
     chat: MiniAppChatApi;
     storage: MiniAppStorageApi;
     session: MiniAppSessionApi;

package/package.json

@@ -1,8 +1,12 @@
 {
   "name": "@theaiplatform/miniapp-sdk",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "description": "TypeScript SDK for building, testing, and shipping portable miniapps on The AI Platform.",
+  "tapMiniappTestAdapterProtocol": 1,
   "type": "module",
+  "bin": {
+    "tap-miniapp-test": "./dist/bin/tap-miniapp-test.js"
+  },
   "engines": {
     "node": ">=20"
   },
@@ -67,7 +71,12 @@
     "./testing/rstest": {
       "types": "./dist/testing/rstest.d.ts",
       "import": "./dist/testing/rstest.js"
-    }
+    },
+    "./testing/rstest-config": {
+      "types": "./dist/testing/rstest-config.d.ts",
+      "import": "./dist/testing/rstest-config.js"
+    },
+    "./testing/tap.test.schema.json": "./dist/testing/tap.test.schema.json"
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -82,7 +91,7 @@
   ],
   "scripts": {
     "prepack": "pnpm run build",
-    "build": "rm -rf dist && rslib build && node scripts/copy-rspack-loaders.mjs && node scripts/build-ui-styles.mjs",
+    "build": "rm -rf dist && rslib build && node scripts/copy-tap-test-schema.mjs && node scripts/copy-rspack-loaders.mjs && node scripts/build-ui-styles.mjs",
     "test:unit": "rstest run",
     "typecheck": "tsc6 --noEmit"
   },
@@ -140,7 +149,12 @@
       "./testing/rstest": {
         "types": "./dist/testing/rstest.d.ts",
         "import": "./dist/testing/rstest.js"
-      }
+      },
+      "./testing/rstest-config": {
+        "types": "./dist/testing/rstest-config.d.ts",
+        "import": "./dist/testing/rstest-config.js"
+      },
+      "./testing/tap.test.schema.json": "./dist/testing/tap.test.schema.json"
     }
   },
   "peerDependencies": {