@wildo-ai/saas-models 1.0.1

package/dist/esm/resources/relationship-display.shared.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationship-display.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/resources/relationship-display.shared.schemas.ts"],"names":[],"mappings":"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"}

package/dist/esm/resources/relationship-display.shared.schemas.js

@@ -0,0 +1,383 @@
+/**
+ * Relationship Display Configuration
+ *
+ * How resource relationships are presented in frontend views.
+ *
+ * This file intentionally stays on the FRONTEND/UI plane:
+ * - read composition (`inParentView`, `inChildView`)
+ * - narrow workflow hints for frontend interaction (`interaction`)
+ *
+ * It is separate from:
+ * - shared semantic meaning (`RelationshipNature`)
+ * - backend/nested handling (`childOperations`)
+ * - navigation shell zoning, which lives in config/frontend/navigation.shared.schemas
+ *
+ * Key concepts:
+ * - `inParentView`: How children appear in the parent's view as embedded content
+ * - `inParentNavigation`: How parent-owned navigation to those children is orchestrated
+ * - `inChildView`: How the parent reference appears in the child's detail view (breadcrumb, badge, etc.)
+ *
+ * Uses navigation types (TransitionConfig) as building blocks for relationship-level
+ * transition overrides, but the display config itself belongs to the resource domain.
+ *
+ * @see createResourcesRelationship() display option
+ */
+import { z } from 'zod';
+import { DisplayDirection, SectionMode } from '@wildo-ai/zod-decorators';
+import { CascadeDirection, CoreResourceOperation } from './resources.shared.core.definitions.js';
+import { TransitionConfigSchema, viewportDiscriminatedSchema, } from '../config/frontend/navigation.shared.schemas.js';
+const RelationshipEmbeddedSectionGapSchema = z.enum(['sm', 'md', 'lg']);
+export const RELATIONSHIP_EMBEDDED_SECTION_MODES = [
+    SectionMode.COLLAPSIBLE,
+    SectionMode.INLINE,
+    SectionMode.GRID,
+    SectionMode.COLUMNS,
+    SectionMode.TABS,
+    SectionMode.VERTICAL_TABS,
+    SectionMode.PILLS,
+    SectionMode.ACCORDION,
+    SectionMode.EXPANDABLE,
+    SectionMode.STEPPER,
+    SectionMode.TIMELINE,
+];
+export const RelationshipEmbeddedSectionModeSchema = z.enum(RELATIONSHIP_EMBEDDED_SECTION_MODES);
+const RelationshipEmbeddedSectionConfigBaseSchema = z.object({
+    showSingleSectionNav: z.boolean().optional(),
+    hideWhenEmpty: z.boolean().optional(),
+    fallbackMode: RelationshipEmbeddedSectionModeSchema.optional(),
+    emptyStateMessage: z.string().optional(),
+    ariaLabel: z.string().optional(),
+    ariaLabelledBy: z.string().optional(),
+});
+const RelationshipEmbeddedSectionConfig_CollapsibleSchema = RelationshipEmbeddedSectionConfigBaseSchema.extend({
+    mode: z.literal(SectionMode.COLLAPSIBLE),
+    triggerLabel: z.object({
+        open: z.string(),
+        closed: z.string(),
+    }).optional(),
+}).strict();
+const RelationshipEmbeddedSectionConfig_InlineSchema = RelationshipEmbeddedSectionConfigBaseSchema.extend({
+    mode: z.literal(SectionMode.INLINE),
+    gap: RelationshipEmbeddedSectionGapSchema.optional(),
+}).strict();
+const RelationshipEmbeddedSectionConfig_GridSchema = RelationshipEmbeddedSectionConfigBaseSchema.extend({
+    mode: z.literal(SectionMode.GRID),
+    columnCount: z.union([z.number(), z.literal('auto')]).optional(),
+    gap: RelationshipEmbeddedSectionGapSchema.optional(),
+    minColumnWidth: z.string().optional(),
+}).strict();
+const RelationshipEmbeddedSectionConfig_ColumnsSchema = RelationshipEmbeddedSectionConfigBaseSchema.extend({
+    mode: z.literal(SectionMode.COLUMNS),
+    columnCount: z.union([z.number(), z.literal('auto')]).optional(),
+    gap: RelationshipEmbeddedSectionGapSchema.optional(),
+}).strict();
+const RelationshipEmbeddedSectionConfig_TabsSchema = RelationshipEmbeddedSectionConfigBaseSchema.extend({
+    mode: z.literal(SectionMode.TABS),
+    allowNone: z.boolean().optional(),
+}).strict();
+const RelationshipEmbeddedSectionConfig_VerticalTabsSchema = RelationshipEmbeddedSectionConfigBaseSchema.extend({
+    mode: z.literal(SectionMode.VERTICAL_TABS),
+    allowNone: z.boolean().optional(),
+    navWidth: z.string().optional(),
+}).strict();
+const RelationshipEmbeddedSectionConfig_PillsSchema = RelationshipEmbeddedSectionConfigBaseSchema.extend({
+    mode: z.literal(SectionMode.PILLS),
+    allowNone: z.boolean().optional(),
+}).strict();
+const RelationshipEmbeddedSectionConfig_AccordionSchema = RelationshipEmbeddedSectionConfigBaseSchema.extend({
+    mode: z.literal(SectionMode.ACCORDION),
+    allowMultiple: z.boolean().optional(),
+}).strict();
+const RelationshipEmbeddedSectionConfig_ExpandableSchema = RelationshipEmbeddedSectionConfigBaseSchema.extend({
+    mode: z.literal(SectionMode.EXPANDABLE),
+    initialVisibleCount: z.number().int().positive().optional(),
+    showMoreLabel: z.string().optional(),
+    showLessLabel: z.string().optional(),
+}).strict();
+const RelationshipEmbeddedSectionConfig_StepperSchema = RelationshipEmbeddedSectionConfigBaseSchema.extend({
+    mode: z.literal(SectionMode.STEPPER),
+    allowSkip: z.boolean().optional(),
+    showProgress: z.boolean().optional(),
+    orientation: z.enum(DisplayDirection).optional(),
+    nextLabel: z.string().optional(),
+    previousLabel: z.string().optional(),
+    completeLabel: z.string().optional(),
+}).strict();
+const RelationshipEmbeddedSectionConfig_TimelineSchema = RelationshipEmbeddedSectionConfigBaseSchema.extend({
+    mode: z.literal(SectionMode.TIMELINE),
+}).strict();
+export const RelationshipEmbeddedSectionConfigSchema = z.discriminatedUnion('mode', [
+    RelationshipEmbeddedSectionConfig_CollapsibleSchema,
+    RelationshipEmbeddedSectionConfig_InlineSchema,
+    RelationshipEmbeddedSectionConfig_GridSchema,
+    RelationshipEmbeddedSectionConfig_ColumnsSchema,
+    RelationshipEmbeddedSectionConfig_TabsSchema,
+    RelationshipEmbeddedSectionConfig_VerticalTabsSchema,
+    RelationshipEmbeddedSectionConfig_PillsSchema,
+    RelationshipEmbeddedSectionConfig_AccordionSchema,
+    RelationshipEmbeddedSectionConfig_ExpandableSchema,
+    RelationshipEmbeddedSectionConfig_StepperSchema,
+    RelationshipEmbeddedSectionConfig_TimelineSchema,
+]);
+// ════════════════════════════════════════════════════════════════
+// ParentDisplay — How parent reference renders in child view
+// ════════════════════════════════════════════════════════════════
+/**
+ * How the parent reference appears in the child's detail view.
+ *
+ * Controls the structural element in the child's view that references the parent
+ * resource. This is NOT about the FK field rendering (which is handled by
+ * `ForeignKeyUIDisplayParams.mode` via `.foreignKeyUI()`).
+ *
+ * Values align with framework behavior:
+ * - `breadcrumb`: Rendered via BreadcrumbCompound as a breadcrumb segment.
+ * - `context`: Framework's context bar / header link — parent in the contextual header area.
+ * - `summary`: Matches ForeignKeyDisplayMode.SUMMARY — compact card with key parent fields
+ *   (same rendering pattern as FK summary view).
+ * - `badge`: Compact badge/chip in header area.
+ *
+ * Replaces the old `RelationshipDisplayMode` enum (link/badge/inline/none).
+ */
+export var ParentDisplay;
+(function (ParentDisplay) {
+    /**
+     * Parent as breadcrumb segment. Rendered via BreadcrumbCompound.
+     * Example: "Projects > Alpha" with parent as a clickable segment.
+     */
+    ParentDisplay["BREADCRUMB"] = "breadcrumb";
+    /**
+     * Parent in the framework's context bar / header link area.
+     * Matches framework's contextual parent reference (header link, context bar).
+     * Default for most relationships.
+     */
+    ParentDisplay["CONTEXT"] = "context";
+    /**
+     * Compact badge/chip in header area showing parent identity.
+     * Matches framework's badge display. Less prominent than context/breadcrumb.
+     */
+    ParentDisplay["BADGE"] = "badge";
+    /**
+     * Inline summary card. Matches ForeignKeyDisplayMode.SUMMARY — compact card
+     * with key parent fields (same rendering as FK summary view).
+     */
+    ParentDisplay["SUMMARY"] = "summary";
+    /** Don't show any parent reference. The child appears standalone. */
+    ParentDisplay["NONE"] = "none";
+})(ParentDisplay || (ParentDisplay = {}));
+// ════════════════════════════════════════════════════════════════
+// RelationshipDisplayInParentView
+// ════════════════════════════════════════════════════════════════
+/**
+ * How a relationship's children are rendered in the parent's view.
+ *
+ * This configures EMBEDDING / view composition for a relationship inside the
+ * parent's surface.
+ *
+ * Key behavior:
+ * - Navigation now lives in `display.inParentNavigation`.
+ * - `contentSectionConfig` controls how embedded relationship sections are arranged.
+ * - `hidden: true` → don't render this relationship at all.
+ *
+ * Old field mapping:
+ * - `intent: 'none'` → `hidden: true`
+ * - `inlineArrangement: 'tab'` → `contentSectionConfig: { mode: SectionMode.TABS }`
+ * - `inlineArrangement: 'section'` → `contentSectionConfig: { mode: SectionMode.INLINE }`
+ */
+export const RelationshipDisplayInParentViewSchema = z.object({
+    /**
+     * Ordering index for this relationship's tab/section within the parent view.
+     * Lower values appear first. Multiple relationships are sorted by this value.
+     */
+    orderIndex: z.number().optional(),
+    /**
+     * Maximum number of items to show inline before truncating.
+     * When exceeded, remaining items are hidden behind a "View all (N)" link.
+     */
+    inlineLimit: z.number().optional(),
+    /**
+     * Whether to show a "View all (N)" link when inline items are truncated.
+     * Clicking this link triggers a `list` transition from the source zone.
+     * @default true
+     */
+    showViewAllLink: z.boolean().optional(),
+    /**
+     * How the embedded relationship sections render (tabs, inline, accordion, etc.).
+     * Reuses the same structural section vocabulary as `ContentSectionContainer`,
+     * but only through a serializable relationship-owned subset.
+     *
+     * Framework defaults when omitted (based on relationship cardinality):
+     * - 1:1 / 0:1 → `{ mode: SectionMode.INLINE }`
+     * - 1:N → `{ mode: SectionMode.TABS }`
+     * - N:N → `{ mode: SectionMode.TABS }`
+     *
+     * Viewport-discriminated: e.g.
+     * `{ [ViewportBreakpoint.MOBILE]: { mode: SectionMode.ACCORDION } }`
+     * for accordion on mobile.
+     *
+     * Replaces old `inlineArrangement` field (`tab` → `tabs`, `section` → `inline`).
+     */
+    contentSectionConfig: viewportDiscriminatedSchema(RelationshipEmbeddedSectionConfigSchema).optional(),
+    /**
+     * When `true`, this relationship is not rendered at all in the parent view.
+     * The relationship still exists in the data model but has no UI representation.
+     * Replaces old `intent: 'none'`.
+     */
+    hidden: z.boolean().optional(),
+}).strict();
+// ════════════════════════════════════════════════════════════════
+// RelationshipDisplayInParentNavigation
+// ════════════════════════════════════════════════════════════════
+/**
+ * Parent-owned navigation behavior for a relationship surface.
+ *
+ * This subtree answers navigation questions that do NOT belong to embedded
+ * composition itself:
+ * - when a header or "View all" action should navigate
+ * - which transition should be used
+ * - how ancestor zones should be populated while cascading
+ * - how deep relationship-owned navigation may grow before escalation
+ *
+ * Keeping these settings outside `inParentView` preserves the semantic
+ * distinction between "show the child inline here" and "navigate from here".
+ */
+export const RelationshipDisplayInParentNavigationSchema = z.object({
+    /**
+     * Navigation transition override for this relationship.
+     * When undefined, the relationship stays embed-first and callers decide
+     * whether any separate navigation affordance should exist.
+     *
+     * Old field mapping:
+     * - `intent: 'inline'` → no `transition`
+     * - `intent: 'detail'` → `transition: NavigationTransition.SPLIT`
+     * - `intent: 'drill'` → `transition: NavigationTransition.PUSH`
+     * - `intent: 'companion'` → `transition: { transition: NavigationTransition.SPLIT, persistent: true }`
+     * - `intent: 'inspect'` → `transition: { transition: NavigationTransition.OVERLAY, ephemeral: true }`
+     *
+     * New v3 transitions available at the relationship level:
+     * - `NavigationTransition.INPLACE`: edit/create child inline within the parent view
+     *   (element transforms without zone or stack change)
+     * - `NavigationTransition.PROMOTE`: open child at primary scope, escaping current context
+     */
+    transition: viewportDiscriminatedSchema(TransitionConfigSchema).optional(),
+    /**
+     * Override global `maxDepth` for this relationship's navigation chain.
+     * When the push stack reaches this depth, the framework escalates to overlay.
+     */
+    maxDepth: z.number().int().positive().optional(),
+    /**
+     * For self-referencing relationships (e.g. Category → Category):
+     * which direction to traverse when fetching data.
+     * - `CascadeDirection.FORWARD`: declaring resource is the ancestor (parent → child)
+     * - `CascadeDirection.BACKWARD`: related resource is the ancestor (child → parent)
+     */
+    direction: z.enum(CascadeDirection).optional(),
+    /**
+     * Override which operation to show in the ancestor zone when cascading.
+     * When a child is placed in SECONDARY or COMPANION, ancestor zones are auto-populated.
+     * Defaults: 1:N → LIST, 1:1 → READ, M:N → LIST. Use this to force LIST or READ.
+     */
+    ancestorOperation: z.enum(CoreResourceOperation).optional(),
+}).strict();
+// ════════════════════════════════════════════════════════════════
+// RelationshipDisplayInChildView
+// ════════════════════════════════════════════════════════════════
+/**
+ * How the parent reference appears in the child's detail view.
+ *
+ * Controls a structural element in the child's view header/context area.
+ * This is separate from FK field rendering (`ForeignKeyUIDisplayParams`):
+ * - FK params control the FK FIELD widget (raw ID, resolved label, summary card)
+ * - This controls a dedicated PARENT REFERENCE element (breadcrumb, badge, card)
+ */
+export const RelationshipDisplayInChildViewSchema = z.object({
+    /**
+     * Whether the parent display element is clickable.
+     * When `true` (default for required relationships), clicking the parent reference
+     * triggers a `read` transition to the parent resource from the current zone.
+     */
+    showParentLink: z.boolean().optional(),
+    /**
+     * How the parent reference renders structurally in the child's view header.
+     * - `ParentDisplay.BREADCRUMB`: breadcrumb segment (BreadcrumbCompound)
+     * - `ParentDisplay.CONTEXT` (default): framework context bar / header link
+     * - `ParentDisplay.BADGE`: compact chip in header area
+     * - `ParentDisplay.SUMMARY`: compact card (matches ForeignKeyDisplayMode.SUMMARY)
+     * - `ParentDisplay.NONE`: hidden — no parent reference shown
+     *
+     * Replaces old `displayMode` field (renamed to avoid collision with other
+     * `displayMode` fields throughout the codebase, and to clarify the scope).
+     */
+    parentDisplay: z.enum(ParentDisplay).optional(),
+}).strict();
+// ════════════════════════════════════════════════════════════════
+// RelationshipDisplayInteraction
+// ════════════════════════════════════════════════════════════════
+/**
+ * Narrow frontend interaction hints for relationship surfaces.
+ *
+ * These settings are intentionally NOT part of the shared relationship meaning:
+ * - they do not change `RelationshipNature`
+ * - they do not change backend mutation/lifecycle semantics
+ * - they only influence how the frontend may orchestrate an interaction
+ *
+ * Important distinction:
+ * - `COMPOSITION` already owns aggregate/nested creation semantics
+ * - `REFERENCE` may optionally offer "create related resource, then set reference"
+ * - `ASSOCIATION` may optionally offer "create peer resource, then link/replace"
+ *
+ * So "quick create" is a workflow capability layered on top of relationship
+ * semantics, not a fourth relationship nature.
+ */
+export const RelationshipDisplayInteractionSchema = z.object({
+    /**
+     * Whether the frontend may offer a "quick create" affordance on top of the
+     * relationship surface.
+     *
+     * Semantic meaning by relationship nature:
+     * - `REFERENCE`: create an independent related resource, then complete the
+     *   reference action (`set` / future selector confirmation). The parent does
+     *   not aggregate-manage the child.
+     * - `ASSOCIATION`: create an independent peer resource, then complete the
+     *   association action (`link` / `replace`). The parent manages membership,
+     *   not the peer lifecycle.
+     * - `COMPOSITION`: this hint is generally redundant and should normally be
+     *   ignored, because composition already owns native nested creation through
+     *   aggregate semantics.
+     *
+     * Framework policy:
+     * - Missing value means ENABLED.
+     * - Consumers should treat `undefined` as `true`.
+     * - Disabling this only removes the shortcut affordance; it does not change
+     *   what the relationship means.
+     *
+     * Why default `true`:
+     * - for `REFERENCE`, "create then set" is usually a useful workflow shortcut
+     * - for `ASSOCIATION`, "create then link" is usually a useful workflow shortcut
+     * - the semantic distinction still stays visible in the follow-up action
+     */
+    allowQuickCreate: z.boolean().optional(),
+}).strict();
+// ════════════════════════════════════════════════════════════════
+// RelationshipDisplayConfig — Combined
+// ════════════════════════════════════════════════════════════════
+/**
+ * Combined frontend relationship presentation configuration.
+ * Passed as the `display` option in `createResourcesRelationship()`.
+ */
+export const RelationshipDisplayConfigSchema = z.object({
+    /** How this relationship's children appear in the parent's view as embedded content. */
+    inParentView: RelationshipDisplayInParentViewSchema.optional(),
+    /** How parent-owned navigation to those children is orchestrated. */
+    inParentNavigation: RelationshipDisplayInParentNavigationSchema.optional(),
+    /** How the parent reference appears in the child's detail view. */
+    inChildView: RelationshipDisplayInChildViewSchema.optional(),
+    /**
+     * Narrow interaction/workflow hints for frontend relationship surfaces.
+     *
+     * This is where UI capabilities such as `allowQuickCreate` belong. Keep these
+     * hints separate from `RelationshipNature` so frontend shortcuts do not blur
+     * backend/shared semantics.
+     */
+    interaction: RelationshipDisplayInteractionSchema.optional(),
+}).strict();
+//# sourceMappingURL=relationship-display.shared.schemas.js.map

package/dist/esm/resources/relationship-display.shared.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationship-display.shared.schemas.js","sourceRoot":"","sources":["../../../src/resources/relationship-display.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAsB,MAAM,0BAA0B,CAAC;AAC7F,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC9F,OAAO,EACL,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,8CAA8C,CAAC;AAEtD,MAAM,oCAAoC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AAExE,MAAM,CAAC,MAAM,mCAAmC,GAAG;IACjD,WAAW,CAAC,WAAW;IACvB,WAAW,CAAC,MAAM;IAClB,WAAW,CAAC,IAAI;IAChB,WAAW,CAAC,OAAO;IACnB,WAAW,CAAC,IAAI;IAChB,WAAW,CAAC,aAAa;IACzB,WAAW,CAAC,KAAK;IACjB,WAAW,CAAC,SAAS;IACrB,WAAW,CAAC,UAAU;IACtB,WAAW,CAAC,OAAO;IACnB,WAAW,CAAC,QAAQ;CACZ,CAAC;AAEX,MAAM,CAAC,MAAM,qCAAqC,GAAG,CAAC,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;AAGjG,MAAM,2CAA2C,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3D,oBAAoB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC5C,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACrC,YAAY,EAAE,qCAAqC,CAAC,QAAQ,EAAE;IAC9D,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACxC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACtC,CAAC,CAAC;AAEH,MAAM,mDAAmD,GAAG,2CAA2C,CAAC,MAAM,CAAC;IAC7G,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC;IACxC,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC;QACrB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;KACnB,CAAC,CAAC,QAAQ,EAAE;CACd,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,8CAA8C,GAAG,2CAA2C,CAAC,MAAM,CAAC;IACxG,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC;IACnC,GAAG,EAAE,oCAAoC,CAAC,QAAQ,EAAE;CACrD,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,4CAA4C,GAAG,2CAA2C,CAAC,MAAM,CAAC;IACtG,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC;IACjC,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAChE,GAAG,EAAE,oCAAoC,CAAC,QAAQ,EAAE;IACpD,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACtC,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,+CAA+C,GAAG,2CAA2C,CAAC,MAAM,CAAC;IACzG,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC;IACpC,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAChE,GAAG,EAAE,oCAAoC,CAAC,QAAQ,EAAE;CACrD,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,4CAA4C,GAAG,2CAA2C,CAAC,MAAM,CAAC;IACtG,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC;IACjC,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,oDAAoD,GAAG,2CAA2C,CAAC,MAAM,CAAC;IAC9G,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC;IAC1C,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACjC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,6CAA6C,GAAG,2CAA2C,CAAC,MAAM,CAAC;IACvG,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC;IAClC,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,iDAAiD,GAAG,2CAA2C,CAAC,MAAM,CAAC;IAC3G,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC;IACtC,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACtC,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,kDAAkD,GAAG,2CAA2C,CAAC,MAAM,CAAC;IAC5G,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC;IACvC,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC3D,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,+CAA+C,GAAG,2CAA2C,CAAC,MAAM,CAAC;IACzG,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC;IACpC,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACjC,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACpC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,QAAQ,EAAE;IAChD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,gDAAgD,GAAG,2CAA2C,CAAC,MAAM,CAAC;IAC1G,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC;CACtC,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,uCAAuC,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IAClF,mDAAmD;IACnD,8CAA8C;IAC9C,4CAA4C;IAC5C,+CAA+C;IAC/C,4CAA4C;IAC5C,oDAAoD;IACpD,6CAA6C;IAC7C,iDAAiD;IACjD,kDAAkD;IAClD,+CAA+C;IAC/C,gDAAgD;CACjD,CAAC,CAAC;AAQH,mEAAmE;AACnE,6DAA6D;AAC7D,mEAAmE;AAEnE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAN,IAAY,aAwBX;AAxBD,WAAY,aAAa;IACvB;;;OAGG;IACH,0CAAyB,CAAA;IACzB;;;;OAIG;IACH,oCAAmB,CAAA;IACnB;;;OAGG;IACH,gCAAe,CAAA;IACf;;;OAGG;IACH,oCAAmB,CAAA;IACnB,qEAAqE;IACrE,8BAAa,CAAA;AACf,CAAC,EAxBW,aAAa,KAAb,aAAa,QAwBxB;AAGD,mEAAmE;AACnE,kCAAkC;AAClC,mEAAmE;AAEnE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,qCAAqC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5D;;;OAGG;IACH,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAEjC;;;OAGG;IACH,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAElC;;;;OAIG;IACH,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAEvC;;;;;;;;;;;;;;;OAeG;IACH,oBAAoB,EAAE,2BAA2B,CAAC,uCAAuC,CAAC,CAAC,QAAQ,EAAE;IAErG;;;;OAIG;IACH,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC,MAAM,EAAE,CAAC;AAIZ,mEAAmE;AACnE,wCAAwC;AACxC,mEAAmE;AAEnE;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,2CAA2C,GAAG,CAAC,CAAC,MAAM,CAAC;IAClE;;;;;;;;;;;;;;;;OAgBG;IACH,UAAU,EAAE,2BAA2B,CAAC,sBAAsB,CAAC,CAAC,QAAQ,EAAE;IAE1E;;;OAGG;IACH,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAEhD;;;;;OAKG;IACH,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,QAAQ,EAAE;IAE9C;;;;OAIG;IACH,iBAAiB,EAAE,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,QAAQ,EAAE;CAC5D,CAAC,CAAC,MAAM,EAAE,CAAC;AAIZ,mEAAmE;AACnE,iCAAiC;AACjC,mEAAmE;AAEnE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3D;;;;OAIG;IACH,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAEtC;;;;;;;;;;OAUG;IACH,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE;CAChD,CAAC,CAAC,MAAM,EAAE,CAAC;AAIZ,mEAAmE;AACnE,iCAAiC;AACjC,mEAAmE;AAEnE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3D;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACzC,CAAC,CAAC,MAAM,EAAE,CAAC;AAIZ,mEAAmE;AACnE,uCAAuC;AACvC,mEAAmE;AAEnE;;;GAGG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC;IACtD,wFAAwF;IACxF,YAAY,EAAE,qCAAqC,CAAC,QAAQ,EAAE;IAC9D,qEAAqE;IACrE,kBAAkB,EAAE,2CAA2C,CAAC,QAAQ,EAAE;IAC1E,mEAAmE;IACnE,WAAW,EAAE,oCAAoC,CAAC,QAAQ,EAAE;IAC5D;;;;;;OAMG;IACH,WAAW,EAAE,oCAAoC,CAAC,QAAQ,EAAE;CAC7D,CAAC,CAAC,MAAM,EAAE,CAAC"}

package/dist/esm/resources/resources-config.shared.factory.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Operations Shared Schemas
+ *
+ * Reusable operation schemas for bulk actions and common operations
+ */
+import { EnumLikeType } from '@wildo-ai/zod-decorators';
+import { z } from 'zod';
+import { type AnyResourceConfiguration, ResourceConfiguration, ResourceConfiguration_BuilderParameters } from './resources-config.shared.schemas.js';
+import { CoreResourceOperation, ResourceType } from './resources.shared.core.definitions.js';
+import { ResourceRelationship } from './resources.shared.schemas.js';
+export declare function reconcileGeneratedRelationshipBulkOperations(resourceConfigurations: Record<string, AnyResourceConfiguration>, allResourceRelationships: ResourceRelationship[], allResourceFieldIdentifiers: Partial<Record<ResourceType, string>> | Record<string, string>): void;
+/**
+ * Derives the appropriate request DTO based on operation type.
+ *
+ * - CREATE: Uses buildCreateRequestDto (excludes excludeFromCreate fields)
+ * - UPDATE: Uses buildUpdateRequestDto (excludes excludeFromUpdate fields, all partial)
+ * - Other operations: Returns mainSchema as-is
+ *
+ * @param operation - The operation identifier
+ * @param mainSchema - The main resource schema
+ * @param providedDto - Explicitly provided DTO (takes precedence)
+ * @returns The appropriate request DTO schema
+ */
+export declare function deriveRequestDto<T extends z.ZodTypeAny>(operation: string, mainSchema: T, providedDto?: z.ZodTypeAny): z.ZodTypeAny;
+/**
+ * Creates a resource configuration from builder parameters.
+ * NOTE: TDatabaseSchema has been removed. Backend-only fields are now marked with
+ * the isBackendOnly decorator in mainSchema and are stripped at the service layer.
+ */
+export declare function createResourceConfiguration_Initialization<TCustomOperationEnum extends EnumLikeType | undefined, TCoreOperationEnum extends Partial<CoreResourceOperation> | undefined, TMainSchema extends z.ZodTypeAny>(params: ResourceConfiguration_BuilderParameters<TCustomOperationEnum, TCoreOperationEnum, TMainSchema>): ResourceConfiguration<TCustomOperationEnum, TCoreOperationEnum, TMainSchema>;
+//# sourceMappingURL=resources-config.shared.factory.d.ts.map

package/dist/esm/resources/resources-config.shared.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources-config.shared.factory.d.ts","sourceRoot":"","sources":["../../../src/resources/resources-config.shared.factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,YAAY,EAYb,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,OAAO,EAEL,KAAK,wBAAwB,EAQ7B,qBAAqB,EAErB,uCAAuC,EAMxC,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,qBAAqB,EAAwD,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAChJ,OAAO,EAQL,oBAAoB,EAarB,MAAM,4BAA4B,CAAC;AA6HpC,wBAAgB,4CAA4C,CAC1D,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,EAChE,wBAAwB,EAAE,oBAAoB,EAAE,EAChD,2BAA2B,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1F,IAAI,CA0BN;AAsPD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EACrD,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,CAAC,EACb,WAAW,CAAC,EAAE,CAAC,CAAC,UAAU,GACzB,CAAC,CAAC,UAAU,CAqBd;AA6zBD;;;;GAIG;AACH,wBAAgB,0CAA0C,CACxD,oBAAoB,SAAS,YAAY,GAAG,SAAS,EACrD,kBAAkB,SAAS,OAAO,CAAC,qBAAqB,CAAC,GAAG,SAAS,EACrE,WAAW,SAAS,CAAC,CAAC,UAAU,EAChC,MAAM,EAAE,uCAAuC,CAC/C,oBAAoB,EAAE,kBAAkB,EAAE,WAAW,CACtD,GAAG,qBAAqB,CAAC,oBAAoB,EAAE,kBAAkB,EAAE,WAAW,CAAC,CAsuB/E"}