@joai/sdk 7.0.8 → 9.0.0

package/README.md

@@ -0,0 +1,115 @@
+# @joai/sdk
+
+The React entry point contains reusable building blocks for editable content on client websites. The components stay domain-neutral: sites provide identifiers, copy, styling hooks, and rendered fields; the SDK owns session handoff and the editing lifecycle.
+
+## Managed content editor
+
+```tsx
+import { ManagedContentEditor } from '@joai/react'
+
+<ManagedContentEditor
+  config={{
+    contentId: 'content-id',
+    publicSlug: 'website-content',
+    sessionStorageKey: 'website-content-session',
+    team: 'team-slug',
+  }}
+  initialContent={content}
+  title="Inhalte bearbeiten"
+  labels={{
+    edit: 'Bearbeiten',
+    save: 'Entwurf speichern',
+    saving: 'Wird gespeichert …',
+    publish: 'Veröffentlichen',
+    publishing: 'Wird veröffentlicht …',
+    cancel: 'Abbrechen',
+    toolbar: 'Inhaltseditor',
+    unsaved: 'Nicht gespeicherte Änderungen',
+  }}
+  messages={{
+    conflict: 'Der Inhalt wurde zwischenzeitlich geändert. Deine Eingaben bleiben erhalten. Bitte prüfe sie und versuche es erneut.',
+    loadError: 'Der Inhalt konnte nicht geladen werden.',
+    publishError: 'Die Änderungen konnten nicht veröffentlicht werden.',
+    published: 'Die Änderungen wurden veröffentlicht.',
+    saveError: 'Der Entwurf konnte nicht gespeichert werden.',
+    saved: 'Der Entwurf wurde gespeichert.',
+    sessionExpired: 'Deine Sitzung ist abgelaufen.',
+    unsavedNavigation: 'Du hast nicht gespeicherte Änderungen. Seite wirklich verlassen?',
+  }}
+  imagePickerLabels={{
+    applyCrop: 'Zuschnitt übernehmen',
+    back: 'Zurück',
+    choose: 'Bild auswählen',
+    close: 'Schließen',
+    cropDescription: 'Passe Bildausschnitt und Zoom vor dem Hochladen an.',
+    cropTitle: 'Bild zuschneiden',
+    dimensionsTooLarge: 'Die Bildabmessungen sind zu groß.',
+    dimensionsTooSmall: 'Die Bildabmessungen sind zu klein.',
+    drop: 'Bild hier ablegen',
+    empty: 'Noch keine Bilder vorhanden.',
+    field: 'Bearbeitbares Bild',
+    invalidType: 'Bitte wähle eine Bilddatei.',
+    libraryDescription: 'Wähle ein vorhandenes Bild oder lade ein neues hoch.',
+    libraryTitle: 'Bildmediathek',
+    loadError: 'Bilder konnten nicht geladen werden.',
+    loading: 'Bilder werden geladen …',
+    positionHorizontal: 'Horizontale Position',
+    positionVertical: 'Vertikale Position',
+    processing: 'Bild wird vorbereitet …',
+    retry: 'Erneut versuchen',
+    tooLarge: 'Das Bild ist zu groß.',
+    upload: 'Bild hochladen',
+    uploadError: 'Das Bild konnte nicht hochgeladen werden.',
+    uploading: 'Wird hochgeladen …',
+    zoom: 'Zoom',
+  }}
+  reauthenticateLabel="Anmeldung erneuern"
+  sessionExpiredMessage="Deine Sitzung ist abgelaufen. Deine lokalen Änderungen bleiben erhalten."
+  confirmCancel={() => window.confirm('Nicht gespeicherte Änderungen verwerfen?')}
+  confirmLeave={() => window.confirm('Du hast nicht gespeicherte Änderungen. Seite wirklich verlassen?')}
+  confirmPublish={() => window.confirm('Änderungen jetzt veröffentlichen?')}
+>
+  {children}
+</ManagedContentEditor>
+```
+
+Use `EditableContent`, `EditableImage`, and `useContentValue` from `@joai/react` inside the editor. Pass server-fetched public content as `initialContent` to avoid a client-side loading state for visitors.
+
+Configure each image field as a reusable, domain-neutral building block. Images are compressed to WebP at up to 2560 × 2560 pixels by default, while animated GIF and SVG files retain their original format. Cropping is opt-in per field:
+
+```tsx
+<EditableImage
+  field="heroImage"
+  label="Titelbild"
+  maxSourceBytes={40 * 1024 * 1024}
+  maxUploadBytes={5 * 1024 * 1024}
+  processing={{
+    crop: { aspectRatio: 16 / 9, outputWidth: 1920 },
+    compression: { maxWidth: 1920, maxHeight: 1080, mimeType: 'image/webp', quality: 0.84 },
+    dimensions: { minWidth: 1280, minHeight: 720, maxPixels: 50_000_000 },
+  }}
+/>
+```
+
+Set `compression: false` or `dimensions: false` to disable only that stage, or `processing={false}` to upload the original image without client-side decoding, validation, cropping, or compression.
+
+## Session storage
+
+`useContentSession` and `createSessionTokenStore` are exported for custom shells. A custom `SessionTokenStore` can be injected when a host needs a different persistence mechanism. The URL fragment containing the one-time handoff token is removed before it is exchanged and persisted.
+
+The managed editor automatically adds `platform=app` to its reauthentication return URL so JoAi returns a one-time handoff token. Override `reauthenticateUrl` only when a host has a dedicated login callback.
+
+`createContentDraftStore` uses `sessionStorage` by default. `ManagedContentEditor` wires it automatically so unsaved values survive refreshes and expired-session reauthentication without being shared across browser sessions.
+
+## Editing behavior
+
+- Cancel restores the currently loaded version.
+- Save is disabled when there are no local changes.
+- A dirty publish saves and publishes with one request.
+- Network failures keep local edits available for retry.
+- Refresh, close, and link/navigation attempts warn while edits are unsaved.
+- Editable text and image fields are visibly labelled in edit mode.
+- The image library supports loading, empty, error, byte/dimension validation, cropping, compression, keyboard, focus, and drag-and-drop states.
+- Expired authorization offers a sign-in action and restores locally persisted edits afterwards.
+- Version conflicts load the latest version while preserving local edits.
+- Public content cache entries are invalidated after authenticated mutations.

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import * as _$_joai_core0 from "@joai/core";
-import { Address, AddressCreatePayload, AddressInput, AddressType, AddressUpdatePayload, Affiliate, AffiliateTier, Agent, AgentActionHistoryEntry, AgentPrivate, AgentSettings, AgentTrustedActionRule, AiCostsResponse, Alert, ApiToken, AppEnv, AppIngestion, AppendKvEntryResult, AppointmentAvailability, AppointmentBooking, AppointmentPolicy, AppointmentPolicyUpsert, AppointmentRequest, Artifact, ArtifactCreatePayload, ArtifactDeliverPayload, ArtifactDelivery, ArtifactStatus, ArtifactType, ArtifactUpdatePayload, AuthUser, AuthUser as AuthUser$1, Automation, AutomationActionInput, AutomationAudiencePreview, AutomationCreatePayload, AutomationEnrollment, AutomationStats, AutomationUpdatePayload, Blueprint, BlueprintSettings, BrandBackend, BrandSiteConfig, BrandSourceConfig, CalendarStatus, Campaign, CampaignAudiencePreview, CampaignAudiencePreviewPayload, CampaignCreatePayload, CampaignRecipient, CampaignRecipientStatus, CampaignStats, CampaignUpdatePayload, Card, Cart, Cart as Cart$1, CartLine, ChangelogEntry, Character, CheckoutSnapshot, CheckoutSnapshot as CheckoutSnapshot$1, CheckoutSnapshotRequest, CommissionAgreement, Configuration, Contact, ContactActivity, ContactCreatePayload, ContactFormData, ContactRelation, ContactRelationPayload, ContactRelationUpdatePayload, Content, ContentVersion, Contract, ContractCategoryName, ContractVersion, Coupon, CouponCondition, CouponRestrictedItem, CreateContentInput, CreateHookPayload, CreateHookPayload as CreateHookPayload$1, CreateInboundHookPayload, CreateInternalHookPayload, CreateKvFieldPayload, CreateWarpLinkedHookPayload, CreateWebHookPayload, Document, EarnResponse, Element, ElementSpec, ElementVariation, EmbedStatus, Entity, Flow, Fulfillment, FulfillmentLocation, FulfillmentLocation as FulfillmentLocation$1, FulfillmentMethod, GamificationData, Goal, GoalCreatePayload, GuestBuyer, GuestBuyer as GuestBuyer$1, Hook, Hook as Hook$1, HookSample, HookSample as HookSample$1, HookTrigger, HookTriggerCondition, HookTriggerInput, IAppResponse, IHttpService, IRequestOptions, Inquiry, InquiryType, Integration, IntegrationType, Intent, Item, ItemCreatePayload, ItemUpdatePayload, JsonValue, KvEntryPayload, KvField, KvFieldWithEntries, Link, LinkCreatePayload, LinkStats, LinkUpdatePayload, LinkVariation, LinkVariationBatchCreatePayload, LinkVariationCreatePayload, LoyaltyAccount, LoyaltyMember, LoyaltyProgram, LoyaltyPromotion, LoyaltyReward, LoyaltyTier, LoyaltyTransaction, McpToolCall, Media, MediaAspectRatio, Meeting, MeetingJoinInfo, MeetingSpeakerAssignment, MeetingSummary, Memory, Message, MetricSource, MetricsResult, Mission, MissionCreatePayload, Notification, NotificationChannel, NotificationSetting, OfficeSnapshot, Order, Order as Order$1, OrderContext, OrderPriceMode, OrderPriceMode as OrderPriceMode$1, OrderStatus, OrderStatus as OrderStatus$1, OrderType, PaginatedResponse, Pass, PatchContentInput, PaymentAccount, PaymentAccountOnboarding, PaymentProvider, Plan, PlanFeature, Product, Product as Product$1, ProductRelation, ProductVariation, ProgramSettings, Project, ProjectExportResponse, ProjectInputAssistIntent, ProjectInputAssistResponse, ProjectMutation, ProjectOutputPreset, ProjectOutputType, ProjectStudioHistoryEntry, Proposal, ProposalAction, ProposalPollOption, PublicFormResults, PurchaseResult, RampProviderInfo, Reactions, RedeemResponse, Reminder, Return, ReturnStatus, Room, RoomKind, Segment, SegmentCountPayload, SegmentCountResult, SegmentCreatePayload, Service, SetKvEntryResult, SharedSocialPost, ShippingCarrierOption, ShippingRate, ShippingRate as ShippingRate$1, ShippingZone, Shortcut, Site, SiteBrand, SiteType, Skill, SkillScopeValue, SocialAuthProvider, SocialBot, SocialPlatform, SocialPost, SocialPostConnection, SocialPostCreatePayload, SocialPostGenerateCaptionPayload, SocialPostGeneratedCaption, SocialPostPlatform, SocialPostStatus, SocialPostUpdatePayload, StampResponse, StoreAgent, StoreData, StorePriceTier, StorePurchaseResult, Subscription, Swarm, Tag, TagType, Task, TaxClass, Team, TeamAccessConfig, TeamCategory, TeamEarning, TeamEarningsBalance, TeamFeature, TeamFeatureUsage, TeamMember, TeamMeta, TeamOrderStats, TeamPayout, TeamPayoutAddress, TeamPrivate, TeamUsage, TerminalConnectionToken, TerminalPaymentIntent, ToggleKvFieldResult, TranslatableValue, Update, UpdateCreatePayload, UpdateRelation, UpdateStats, UpdateType, UpdateUpdatePayload, Upgrade, UpgradeStatus, UserPrivate, UserRole, UserSettings, VolumePrice, WarpBackend, WarpBackendStatus, WarpExecutionBackend, WebHookTriggerEvent, WorkspaceCloudFile, WorkspaceInfo, XIntegrationStatus } from "@joai/core";
+import { Address, AddressCreatePayload, AddressInput, AddressType, AddressUpdatePayload, Affiliate, AffiliateTier, Agent, AgentActionHistoryEntry, AgentPrivate, AgentSettings, AgentTrustedActionRule, AiCostsResponse, Alert, ApiToken, AppEnv, AppIngestion, AppendKvEntryResult, AppointmentAvailability, AppointmentBooking, AppointmentPolicy, AppointmentPolicyUpsert, AppointmentRequest, Artifact, ArtifactCreatePayload, ArtifactDeliverPayload, ArtifactDelivery, ArtifactStatus, ArtifactType, ArtifactUpdatePayload, AuthUser, AuthUser as AuthUser$1, Automation, AutomationActionInput, AutomationAudiencePreview, AutomationCreatePayload, AutomationEnrollment, AutomationStats, AutomationUpdatePayload, Blueprint, BlueprintSettings, BrandBackend, BrandSiteConfig, BrandSourceConfig, CalendarStatus, Campaign, CampaignAudiencePreview, CampaignAudiencePreviewPayload, CampaignCreatePayload, CampaignRecipient, CampaignRecipientStatus, CampaignStats, CampaignUpdatePayload, Card, Cart, Cart as Cart$1, CartLine, ChangelogEntry, Character, CheckoutSnapshot, CheckoutSnapshot as CheckoutSnapshot$1, CheckoutSnapshotRequest, CommissionAgreement, Configuration, Contact, ContactActivity, ContactCreatePayload, ContactFormData, ContactRelation, ContactRelationPayload, ContactRelationUpdatePayload, Content, ContentVersion, Contract, ContractCategoryName, ContractVersion, Coupon, CouponCondition, CouponRestrictedItem, CreateContentInput, CreateHookPayload, CreateHookPayload as CreateHookPayload$1, CreateInboundHookPayload, CreateInternalHookPayload, CreateKvFieldPayload, CreateWarpLinkedHookPayload, CreateWebHookPayload, Document, EarnResponse, Element, ElementSpec, ElementVariation, EmbedStatus, Entity, Flow, Fulfillment, FulfillmentLocation, FulfillmentLocation as FulfillmentLocation$1, FulfillmentMethod, GamificationData, Goal, GoalCreatePayload, GuestBuyer, GuestBuyer as GuestBuyer$1, Hook, Hook as Hook$1, HookSample, HookSample as HookSample$1, HookTrigger, HookTriggerCondition, HookTriggerInput, IAppResponse, IHttpService, IRequestOptions, Inquiry, InquiryType, Integration, IntegrationType, Intent, Item, ItemCreatePayload, ItemUpdatePayload, JsonValue, KvEntryPayload, KvField, KvFieldWithEntries, Link, LinkCreatePayload, LinkStats, LinkUpdatePayload, LinkVariation, LinkVariationBatchCreatePayload, LinkVariationCreatePayload, LoyaltyAccount, LoyaltyMember, LoyaltyProgram, LoyaltyPromotion, LoyaltyReward, LoyaltyTier, LoyaltyTransaction, McpToolCall, Media, MediaAspectRatio, Meeting, MeetingJoinInfo, MeetingSpeakerAssignment, MeetingSummary, Memory, Message, MetricSource, MetricsResult, Mission, MissionCreatePayload, Notification, NotificationChannel, NotificationSetting, OfficeSnapshot, Order, Order as Order$1, OrderContext, OrderPriceMode, OrderPriceMode as OrderPriceMode$1, OrderStatus, OrderStatus as OrderStatus$1, OrderType, PaginatedResponse, Pass, PatchContentInput, PaymentAccount, PaymentAccountOnboarding, PaymentProvider, Plan, PlanFeature, Product, Product as Product$1, ProductDetailSection, ProductRelation, ProductVariation, ProgramSettings, Project, ProjectExportResponse, ProjectInputAssistIntent, ProjectInputAssistResponse, ProjectMutation, ProjectOutputPreset, ProjectOutputType, ProjectStudioHistoryEntry, Proposal, ProposalAction, ProposalPollOption, PublicFormResults, PurchaseResult, RampProviderInfo, Reactions, RedeemResponse, Reminder, Return, ReturnStatus, Room, RoomKind, Segment, SegmentCountPayload, SegmentCountResult, SegmentCreatePayload, Service, SetKvEntryResult, SharedSocialPost, ShippingCarrierOption, ShippingRate, ShippingRate as ShippingRate$1, ShippingZone, Shortcut, Site, SiteBrand, SiteType, Skill, SkillScopeValue, SocialAuthProvider, SocialBot, SocialPlatform, SocialPost, SocialPostConnection, SocialPostCreatePayload, SocialPostGenerateCaptionPayload, SocialPostGeneratedCaption, SocialPostPlatform, SocialPostStatus, SocialPostUpdatePayload, StampResponse, StoreAgent, StoreData, StorePriceTier, StorePurchaseResult, Subscription, Swarm, Tag, TagType, Task, TaxClass, Team, TeamAccessConfig, TeamCategory, TeamEarning, TeamEarningsBalance, TeamFeature, TeamFeatureUsage, TeamMember, TeamMeta, TeamOrderStats, TeamPayout, TeamPayoutAddress, TeamPrivate, TeamUsage, TerminalConnectionToken, TerminalPaymentIntent, ToggleKvFieldResult, TranslatableValue, Update, UpdateCreatePayload, UpdateRelation, UpdateStats, UpdateType, UpdateUpdatePayload, Upgrade, UpgradeStatus, UserPrivate, UserRole, UserSettings, VolumePrice, WarpBackend, WarpBackendStatus, WarpExecutionBackend, WebHookTriggerEvent, WorkspaceCloudFile, WorkspaceInfo, XIntegrationStatus } from "@joai/core";
 import { WarpChainName, WarpClient, WarpLocale, WarpText, WarpWalletProvider } from "@joai/warps";
 
 //#region src/resources/agents.d.ts
@@ -1307,7 +1307,7 @@ declare class MeetingsResource {
   get(id: string): Promise<_$_joai_core0.IAppResponse<Meeting>>;
   getSummary(id: string): Promise<_$_joai_core0.IAppResponse<MeetingSummary>>;
   join(code: string): Promise<_$_joai_core0.IAppResponse<MeetingJoinInfo>>;
-  cancel(code: string, data?: {
+  cancel(code: string, options?: {
     reason?: string;
   }): Promise<_$_joai_core0.IAppResponse<Meeting>>;
   share(id: string, recipients: {
@@ -1507,6 +1507,9 @@ declare class ProductsResource {
     virtual?: boolean;
     public?: boolean;
     taxClassId?: string | null;
+    meta?: {
+      details?: ProductDetailSection[];
+    };
   }, teamSlug?: string): Promise<_$_joai_core0.IAppResponse<Product>>;
   update(id: string, data: {
     name?: TranslatableValue;
@@ -1514,6 +1517,9 @@ declare class ProductsResource {
     tags?: string[] | null;
     description?: TranslatableValue | null;
     settings?: Record<string, unknown> | null;
+    meta?: {
+      details?: ProductDetailSection[];
+    };
     active?: boolean;
     public?: boolean;
     virtual?: boolean;

package/dist/index.mjs

@@ -2003,8 +2003,9 @@ var MeetingsResource = class {
 	join(code) {
 		return this.http.get(`meetings/join/${code}`);
 	}
-	cancel(code, data) {
-		return this.http.post(`meetings/cancel/${code}`, data ?? {});
+	cancel(code, options) {
+		const body = options?.reason ? { reason: options.reason } : {};
+		return this.http.post(`meetings/cancel/${code}`, body);
 	}
 	share(id, recipients) {
 		return this.http.post(`meetings/${id}/share`, { recipients });
@@ -3339,7 +3340,7 @@ var MemoryCache = class {
 		this.store.clear();
 	}
 	bust(prefix) {
-		for (const key of this.store.keys()) if (key.startsWith(prefix)) this.store.delete(key);
+		for (const key of this.store.keys()) if (key.startsWith(prefix) || key.startsWith(`/${prefix}`)) this.store.delete(key);
 	}
 };
 //#endregion
@@ -3363,6 +3364,10 @@ const DEFAULTS = {
 	agents: 1e4,
 	rooms: 1e4
 };
+const RELATED_PREFIXES = {
+	content: ["contents"],
+	contents: ["content"]
+};
 function getTtl(url, ttlMap, defaultTtl) {
 	for (const [prefix, ttl] of Object.entries(ttlMap)) if (url.startsWith(prefix) || url.startsWith(`/${prefix}`)) return ttl;
 	return defaultTtl;
@@ -3450,6 +3455,7 @@ var CachedHttpService = class {
 	bust(prefix) {
 		this.cacheVersion++;
 		this.cache.bust(prefix);
+		for (const relatedPrefix of RELATED_PREFIXES[prefix] ?? []) this.cache.bust(relatedPrefix);
 	}
 };
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joai/sdk",
-  "version": "7.0.8",
+  "version": "9.0.0",
   "description": "JoAi public API SDK — build with your AI agents",
   "license": "MIT",
   "type": "module",
@@ -35,11 +35,11 @@
     "test": "jest --config jest.config.js"
   },
   "dependencies": {
-    "@joai/core": "^4.15.7",
+    "@joai/core": "^5.0.0",
     "@joai/warps": "*"
   },
   "peerDependencies": {
-    "@joai/core": "^4.15.7"
+    "@joai/core": "^5.0.0"
   },
   "devDependencies": {
     "tsdown": "^0.21.0",