@riverbankcms/sdk 0.77.0 → 0.78.0

package/dist/_dts/api/src/staffAccess.d.ts

@@ -0,0 +1,79 @@
+import { type AppointmentResourceId, type StaffMemberId } from "../../core/src/index";
+import { type StaffOperationalCapability } from "./accessAdmin";
+import { type SiteRole } from "./siteMembers";
+export type { StaffOperationalCapability };
+export type StaffScope = Readonly<{
+    kind: "none";
+}> | Readonly<{
+    kind: "staff_setup_required";
+    reason: "missing_staff_member" | "missing_capabilities";
+}> | Readonly<{
+    kind: "appointments";
+    staffMemberId: StaffMemberId;
+}> | Readonly<{
+    kind: "event_ops_only";
+    staffMemberId: StaffMemberId;
+}> | Readonly<{
+    kind: "hybrid";
+    staffMemberId: StaffMemberId;
+}>;
+export type StaffMembershipInput = Readonly<{
+    id?: string;
+    membershipRole: SiteRole | null;
+    linkedStaffMemberId: string | null;
+    staffCapabilities?: readonly StaffOperationalCapability[] | null;
+}>;
+export type StaffSiteHomeDestination = Readonly<{
+    kind: "staff_appointments";
+}> | Readonly<{
+    kind: "ops_site_events";
+}> | Readonly<{
+    kind: "dashboard_site_home";
+}>;
+export type SiteListingDestination = StaffSiteHomeDestination | Readonly<{
+    kind: "dashboard_site_open";
+}>;
+export type SiteListingNavigationPlan = Readonly<{
+    canUseDashboard: boolean;
+    primaryDestination: SiteListingDestination;
+    manageDestination: SiteListingDestination;
+    manageLabel: "Manage" | "Appointments" | "Ops";
+}>;
+export type OpsLandingDestination = Readonly<{
+    kind: "ops_site_events";
+    siteId: string;
+}> | Readonly<{
+    kind: "ops_home";
+}>;
+export type LinkedAppointmentIdentity = Readonly<{
+    kind: "none";
+}> | Readonly<{
+    kind: "linked";
+    staffMemberId: StaffMemberId;
+    resourceId: AppointmentResourceId;
+}>;
+export declare function roleAtLeast(role: SiteRole, minimum: SiteRole): boolean;
+export declare function roleAtLeastOrNone(role: SiteRole | null | undefined, minimum: SiteRole): boolean;
+export declare function appointmentResourceIdFromStaffMemberId(staffMemberId: StaffMemberId): AppointmentResourceId;
+export declare function deriveStaffScope(input: StaffMembershipInput): StaffScope;
+export declare function isStaffScoped(scope: StaffScope): boolean;
+export declare function isTeamMemberScope(scope: StaffScope): boolean;
+export declare function hasAppointmentStaffAccess(scope: StaffScope): boolean;
+export declare function hasEventOpsAccess(scope: StaffScope): boolean;
+export declare function getLinkedStaffMemberId(scope: StaffScope): StaffMemberId | null;
+export declare function getOwnAppointmentResourceId(scope: StaffScope): AppointmentResourceId | null;
+export declare function canAccessOwnAppointmentResource(scope: StaffScope, resourceId: string | AppointmentResourceId): boolean;
+export declare function deriveLinkedAppointmentIdentity(input: Readonly<{
+    membershipRole: SiteRole | null;
+    linkedStaffMemberId: string | null;
+}>): LinkedAppointmentIdentity;
+export declare function getIdentityStaffMemberId(identity: LinkedAppointmentIdentity): StaffMemberId | null;
+export declare function getIdentityStaffMemberIdValue(identity: LinkedAppointmentIdentity): string | null;
+export declare function getIdentityAppointmentResourceId(identity: LinkedAppointmentIdentity): AppointmentResourceId | null;
+export declare function getIdentityAppointmentResourceIdValue(identity: LinkedAppointmentIdentity): string | null;
+export declare function isLinkedAppointmentResource(identity: LinkedAppointmentIdentity, resourceId: AppointmentResourceId): boolean;
+export declare function deriveStaffSiteHomeDestination(staffScope: StaffScope): StaffSiteHomeDestination;
+export declare function isEventOpsOnlyUser(sites: readonly StaffMembershipInput[]): boolean;
+export declare function deriveSiteListingNavigationPlan(site: StaffMembershipInput): SiteListingNavigationPlan;
+export declare function shouldRedirectStaffScopeToOps(staffScope: StaffScope): boolean;
+export declare function deriveOpsLandingDestination(sites: readonly StaffMembershipInput[]): OpsLandingDestination;

package/dist/_dts/api/src/types.d.ts

@@ -3,7 +3,9 @@ export type { AccessPolicyContract, AccessPolicyTag, CreateMediaAssetBody, Entit
 export type { AnalyticsPreset, AnalyticsReferrer, AnalyticsReportFilters, AnalyticsReportQuery, AnalyticsReportResponse, AnalyticsSeriesPoint, AnalyticsTopPage, AnalyticsTotals, } from "./analytics";
 export type { AIChatMessage, AiBriefTurn, JsonPrimitive, JsonValue, MediaUsageCheckItem, MediaUsageCheckResponse, MediaUsageLocation, } from "./shared-contracts";
 export type * from "./accessAdmin";
-export { STAFF_OPERATIONAL_CAPABILITIES } from "./accessAdmin";
+export { STAFF_OPERATIONAL_CAPABILITIES, getDefaultStaffCapabilities, } from "./accessAdmin";
+export type * from "./staffAccess";
+export { appointmentResourceIdFromStaffMemberId, canAccessOwnAppointmentResource, deriveLinkedAppointmentIdentity, deriveOpsLandingDestination, deriveSiteListingNavigationPlan, deriveStaffScope, deriveStaffSiteHomeDestination, getIdentityAppointmentResourceId, getIdentityAppointmentResourceIdValue, getIdentityStaffMemberId, getIdentityStaffMemberIdValue, getLinkedStaffMemberId, getOwnAppointmentResourceId, hasAppointmentStaffAccess, hasEventOpsAccess, isEventOpsOnlyUser, isLinkedAppointmentResource, isStaffScoped, isTeamMemberScope, roleAtLeast, roleAtLeastOrNone, shouldRedirectStaffScopeToOps, } from "./staffAccess";
 export type * from "./aiEndpoints";
 export type * from "./apiEndpointTypes";
 export type * from "./bookingAdjustments";

package/dist/_dts/api/src/workflows/automaticWorkflowTriggers.d.ts

@@ -0,0 +1,21 @@
+import type { RiverbankSiteConfig, SdkWorkflowConfig } from "../sdkContracts";
+export type EntryDraftUpdatedWorkflowTriggerSource = Readonly<{
+    type: "entry.draft.updated";
+    changedFields: readonly string[];
+    dedupeKey: string;
+}>;
+export type WorkflowTriggerSource = Readonly<{
+    type: "manual";
+}> | EntryDraftUpdatedWorkflowTriggerSource;
+export type AutomaticWorkflowCandidate = Readonly<{
+    workflow: SdkWorkflowConfig;
+    trigger: EntryDraftUpdatedWorkflowTriggerSource;
+}>;
+export type PlanEntryDraftUpdatedWorkflowTriggersInput = Readonly<{
+    sdkConfig: RiverbankSiteConfig | null | undefined;
+    contentType: string;
+    previousDraftContent: Record<string, unknown> | null | undefined;
+    nextDraftContent: Record<string, unknown>;
+    knownFieldIds?: readonly string[];
+}>;
+export declare function planEntryDraftUpdatedWorkflowTriggers(input: PlanEntryDraftUpdatedWorkflowTriggersInput): readonly AutomaticWorkflowCandidate[];

package/dist/_dts/blocks/src/client/site-chrome.d.ts

@@ -14,7 +14,10 @@ export type SiteChromeRenderModel = Readonly<{
     header: SiteChromeBlockRenderSpec;
     footer: SiteChromeBlockRenderSpec;
 }>;
-export declare function renderSiteChromeBlock(model: SiteChromeRenderModel, surface: 'header' | 'footer', theme: Theme): ReactNode;
+export type SiteChromeBlockRenderOptions = Readonly<{
+    themeConfigOverrideMode?: 'apply' | 'ignore';
+}>;
+export declare function renderSiteChromeBlock(model: SiteChromeRenderModel, surface: 'header' | 'footer', theme: Theme, options?: SiteChromeBlockRenderOptions): ReactNode;
 export declare function SiteChromeBlockRenderer({ model, surface, theme, }: {
     model: SiteChromeRenderModel;
     surface: 'header' | 'footer';

package/dist/_dts/blocks/src/customBlockRegistry.d.ts

@@ -13,6 +13,17 @@ export type CustomBlockManifestSource = {
 } | {
     kind: 'managed-database';
 };
+export type CustomBlockSourcePolicy = {
+    kind: 'canonical-db-fallback-sdk';
+};
+export type CustomBlockConflictReason = 'db-canonical-sdk-fallback';
+export type CustomBlockRegistryConflict = {
+    kind: 'conflict';
+    blockKind: `custom.${string}`;
+    winner: CustomBlockManifestSource;
+    loser: CustomBlockManifestSource;
+    reason: CustomBlockConflictReason;
+};
 export type CustomBlockRegistryEntry = {
     manifest: SdkCustomBlock;
     source: CustomBlockManifestSource;
@@ -25,14 +36,22 @@ export type ResolvedCustomBlockManifest = {
 };
 export type CustomBlockRegistry = {
     entries: readonly ResolvedCustomBlockManifest[];
+    conflicts: readonly CustomBlockRegistryConflict[];
     findManifest: (blockKind: string) => ResolvedCustomBlockManifest | undefined;
 };
 export type CustomBlockRegistryInput = {
     sdkConfig?: SdkConfigForBlockPicker | null;
     customBlocks?: readonly CustomBlockRegistryEntry[];
+    policy?: CustomBlockSourcePolicy;
     onConflict?: (message: string) => void;
 };
+export type CustomBlockRegistryResolutionPlan = {
+    policy: CustomBlockSourcePolicy;
+    entries: readonly ResolvedCustomBlockManifest[];
+    conflicts: readonly CustomBlockRegistryConflict[];
+};
 declare function transformToBlockDescriptor(sdkBlock: SdkCustomBlock, source?: BlockDescriptor['source']): BlockDescriptor;
-export declare function createCustomBlockRegistry({ sdkConfig, customBlocks, onConflict, }: CustomBlockRegistryInput): CustomBlockRegistry;
+export declare function planCustomBlockRegistryResolution({ sdkConfig, customBlocks, policy, }: Omit<CustomBlockRegistryInput, 'onConflict'>): CustomBlockRegistryResolutionPlan;
+export declare function createCustomBlockRegistry({ sdkConfig, customBlocks, policy, onConflict, }: CustomBlockRegistryInput): CustomBlockRegistry;
 export declare function mergeBlockDescriptorsWithRegistry(systemBlocks: readonly BlockDescriptor[], registry: CustomBlockRegistry, onConflict?: (message: string) => void): BlockDescriptor[];
 export { transformSdkBlockToManifest, transformSdkBlockToDefinition, transformToBlockDescriptor, };

package/dist/_dts/blocks/src/index.d.ts

@@ -1,6 +1,6 @@
 export { default as PageRenderer } from './PageRenderer';
-export { createCustomBlockRegistry, mergeBlockDescriptorsWithRegistry, transformToBlockDescriptor, } from './customBlockRegistry';
-export type { CustomBlockManifestSource, CustomBlockRegistry, CustomBlockRegistryEntry, ResolvedCustomBlockManifest, SdkConfigForBlockPicker, } from './customBlockRegistry';
+export { createCustomBlockRegistry, mergeBlockDescriptorsWithRegistry, planCustomBlockRegistryResolution, transformToBlockDescriptor, } from './customBlockRegistry';
+export type { CustomBlockConflictReason, CustomBlockManifestSource, CustomBlockRegistry, CustomBlockRegistryConflict, CustomBlockRegistryEntry, CustomBlockRegistryResolutionPlan, CustomBlockSourcePolicy, ResolvedCustomBlockManifest, SdkConfigForBlockPicker, } from './customBlockRegistry';
 export type { BlockOverrideComponent, BlockOverrideProps, BlockOverrides, EntrySubrouteContextData, OccurrenceContextData, SdkConfigForRenderer, } from './PageRenderer';
 export * from './subroutes';
 export * from './primitives/content/components/Button';
@@ -30,6 +30,7 @@ export * from '../../theme-core/src/runtime/buildThemeRuntime';
 export * from '../../theme-core/src/runtime/buildThemeRuntimeFromBridge';
 export * from '../../theme-core/src/siteChrome';
 export * from '../../theme-core/src/blocks/index';
+export { EDITABLE_SURFACE_FORWARDING_PROP, markEditableSurfaceForwarding, type EditableSurfaceForwardingComponent, } from './system/runtime/header/shared';
 export * from './system';
 export { SUPPORTED_LOADER_ENDPOINTS, isSupportedLoaderEndpoint, type SupportedLoaderEndpoint, } from './system/data';
 export type { AuthoredLinkValue, LinkValue, InternalLinkValue, InternalResolvedLinkValue, InternalRouteOnlyLinkValue, ExternalLinkValue, CustomLinkValue, PageLinkValue, EntryLinkValue, } from './system/types/link';