@almadar/core 11.4.0 → 11.5.0

package/dist/{chunk-7JO77HA6.js → chunk-VQWE3FCB.js}

@@ -1,4 +1,4 @@
-import { mergeCallSiteConfigOverrides, parseOrbitalSchema, isOrbitalValue, OrbitalValueSchema, isInlineTrait, isEntityReference, parseEntityRef, isEntityCall } from './chunk-UCP26C3C.js';
+import { mergeCallSiteConfigOverrides, parseOrbitalSchema, isOrbitalValue, OrbitalValueSchema, isInlineTrait, isEntityReference, parseEntityRef, isEntityCall } from './chunk-J64IR3DR.js';
 
 // src/builders/apply-config-overrides.ts
 function overrideTrait(trait, values) {

package/dist/{chunk-DHWP7B4S.js → chunk-XYHBAUWE.js}

@@ -1,5 +1,5 @@
-import { OrbitalSchemaSchema, SourceDeclarationMetadataSchema } from './chunk-UCP26C3C.js';
-import { FieldValueSchema, EntityRowSchema, SERVER_REPORTED_EFFECTS } from './chunk-JPJQCTJI.js';
+import { OrbitalSchemaSchema, SourceDeclarationMetadataSchema } from './chunk-J64IR3DR.js';
+import { FieldValueSchema, EntityRowSchema, SERVER_REPORTED_EFFECTS } from './chunk-JN3MMQTB.js';
 import { EventPayloadValueSchema, EventPayloadSchema } from './chunk-R3Y7ABF4.js';
 import { JsonValueSchema, isJsonObject } from './chunk-GNLND5O2.js';
 import { z } from 'zod';
@@ -675,6 +675,7 @@ function guardHolds(check, onError) {
     return false;
   }
 }
+var ServerEffectCodeSchema = z.enum(["not-found", "no-row-key", "duplicate-id", "denied", "derived-failed"]);
 var ServerBatchSummarySchema = z.object({
   operations: z.array(EntityRowSchema),
   completedCount: z.number(),
@@ -689,7 +690,7 @@ var ServerEffectResultSchema = z.object({
   success: z.boolean(),
   denied: z.literal(true).optional(),
   error: z.string().optional(),
-  code: z.enum(["not-found", "no-row-key", "duplicate-id", "denied", "derived-failed"]).optional(),
+  code: ServerEffectCodeSchema.optional(),
   target: z.string().optional(),
   routed: z.string().optional()
 });
@@ -1308,7 +1309,7 @@ var validation_codes_default = [
   {
     code: "ORB_BINDING_FROM_ENTITY_OUTSIDE_ENSURES",
     category: "binding",
-    description: "@fromEntity is the row before a transition and may only be used inside an @ensures"
+    description: "The @fromEntity binding is the row before a transition and may only be used inside an @ensures"
   },
   {
     code: "ORB_BINDING_INVALID_FORMAT",
@@ -1425,6 +1426,11 @@ var validation_codes_default = [
     category: "circuit",
     description: "A transition declares async result events but its target state has no arm handling them, so the requester cannot hear its own result"
   },
+  {
+    code: "ORB_CIRCUIT_ASYNC_RESULT_DEAF_WAITING",
+    category: "circuit",
+    description: "A state that only an async result can leave is reachable while a call-service is in flight and has no arm for that call's outcome, so the outcome is dropped there"
+  },
   {
     code: "ORB_CIRCUIT_DEAD_BODILESS_ACTION",
     category: "circuit",
@@ -1440,6 +1446,11 @@ var validation_codes_default = [
     category: "circuit",
     description: "A state handles a failure event but its arm neither renders nor emits a declared event, so the failure reaches no one"
   },
+  {
+    code: "ORB_CIRCUIT_INIT_ARM_NEVER_FIRES",
+    category: "circuit",
+    description: "Every INIT arm of a trait's initial state is guarded by a condition that is false for the composition's config and no other arm of that state can fire, so the trait never starts"
+  },
   {
     code: "ORB_CIRCUIT_INIT_UNCOVERED_STATE",
     category: "circuit",
@@ -1615,6 +1626,11 @@ var validation_codes_default = [
     category: "effect",
     description: "An effect is written in a retired object form instead of the array form"
   },
+  {
+    code: "ORB_EFF_SERVER_EFFECT_NO_FAILURE_ROUTE",
+    category: "effect",
+    description: "A fetch, persist or call-service effect on a server entity declares no `emit: { failure }` route, so its error reaches no one"
+  },
   {
     code: "ORB_EFF_SET_INVALID_BINDING",
     category: "effect",
@@ -1665,11 +1681,21 @@ var validation_codes_default = [
     category: "entity",
     description: "An entity declares owner columns but has no access policy scoping rows to the owner"
   },
+  {
+    code: "ORB_ENTITY_READ_UNDECLARED",
+    category: "entity",
+    description: "A persistent entity declares neither an @read policy nor an @read none waiver, so who reads its rows is unstated"
+  },
   {
     code: "ORB_ENTITY_SPLIT_MUTATION",
     category: "entity_mutation",
     description: "A runtime entity is mutated by several traits on isolated per-trait copies while another trait reads a field it never writes"
   },
+  {
+    code: "ORB_ENTITY_WRITE_UNDECLARED",
+    category: "entity",
+    description: "A persistent entity declares no @create, or declares some write directives but not all of @create, @update and @delete, so an undeclared write is allow-all"
+  },
   {
     code: "ORB_E_DUPLICATE_FIELD",
     category: "entity",
@@ -1785,6 +1811,11 @@ var validation_codes_default = [
     category: "effect",
     description: "A fetch with total none skips the count, so the success event's totalCount is never set and may not be read"
   },
+  {
+    code: "ORB_FETCH_UNBOUNDED",
+    category: "query",
+    description: "A fetch of a persistent entity has no limit, id or nearest, so it reads every row"
+  },
   {
     code: "ORB_FETCH_UNINDEXED",
     category: "query",
@@ -1890,6 +1921,21 @@ var validation_codes_default = [
     category: "inbound",
     description: "An inbound hook event answers with an event the trait does not declare in emits"
   },
+  {
+    code: "ORB_INBOUND_CLI_DASH_WORD",
+    category: "inbound",
+    description: "A cli- inbound hook has an empty command word, so a word would start with a dash"
+  },
+  {
+    code: "ORB_INBOUND_CLI_RESERVED",
+    category: "inbound",
+    description: "A cli- inbound hook takes a command word the orb bootloader reserves"
+  },
+  {
+    code: "ORB_INBOUND_CLI_SHADOWED",
+    category: "inbound",
+    description: "A cli- inbound hook is a prefix of a longer cli- hook, so the longer hook takes the arguments that begin with its next word"
+  },
   {
     code: "ORB_INBOUND_DUPLICATE",
     category: "inbound",
@@ -1980,6 +2026,11 @@ var validation_codes_default = [
     category: "listen",
     description: "A listens route is redundant because the embedded trait already receives that event"
   },
+  {
+    code: "ORB_LISTEN_ROUTE_PROJECTION_MISMATCH",
+    category: "trait_event",
+    description: "A listens route copies a payload field projected from one entity field into a payload field projected from a different field of the same entity"
+  },
   {
     code: "ORB_LISTEN_ROUTE_STARVES_REQUIRED_FIELD",
     category: "trait_event",
@@ -2240,6 +2291,11 @@ var validation_codes_default = [
     category: "persist",
     description: "A persist effect names its row id with an expression instead of a binding path or literal id, so no row key resolves"
   },
+  {
+    code: "ORB_PERSIST_UPDATE_WITHOUT_CREATE",
+    category: "cross",
+    description: "A persistent entity the program updates but never creates, upserts or batch-creates, and that declares no instances: the update can never find a row. An update made by a trait authored in this program that binds the entity as its `@rebindable` placeholder is not judged, since the program that composes the trait owns the rows; nor is an update by a trait authored in an orbital that declares `expects entity` for that entity (a composed copy of the trait is still judged), which states that another part of the program supplies the rows"
+  },
   {
     code: "ORB_PERSIST_WHERE_NOT_A_PREDICATE",
     category: "persist",
@@ -2280,6 +2336,11 @@ var validation_codes_default = [
     category: "page",
     description: "A page declares an empty traits array"
   },
+  {
+    code: "ORB_P_ENTRY_UNKNOWN_ROUTE",
+    category: "page",
+    description: "An entry route of the app names a path that is no page of the app"
+  },
   {
     code: "ORB_P_HOST_RESERVED_ROUTE",
     category: "page",
@@ -2325,6 +2386,11 @@ var validation_codes_default = [
     category: "page",
     description: "A page has no traits array for trait-driven UI"
   },
+  {
+    code: "ORB_P_ROUTE_PARAM_MISSING_FOR_INIT",
+    category: "page",
+    description: "A route page whose path lacks a :param for a field a mounted trait declares required on its INIT event, so navigating to it is refused"
+  },
   {
     code: "ORB_P_SIGN_IN_UNKNOWN_ROUTE",
     category: "page",
@@ -2365,6 +2431,11 @@ var validation_codes_default = [
     category: "render_ui",
     description: "A non-drawable child is composed under a canvas draw-host, which paints only neutral drawable descriptors"
   },
+  {
+    code: "ORB_RUI_CONTROLLED_WITHOUT_CHANGE",
+    category: "render_ui",
+    description: "A control whose value is bound to a non-literal and that wires none of the events that report its change: the field cannot be edited"
+  },
   {
     code: "ORB_RUI_ELEMENT_SHAPE_MISMATCH",
     category: "render_ui",
@@ -2465,6 +2536,16 @@ var validation_codes_default = [
     category: "slot",
     description: "No trait on a page renders anything into the main slot"
   },
+  {
+    code: "ORB_SLOT_MAIN_ONLY_CONTAINERS",
+    category: "slot",
+    description: "Every trait render into the main slot of a page paints only empty layout-only containers, so nothing is shown"
+  },
+  {
+    code: "ORB_STATE_TRAPPED",
+    category: "composed",
+    description: "A trait can reach a state that no event the program sends can take it out of"
+  },
   {
     code: "ORB_STORE_DRIVER_CONTRACT",
     category: "store",
@@ -2585,6 +2666,11 @@ var validation_codes_default = [
     category: "schema",
     description: "A read of a field of the signed-in user names a field the declared identity entity does not have"
   },
+  {
+    code: "ORB_S_USER_ID_EMPTY_COMPARISON",
+    category: "schema",
+    description: `A comparison of @user.id with the empty string, which is never true of a viewer: the anonymous viewer's id is "anonymous", so the comparison is constant`
+  },
   {
     code: "ORB_TAB_EFFECT_ON_SERVER",
     category: "tab",
@@ -2780,6 +2866,11 @@ var validation_codes_default = [
     category: "trait",
     description: "A config field typed secret does not default to a string credential reference"
   },
+  {
+    code: "ORB_T_SERVER_TRAIT_CLIENT_EFFECT",
+    category: "trait",
+    description: "A trait that runs every step on the server performs an effect only a client can do and the kernel does not forward to one"
+  },
   {
     code: "ORB_T_STATE_UNREACHABLE",
     category: "trait",
@@ -2845,6 +2936,11 @@ var validation_codes_default = [
     category: "cross",
     description: "Traits form a circular event dependency"
   },
+  {
+    code: "ORB_X_COLLECTION_ENUM_MISMATCH",
+    category: "cross",
+    description: "Two persistent entities on one collection declare the same field as an enum with different value sets, so one entity's rows fail the other's type"
+  },
   {
     code: "ORB_X_CROSS_EMITTER_DECLARED_PAYLOAD_MISMATCH",
     category: "cross",
@@ -3304,6 +3400,7 @@ var PlayedEffectSchema = z.object({
   args: z.array(JsonValueSchema),
   status: z.enum(["executed", "failed", "skipped"]),
   error: z.string().optional(),
+  code: ServerEffectCodeSchema.optional(),
   routed: z.boolean(),
   nested: PlayedNestedSchema.optional()
 });
@@ -3355,7 +3452,7 @@ var RenderedSlotSchema = z.object({
   ownerEntity: z.string(),
   nodes: z.array(RenderedNodeSchema),
   props: JsonValueSchema.optional(),
-  fault: z.object({ code: z.enum(["no-matching-transition", "guard-rejected", "no-dispatchable-traits", "not-an-external-input", "inbound-only-event", "effect-failed", "locale-not-declared", "client-circuit-state-refused", "repaint-failed"]), error: z.string() }).optional()
+  fault: z.object({ code: z.enum(["no-matching-transition", "guard-rejected", "no-dispatchable-traits", "not-an-external-input", "inbound-only-event", "effect-failed", "locale-not-declared", "client-circuit-state-refused", "repaint-failed", "cascade-capped"]), error: z.string() }).optional()
 });
 var PlayedStateSchema = z.object({ before: z.string().nullable(), after: z.string().nullable() });
 var PendingAskSchema = z.object({