@salsita-ai/sdk 0.50.0-develop.b7caacb493 → 0.50.0-develop.b929a82a82

package/dist/docs/phoenix/webhooks.mdx

@@ -36,7 +36,11 @@ Phoenix provides domain-aware builders through the global `phx.webhooks` namespa
 
 Your webhook is the default export of `src/webhooks/index.ts`. With the application-spec pipeline (see [Current and legacy project tooling](?path=/docs/phoenix-phoenix-cli--docs#current-and-legacy-project-tooling)), the file is yours to create; sync does not write it. A project without it gets a built-in webhook, so it builds and deploys with no webhook code. The built-in webhook has one handler, an anonymous auth handler, which the platform calls only when `spec/application.yaml` sets `useAuthHook`. The legacy pipeline writes the file with that webhook on the first sync.
 
-Create `src/webhooks/index.ts` when the project needs its own handlers: finalization, backend data, or an auth handler that does more than start an anonymous session. A project that sets `useAuthHook` or `useClerk` needs its own auth handler, because the built-in one answers only anonymous requests. The smallest file is the built-in webhook itself:
+Create `src/webhooks/index.ts` when the project needs its own handlers: finalization, backend data, or an auth handler that does more than start an anonymous session.
+
+If `useAuthHook` or `useClerk` is enabled without this file, sync, build, clean and dev report `AUTH_WITHOUT_PROJECT_WEBHOOK` and generation continues with the anonymous-only built-in webhook. This warning also applies when `useAuthHook: false` is explicit alongside `useClerk: true`. Add a default-exported webhook with the required Clerk or custom auth handlers, or disable the settings if they are unintended.
+
+The smallest file is the built-in webhook itself:
 
 ```ts
 // src/webhooks/index.ts
@@ -1374,6 +1378,10 @@ export const emailTask = phx.webhooks.taskFactory.createSendEmailTask((resources
 
 The Backend Data Handler allows you to fetch data on the server that will be automatically made available both in the domain (client-side) and in webhook contexts. Its main purpose is to securely fetch data using API keys or other sensitive credentials that cannot be exposed to the client, while making that data available throughout your application.
 
+Responses of at least 32 KiB are automatically gzip-compressed when the caller accepts gzip and the base64 representation is smaller. Project handlers return the same `backendData` object; the API and configurator receive decoded JSON. This also works through `phoenix dev` when both the server and CLI support gzip. Older tunnel clients keep plain JSON.
+
+Compression does not remove platform limits: the complete encoded development-tunnel request must fit within 5 MiB, and deployed webhooks remain subject to Lambda's buffered response limit. The tunnel accepts up to 100 MiB of decoded gzip data. Data that does not compress enough must be reduced or split. Binary responses appear as a byte-count placeholder in the development tunnel inspector.
+
 ### Defining a Backend Data Handler
 
 Backend data handlers are defined inline in the webhook builder:

package/dist/docs/recipes-and-delete/delete-entity.mdx

@@ -58,9 +58,9 @@ invariants:
 **Dry run behavior:**
 
 - Recipe validation: Each recipe shows violation hints based on what would happen if executed
-- Fatal violations: Recipes that would cause fatal violations are disabled and cannot be clicked
-- Warning violations: Recipes that cause warnings show indicators but remain clickable
-- Fixable violations: Violations listed in fixableViolations are ignored in the UI hints
+- Fatal and fixable violations: Recipes that would cause a `fatal` or `fixable` violation are disabled and cannot be clicked
+- Warning and notice violations: Recipes that cause only `warning` or `notice` violations stay clickable and show no hint
+- Fixable violations: Violation types listed in `fixableViolations` are left out of the hint text; the recipe stays disabled
 
 ## TypeScript Interfaces
 
@@ -227,7 +227,6 @@ components:
 
 ```ts
 import { createPlate } from '../../../../common/plate-rendering.js'
-import { phx } from '../../.phoenix/phx.js'
 
 export default phx.domain.implementCustomExpressions({
   Hole: {
@@ -275,8 +274,6 @@ export default phx.domain.implementCustomExpressions({
 ### ./src/invariants/plate.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomInvariants({
   Plate: {
     one54: s => {

package/dist/docs/recipes-and-delete/dynamic-root-entity.mdx

@@ -205,8 +205,6 @@ components:
 ```ts
 import { memoOnce } from '@salsita-ai/sdk/common/utils'
 
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomExpressions({
   BuckyBall: {
     $replaceRecipes: memoOnce(() => [

package/dist/docs/recipes-and-delete/grouped-button.mdx

@@ -293,7 +293,6 @@ components:
 
 ```ts
 import { createPlate } from '../../../../common/plate-rendering.js'
-import { phx } from '../../.phoenix/phx.js'
 
 export default phx.domain.implementCustomExpressions({
   Hole: {
@@ -406,8 +405,6 @@ export default phx.domain.implementCustomExpressions({
 ### ./src/invariants/invariants.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomInvariants({
   Plate: {
     noOvals: s => {

package/dist/docs/recipes-and-delete/grouped-panel.mdx

@@ -407,7 +407,6 @@ components:
 
 ```ts
 import { createPlate } from '../../../../common/plate-rendering.js'
-import { phx } from '../../.phoenix/phx.js'
 
 export default phx.domain.implementCustomExpressions({
   Hole: {
@@ -520,8 +519,6 @@ export default phx.domain.implementCustomExpressions({
 ### ./src/invariants/invariants.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomInvariants({
   Plate: {
     noOvals: s => {

package/dist/docs/recipes-and-delete/horizontal.mdx

@@ -149,9 +149,9 @@ invariants:
 **Dry run behavior:**
 
 - Recipe validation: Each recipe shows violation hints based on what would happen if executed
-- Fatal violations: Recipes that would cause fatal violations are disabled and cannot be clicked
-- Warning violations: Recipes that cause warnings show indicators but remain clickable
-- Fixable violations: Violations listed in fixableViolations are ignored in the UI hints
+- Fatal and fixable violations: Recipes that would cause a `fatal` or `fixable` violation are disabled and cannot be clicked
+- Warning and notice violations: Recipes that cause only `warning` or `notice` violations stay clickable and show no hint
+- Fixable violations: Violation types listed in `fixableViolations` are left out of the hint text; the recipe stays disabled
 
 ## TypeScript Interfaces
 
@@ -456,7 +456,6 @@ invariants:
 
 ```ts
 import { createPlate } from '../../../../common/plate-rendering.js'
-import { phx } from '../../.phoenix/phx.js'
 
 export default phx.domain.implementCustomExpressions({
   Hole: {
@@ -580,8 +579,6 @@ export default phx.domain.implementCustomExpressions({
 ### ./src/invariants/invariants.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomInvariants({
   Plate: {
     noOvals: s => {

package/dist/docs/recipes-and-delete/recipe-hierarchy-lists.mdx

@@ -514,7 +514,6 @@ transformers:
 ```ts
 import { getConsoleRenderingComponents } from '../../../../common/console-rendering.js'
 import { getMonitorRenderingComponents } from '../../../../common/monitor-rendering.js'
-import { phx } from '../../.phoenix/phx.js'
 
 export default [
   ...getConsoleRenderingComponents('Console', phx.domain.attachComponent),
@@ -527,8 +526,6 @@ export default [
 ```ts
 import type { DomainEntityId } from '@salsita-ai/sdk/domain'
 
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomExpressions({
   Room: {
     $childRecipes: s => {

package/dist/docs/recipes-and-delete/recipe-hierarchy-selection.mdx

@@ -359,7 +359,6 @@ transformers:
 ```ts
 import { getConsoleRenderingComponents } from '../../../../common/console-rendering.js'
 import { getMonitorRenderingComponents } from '../../../../common/monitor-rendering.js'
-import { phx } from '../../.phoenix/phx.js'
 
 export default [
   ...getConsoleRenderingComponents('RedSpecialConsole', phx.domain.attachComponent, '#CC0000'),
@@ -373,8 +372,6 @@ export default [
 ```ts
 import type { DomainEntityId } from '@salsita-ai/sdk/domain'
 
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomExpressions({
   Room: {
     $specialConsoleOptions: () => {
@@ -427,8 +424,6 @@ export default phx.domain.implementCustomExpressions({
 ### ./src/transformers/deselect-special.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.frontend.transformerBuilder.when
   .entity(['RedSpecialConsole', 'BlueSpecialConsole'])
   .replacedWith(['RedSpecialConsole', 'BlueSpecialConsole'])

package/dist/docs/recipes-and-delete/replace-dropdown.mdx

@@ -137,9 +137,9 @@ invariants:
 **Dry run behavior:**
 
 - Recipe validation: Each recipe shows violation hints based on what would happen if executed
-- Fatal violations: Recipes that would cause fatal violations are disabled and cannot be clicked
-- Warning violations: Recipes that cause warnings show indicators but remain clickable
-- Fixable violations: Violations listed in fixableViolations are ignored in the UI hints
+- Fatal and fixable violations: Recipes that would cause a `fatal` or `fixable` violation are disabled and cannot be clicked
+- Warning and notice violations: Recipes that cause only `warning` or `notice` violations stay clickable and show no hint
+- Fixable violations: Violation types listed in `fixableViolations` are left out of the hint text; the recipe stays disabled
 
 ## TypeScript Interfaces
 
@@ -482,7 +482,6 @@ components:
 
 ```ts
 import { createPlate } from '../../../../common/plate-rendering.js'
-import { phx } from '../../.phoenix/phx.js'
 
 export default phx.domain.implementCustomExpressions({
   Hole: {
@@ -708,8 +707,6 @@ export default phx.domain.implementCustomExpressions({
 ### ./src/invariants/invariants.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomInvariants({
   Plate: {
     noOvals: s => {

package/dist/docs/recipes-and-delete/replace-panel.mdx

@@ -486,8 +486,6 @@ components:
 ### ./src/expressions/feature.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomExpressions({
   Feature: {
     $circularRecipes: s => {
@@ -586,8 +584,6 @@ export default phx.domain.implementCustomExpressions({
 ### ./src/expressions/hole.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomExpressions({
   Hole: {
     $radius: () => 10,
@@ -605,7 +601,6 @@ export default phx.domain.implementCustomExpressions({
 
 ```ts
 import { createPlate } from '../../../../common/plate-rendering.js'
-import { phx } from '../../.phoenix/phx.js'
 
 export default phx.domain.implementCustomExpressions({
   Plate: {
@@ -709,8 +704,6 @@ export default phx.domain.implementCustomExpressions({
 ### ./src/invariants/invariants.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomInvariants({
   Plate: {
     noOvals: s => {

package/dist/docs/recipes-and-delete/simple.mdx

@@ -150,9 +150,9 @@ invariants:
 **Dry run behavior:**
 
 - Recipe validation: Each recipe shows violation hints based on what would happen if executed
-- Fatal violations: Recipes that would cause fatal violations are disabled and cannot be clicked
-- Warning violations: Recipes that cause warnings show indicators but remain clickable
-- Fixable violations: Violations listed in fixableViolations are ignored in the UI hints
+- Fatal and fixable violations: Recipes that would cause a `fatal` or `fixable` violation are disabled and cannot be clicked
+- Warning and notice violations: Recipes that cause only `warning` or `notice` violations stay clickable and show no hint
+- Fixable violations: Violation types listed in `fixableViolations` are left out of the hint text; the recipe stays disabled
 
 ## TypeScript Interfaces
 
@@ -473,7 +473,6 @@ components:
 
 ```ts
 import { createPlate } from '../../../../common/plate-rendering.js'
-import { phx } from '../../.phoenix/phx.js'
 
 export default phx.domain.implementCustomExpressions({
   Hole: {
@@ -597,8 +596,6 @@ export default phx.domain.implementCustomExpressions({
 ### ./src/invariants/invariants.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomInvariants({
   Plate: {
     noOvals: s => {

package/dist/docs/recipes-and-delete/vertical.mdx

@@ -153,9 +153,9 @@ invariants:
 **Dry run behavior:**
 
 - Recipe validation: Each recipe shows violation hints based on what would happen if executed
-- Fatal violations: Recipes that would cause fatal violations are disabled and cannot be clicked
-- Warning violations: Recipes that cause warnings show indicators but remain clickable
-- Fixable violations: Violations listed in fixableViolations are ignored in the UI hints
+- Fatal and fixable violations: Recipes that would cause a `fatal` or `fixable` violation are disabled and cannot be clicked
+- Warning and notice violations: Recipes that cause only `warning` or `notice` violations stay clickable and show no hint
+- Fixable violations: Violation types listed in `fixableViolations` are left out of the hint text; the recipe stays disabled
 
 ## TypeScript Interfaces
 
@@ -462,7 +462,6 @@ components:
 
 ```ts
 import { createPlate } from '../../../../common/plate-rendering.js'
-import { phx } from '../../.phoenix/phx.js'
 
 export default phx.domain.implementCustomExpressions({
   Hole: {
@@ -575,8 +574,6 @@ export default phx.domain.implementCustomExpressions({
 ### ./src/invariants/invaraints.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomInvariants({
   Plate: {
     noOvals: s => {

package/dist/docs/relations/aliases.mdx

@@ -289,8 +289,6 @@ components:
 ### ./src/expressions/expressions.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomExpressions({
   Legs: {
     $legRecipes: () => {

package/dist/docs/relations/all-of-type.mdx

@@ -285,8 +285,6 @@ components:
 ### ./src/expressions/expressions.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomExpressions({
   Range: {
     $width: s => {
@@ -396,8 +394,6 @@ export default phx.domain.implementCustomExpressions({
 ### ./src/invariants/invariants.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomInvariants({
   Range: {
     minimumModuleCount: s => {

package/dist/docs/relations/child-nullable.mdx

@@ -260,8 +260,6 @@ components:
 ### ./src/expressions/hood.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomExpressions({
   Hood: {
     $hoodRecipes: () => {
@@ -324,8 +322,6 @@ export default phx.domain.implementCustomExpressions({
 ### ./src/expressions/range.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomExpressions({
   Range: {
     $hoodRecipes: () => {

package/dist/docs/relations/child-required.mdx

@@ -260,8 +260,6 @@ components:
 ### ./src/expressions/expressions.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomExpressions({
   Range: {
     $hoodRecipes: () => {

package/dist/docs/relations/collection-direct.mdx

@@ -291,8 +291,6 @@ components:
 ### ./src/expressions/expressions.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomExpressions({
   Range: {
     $width: s => {
@@ -402,8 +400,6 @@ export default phx.domain.implementCustomExpressions({
 ### ./src/invariants/range.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomInvariants({
   Range: {
     minimumModuleCount: s => {

package/dist/docs/relations/collection-indirect.mdx

@@ -290,8 +290,6 @@ components:
 ### ./src/expressions/expressions.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomExpressions({
   Range: {
     $width: s => {
@@ -407,8 +405,6 @@ export default phx.domain.implementCustomExpressions({
 ### ./src/invariants/range.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomInvariants({
   Range: {
     minimumModuleCount: s => {

package/dist/docs/relations/collection-multiple.mdx

@@ -301,8 +301,6 @@ components:
 ### ./src/expressions/expressions.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomExpressions({
   Scene: {
     $firstRowRecipes: () => {

package/dist/docs/relations/cross-reference.mdx

@@ -341,8 +341,6 @@ components:
 ### ./src/expressions/expressions.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomExpressions({
   Range: {
     $width: s => {

package/dist/docs/relations/hierarchy.mdx

@@ -229,8 +229,6 @@ transformers:
 ### ./src/expressions/expressions.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.domain.implementCustomExpressions({
   Node: {
     $propertyPage: s => {

package/dist/docs/selection-and-highlight/canvas.mdx

@@ -169,7 +169,6 @@ presets:
 
 ```tsx
 import { getConsoleRenderingComponents } from '../../../../common/console-rendering.js'
-import { phx } from '../../.phoenix/phx.js'
 
 export default [...getConsoleRenderingComponents('ConsoleUnit', phx.domain.attachComponent)]
 ```

package/dist/docs/selection-and-highlight/disable-highlight-per-object.mdx

@@ -309,7 +309,6 @@ components:
 
 ```tsx
 import { getConsoleRenderingComponents } from '../../../../common/console-rendering.js'
-import { phx } from '../../.phoenix/phx.js'
 
 export default [...getConsoleRenderingComponents('ConsoleUnit', phx.domain.attachComponent)]
 ```

package/dist/docs/selection-and-highlight/disable-highlight.mdx

@@ -178,7 +178,6 @@ components:
 
 ```tsx
 import { getConsoleRenderingComponents } from '../../../../common/console-rendering.js'
-import { phx } from '../../.phoenix/phx.js'
 
 export default [...getConsoleRenderingComponents('ConsoleUnit', phx.domain.attachComponent)]
 ```

package/dist/docs/selection-and-highlight/effects/outline.mdx

@@ -145,7 +145,6 @@ components:
 
 ```tsx
 import { getConsoleRenderingComponents } from '../../../../common/console-rendering.js'
-import { phx } from '../../.phoenix/phx.js'
 
 export default [...getConsoleRenderingComponents('ConsoleUnit', phx.domain.attachComponent)]
 ```
@@ -157,8 +156,6 @@ import { Environment } from '@react-three/drei'
 
 import { HoverOutline, Postprocessing, SelectionOutline } from '@salsita-ai/sdk/configurator'
 
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.frontend.createCustomPhoenixLayoutElement('CanvasEnvironment', () => {
   return (
     <>

package/dist/docs/selection-and-highlight/effects/overlay.mdx

@@ -144,7 +144,6 @@ components:
 
 ```tsx
 import { getConsoleRenderingComponents } from '../../../../common/console-rendering.js'
-import { phx } from '../../.phoenix/phx.js'
 
 export default [...getConsoleRenderingComponents('ConsoleUnit', phx.domain.attachComponent)]
 ```
@@ -156,8 +155,6 @@ import { Environment } from '@react-three/drei'
 
 import { LegacyHighlight, Postprocessing } from '@salsita-ai/sdk/configurator'
 
-import { phx } from '../../.phoenix/phx.js'
-
 export default phx.frontend.createCustomPhoenixLayoutElement('CanvasEnvironment', () => {
   return (
     <>

package/dist/docs/selection-and-highlight/fast-emissive-highlight.mdx

@@ -194,7 +194,6 @@ components:
 
 ```tsx
 import { getConsoleRenderingComponents } from '../../../../common/console-rendering.js'
-import { phx } from '../../.phoenix/phx.js'
 
 export default [...getConsoleRenderingComponents('ConsoleUnit', phx.domain.attachComponent, undefined, true)]
 ```
@@ -202,8 +201,6 @@ export default [...getConsoleRenderingComponents('ConsoleUnit', phx.domain.attac
 ### ./src/expressions/expressions.ts
 
 ```ts
-import { phx } from '../../.phoenix/phx.js'
-
 const SurfaceSwatchMap = {
   Oak: {
     color: '#605F5D',

package/dist/docs/selection-and-highlight/group-highlighting.mdx

@@ -243,7 +243,6 @@ components:
 
 ```tsx
 import { getConsoleRenderingComponents } from '../../../../common/console-rendering.js'
-import { phx } from '../../.phoenix/phx.js'
 
 export default [
   ...getConsoleRenderingComponents('ConsoleUnit', phx.domain.attachComponent),