@joai/sdk 7.0.3 → 7.0.5

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, 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, 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, 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, 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, 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, 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, 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
@@ -322,6 +322,75 @@ declare function placeGuestCheckoutOrder(options: {
 }): Promise<PlaceGuestCheckoutOrderResult>;
 declare const isGuestCheckoutError: (error: unknown) => error is GuestCheckoutError;
 //#endregion
+//#region src/commerce/guestCoupon.d.ts
+type GuestCouponPreview = {
+  code: string;
+  discount: number;
+  eligibleSubtotal: number;
+};
+type GuestCouponErrorCode = 'empty_code' | 'empty_cart' | 'invalid' | 'not_applicable';
+declare class GuestCouponError extends Error {
+  readonly code: GuestCouponErrorCode;
+  /** Localized API message when present. */
+  readonly serverMessage?: string | undefined;
+  constructor(code: GuestCouponErrorCode, /** Localized API message when present. */
+
+  serverMessage?: string | undefined);
+}
+type GuestCouponClient = {
+  commerce: {
+    checkout: {
+      validateCoupon(team: string, data: {
+        couponCode: string;
+        items: GuestCheckoutCartItem[];
+      }): Promise<IAppResponse<GuestCouponPreview>>;
+    };
+  };
+};
+/** First `couponCode` validation message from an API error payload. */
+declare const guestCouponMessageFromErrors: (errors: unknown) => string | undefined;
+declare const isGuestCouponError: (error: unknown) => error is GuestCouponError;
+type GuestCartAmounts = {
+  subtotal: number;
+  discount: number;
+  total: number;
+};
+/**
+ * Merchandise subtotal, coupon discount, and payable total (cents) for a guest cart.
+ * Pass the validated preview (or null) so discount and total stay in sync.
+ */
+declare const guestCartAmounts: <T extends CartLine>(cart: T[], preview?: GuestCouponPreview | null) => GuestCartAmounts;
+/**
+ * Validates a guest coupon against cart lines. Throws {@link GuestCouponError} when the
+ * code is empty, the cart is empty, the API rejects it, or the preview discount is ≤ 0
+ * (never treat a no-effect coupon as applied).
+ */
+declare function validateGuestCoupon(options: {
+  client: GuestCouponClient;
+  team: string;
+  couponCode: string;
+  items: GuestCheckoutCartItem[];
+}): Promise<GuestCouponPreview>;
+type RevalidateGuestCouponResult = {
+  status: 'none';
+} | {
+  status: 'applied';
+  preview: GuestCouponPreview;
+} | {
+  status: 'rejected';
+  error: GuestCouponError;
+};
+/**
+ * Re-checks a stored coupon against the current cart (hydrate / cart sync).
+ * Never throws — use `status` to clear or re-apply the draft code.
+ */
+declare function revalidateGuestCoupon(options: {
+  client: GuestCouponClient;
+  team: string;
+  couponCode?: string | null;
+  items: GuestCheckoutCartItem[];
+}): Promise<RevalidateGuestCouponResult>;
+//#endregion
 //#region src/commerce/index.d.ts
 declare class CommerceResource {
   readonly checkout: CheckoutResource;
@@ -810,16 +879,23 @@ declare class ContractsResource {
 declare class DocumentsResource {
   private readonly http;
   constructor(http: IHttpService);
-  list(agent: string, search?: string): Promise<_$_joai_core0.IAppResponse<Document[]>>;
+  list(agent: string, params?: {
+    search?: string;
+    archived?: boolean;
+  }): Promise<_$_joai_core0.IAppResponse<Document[]>>;
   create(agent: string, data: {
     title: string;
     content: string;
     blueprint?: string;
   }): Promise<_$_joai_core0.IAppResponse<Document>>;
   get(id: string): Promise<_$_joai_core0.IAppResponse<Document>>;
+  getShared(slug: string): Promise<_$_joai_core0.IAppResponse<Document>>;
   update(id: string, data: {
     title?: string;
     content?: string;
+    public?: boolean;
+    archived?: boolean;
+    meta?: Record<string, unknown>;
   }): Promise<_$_joai_core0.IAppResponse<Document>>;
   delete(id: string): Promise<_$_joai_core0.IAppResponse<void>>;
   trainFromUrl(agent: string, url: string): Promise<_$_joai_core0.IAppResponse<Document>>;
@@ -972,12 +1048,17 @@ declare class IntentsResource {
 }
 //#endregion
 //#region src/resources/items.d.ts
+type ItemListParams = {
+  status?: string;
+  priority?: string;
+  dueToday?: boolean;
+  scope?: 'mine' | 'all';
+  tag?: string;
+};
 declare class ItemsResource {
   private readonly http;
   constructor(http: IHttpService);
-  list(params?: {
-    status?: string;
-  }): Promise<_$_joai_core0.IAppResponse<Item[]>>;
+  list(params?: ItemListParams): Promise<_$_joai_core0.IAppResponse<Item[]>>;
   get(id: string): Promise<_$_joai_core0.IAppResponse<Item>>;
   create(payload: ItemCreatePayload): Promise<_$_joai_core0.IAppResponse<Item>>;
   update(id: string, data: ItemUpdatePayload): Promise<_$_joai_core0.IAppResponse<Item>>;
@@ -1877,6 +1958,9 @@ declare class SocialPostsResource {
   schedule(id: string, scheduledAt?: string | null): Promise<_$_joai_core0.IAppResponse<SocialPost>>;
   cancel(id: string): Promise<_$_joai_core0.IAppResponse<SocialPost>>;
   retry(id: string): Promise<_$_joai_core0.IAppResponse<SocialPost>>;
+  share(id: string): Promise<_$_joai_core0.IAppResponse<SocialPost>>;
+  revokeShare(id: string): Promise<_$_joai_core0.IAppResponse<SocialPost>>;
+  getShared(token: string): Promise<_$_joai_core0.IAppResponse<SharedSocialPost>>;
   delete(id: string): Promise<_$_joai_core0.IAppResponse<void>>;
 }
 //#endregion
@@ -2260,4 +2344,4 @@ declare class DistributionResource {
   private fetchDistribution;
 }
 //#endregion
-export { AddressesResource, AgentsResource, AlertsResource, ApiTokensResource, AppointmentsResource, type AttachedMedia, type AuthConfirmCodeRequest, type AuthConfirmCodeResponse, type AuthNativeSessionResponse, type AuthPortalSessionResponse, AuthResource, type AuthSendCodeRequest, type AuthUser, AutomationsResource, type BackendWarp, type BackendWarpBrand, BillingResource, BlueprintsResource, type CacheConfig, CachedHttpService, CampaignsResource, CardsResource, type Cart, CartsResource, ChangelogResource, CharactersResource, CheckoutResource, type CheckoutSnapshot, CommerceResource, ContactsResource, ContentResource, ContractsResource, type CreateEmptyGuestCheckoutOptions, type CreateHookPayload, type CreateInboundHookPayload, type CreateInternalHookPayload, type CreateWarpLinkedHookPayload, type CreateWebHookPayload, DeskResource, DistributionResource, DocumentsResource, ElementsResource, EntitiesResource, FlowsResource, type FulfillmentLocation, type FulfillmentLocationInput, FulfillmentsResource, GoalsResource, type GuestBuyer, type GuestCheckoutCartItem, type GuestCheckoutClient, type GuestCheckoutDraft, GuestCheckoutError, type GuestCheckoutErrorCode, type GuestCheckoutSnapshotResult, type GuestCheckoutState, type GuestCommerceStorage, type GuestCommerceStorageOptions, type GuestOrderAccess, type Hook, type HookSample, type HookTrigger, type HookTriggerCondition, type HookTriggerInput, HooksResource, IngestionsResource, InquiriesResource, IntegrationsResource, IntentsResource, ItemsResource, JoAiClient, type JoAiClientConfig, KvResource, LinksResource, LoyaltyResource, McpResource, type MediaUploadType, MeetingsResource, MemoriesResource, MessagesResource, MetricsResource, MissionsResource, NotificationsResource, OfficeResource, type OpenPortalSessionOptions, type OpeningHoursEntry, type OpeningHoursFormatOptions, type Order, type OrderPriceMode, type OrderStatus, OrdersResource, PersonaResource, type PlaceCheckoutOrderRequest, type PlaceGuestCheckoutOrderResult, type Product, type ProductVariation, ProductsResource, ProjectsResource, RemindersResource, ReturnsResource, SegmentsResource, ServicesResource, type ShippingRate, type ShippingRateInput, ShippingResource, type ShippingZoneInput, ShortcutsResource, SitesResource, SkillsResource, SocialPostsResource, StatsResource, StoreResource, SubscriptionsResource, SwarmsResource, TagsResource, TasksResource, type TeamInviteInfo, TeamsResource, UpdatesResource, UpgradesResource, UsersResource, VoiceResource, WalletsResource, WarpsResource, type WebHookTriggerEvent, WorkspaceResource, assertGuestCheckoutReady, buildGuestCheckoutSnapshotRequest, buildGuestOrderReturnUrl, completePortalSession, createClient, createEmptyGuestCheckoutState, createGuestCheckoutSnapshot, createGuestCommerceStorage, formatOpeningHours, getAuthFragmentToken, isAllowedRedirectUrl, isGuestCheckoutError, isPortalCallbackUrl, openPortalSession, placeGuestCheckoutOrder, readGuestOrderReturnAccess, sanitizePortalCallbackUrl, stripGuestOrderReturnToken, toGuestCheckoutDraft };
+export { AddressesResource, AgentsResource, AlertsResource, ApiTokensResource, AppointmentsResource, type AttachedMedia, type AuthConfirmCodeRequest, type AuthConfirmCodeResponse, type AuthNativeSessionResponse, type AuthPortalSessionResponse, AuthResource, type AuthSendCodeRequest, type AuthUser, AutomationsResource, type BackendWarp, type BackendWarpBrand, BillingResource, BlueprintsResource, type CacheConfig, CachedHttpService, CampaignsResource, CardsResource, type Cart, CartsResource, ChangelogResource, CharactersResource, CheckoutResource, type CheckoutSnapshot, CommerceResource, ContactsResource, ContentResource, ContractsResource, type CreateEmptyGuestCheckoutOptions, type CreateHookPayload, type CreateInboundHookPayload, type CreateInternalHookPayload, type CreateWarpLinkedHookPayload, type CreateWebHookPayload, DeskResource, DistributionResource, DocumentsResource, ElementsResource, EntitiesResource, FlowsResource, type FulfillmentLocation, type FulfillmentLocationInput, FulfillmentsResource, GoalsResource, type GuestBuyer, type GuestCartAmounts, type GuestCheckoutCartItem, type GuestCheckoutClient, type GuestCheckoutDraft, GuestCheckoutError, type GuestCheckoutErrorCode, type GuestCheckoutSnapshotResult, type GuestCheckoutState, type GuestCommerceStorage, type GuestCommerceStorageOptions, type GuestCouponClient, GuestCouponError, type GuestCouponErrorCode, type GuestCouponPreview, type GuestOrderAccess, type Hook, type HookSample, type HookTrigger, type HookTriggerCondition, type HookTriggerInput, HooksResource, IngestionsResource, InquiriesResource, IntegrationsResource, IntentsResource, type ItemListParams, ItemsResource, JoAiClient, type JoAiClientConfig, KvResource, LinksResource, LoyaltyResource, McpResource, type MediaUploadType, MeetingsResource, MemoriesResource, MessagesResource, MetricsResource, MissionsResource, NotificationsResource, OfficeResource, type OpenPortalSessionOptions, type OpeningHoursEntry, type OpeningHoursFormatOptions, type Order, type OrderPriceMode, type OrderStatus, OrdersResource, PersonaResource, type PlaceCheckoutOrderRequest, type PlaceGuestCheckoutOrderResult, type Product, type ProductVariation, ProductsResource, ProjectsResource, RemindersResource, ReturnsResource, type RevalidateGuestCouponResult, SegmentsResource, ServicesResource, type ShippingRate, type ShippingRateInput, ShippingResource, type ShippingZoneInput, ShortcutsResource, SitesResource, SkillsResource, SocialPostsResource, StatsResource, StoreResource, SubscriptionsResource, SwarmsResource, TagsResource, TasksResource, type TeamInviteInfo, TeamsResource, UpdatesResource, UpgradesResource, UsersResource, VoiceResource, WalletsResource, WarpsResource, type WebHookTriggerEvent, WorkspaceResource, assertGuestCheckoutReady, buildGuestCheckoutSnapshotRequest, buildGuestOrderReturnUrl, completePortalSession, createClient, createEmptyGuestCheckoutState, createGuestCheckoutSnapshot, createGuestCommerceStorage, formatOpeningHours, getAuthFragmentToken, guestCartAmounts, guestCouponMessageFromErrors, isAllowedRedirectUrl, isGuestCheckoutError, isGuestCouponError, isPortalCallbackUrl, openPortalSession, placeGuestCheckoutOrder, readGuestOrderReturnAccess, revalidateGuestCoupon, sanitizePortalCallbackUrl, stripGuestOrderReturnToken, toGuestCheckoutDraft, validateGuestCoupon };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { HttpService, getApiBaseUrl, isCompleteAddressInput } from "@joai/core";
+import { HttpService, cartLineTotal, cartPayableTotal, getApiBaseUrl, isCompleteAddressInput } from "@joai/core";
 import { WarpClient } from "@joai/warps";
 //#region src/resources/agents.ts
 var AgentsResource = class {
@@ -534,6 +534,90 @@ const isGuestCheckoutError = (error) => {
 	return typeof error === "object" && error !== null && error.name === "GuestCheckoutError" && typeof error.code === "string";
 };
 //#endregion
+//#region src/commerce/guestCoupon.ts
+var GuestCouponError = class extends Error {
+	constructor(code, serverMessage) {
+		super(serverMessage ?? code);
+		this.code = code;
+		this.serverMessage = serverMessage;
+		this.name = "GuestCouponError";
+	}
+};
+/** First `couponCode` validation message from an API error payload. */
+const guestCouponMessageFromErrors = (errors) => {
+	if (!errors || typeof errors !== "object" || Array.isArray(errors)) return void 0;
+	const couponError = errors.couponCode;
+	if (Array.isArray(couponError) && typeof couponError[0] === "string") return couponError[0];
+	if (typeof couponError === "string") return couponError;
+};
+const isGuestCouponError = (error) => {
+	if (error instanceof GuestCouponError) return true;
+	return typeof error === "object" && error !== null && error.name === "GuestCouponError" && typeof error.code === "string";
+};
+const toCheckoutItems = (items) => items.map(({ id, type, quantity }) => ({
+	id,
+	type,
+	quantity
+}));
+/**
+* Merchandise subtotal, coupon discount, and payable total (cents) for a guest cart.
+* Pass the validated preview (or null) so discount and total stay in sync.
+*/
+const guestCartAmounts = (cart, preview) => {
+	const subtotal = cartLineTotal(cart);
+	const discount = Math.max(0, preview?.discount ?? 0);
+	return {
+		subtotal,
+		discount,
+		total: cartPayableTotal(cart, discount)
+	};
+};
+/**
+* Validates a guest coupon against cart lines. Throws {@link GuestCouponError} when the
+* code is empty, the cart is empty, the API rejects it, or the preview discount is ≤ 0
+* (never treat a no-effect coupon as applied).
+*/
+async function validateGuestCoupon(options) {
+	const code = options.couponCode.trim();
+	if (!code) throw new GuestCouponError("empty_code");
+	if (!options.items.length) throw new GuestCouponError("empty_cart");
+	const response = await options.client.commerce.checkout.validateCoupon(options.team, {
+		couponCode: code,
+		items: toCheckoutItems(options.items)
+	});
+	if (!response.ok || !response.data?.code) throw new GuestCouponError("invalid", guestCouponMessageFromErrors(response.errors));
+	if (response.data.discount <= 0) throw new GuestCouponError("not_applicable", guestCouponMessageFromErrors(response.errors));
+	return response.data;
+}
+/**
+* Re-checks a stored coupon against the current cart (hydrate / cart sync).
+* Never throws — use `status` to clear or re-apply the draft code.
+*/
+async function revalidateGuestCoupon(options) {
+	const code = options.couponCode?.trim();
+	if (!code || !options.items.length) return { status: "none" };
+	try {
+		return {
+			status: "applied",
+			preview: await validateGuestCoupon({
+				client: options.client,
+				team: options.team,
+				couponCode: code,
+				items: options.items
+			})
+		};
+	} catch (error) {
+		if (isGuestCouponError(error)) return {
+			status: "rejected",
+			error
+		};
+		return {
+			status: "rejected",
+			error: new GuestCouponError("invalid")
+		};
+	}
+}
+//#endregion
 //#region src/commerce/index.ts
 var CommerceResource = class {
 	constructor(http) {
@@ -1249,10 +1333,12 @@ var DocumentsResource = class {
 	constructor(http) {
 		this.http = http;
 	}
-	list(agent, search) {
-		const params = new URLSearchParams();
-		if (search) params.set("search", search);
-		return this.http.get(`agents/${agent}/documents?${params.toString()}`);
+	list(agent, params) {
+		const query = new URLSearchParams();
+		if (params?.search) query.set("search", params.search);
+		if (params?.archived) query.set("archived", "1");
+		const qs = query.toString();
+		return this.http.get(`agents/${agent}/documents${qs ? `?${qs}` : ""}`);
 	}
 	create(agent, data) {
 		return this.http.post(`agents/${agent}/documents`, data);
@@ -1260,6 +1346,9 @@ var DocumentsResource = class {
 	get(id) {
 		return this.http.get(`documents/${id}`);
 	}
+	getShared(slug) {
+		return this.http.get(`documents/shared/${encodeURIComponent(slug)}`);
+	}
 	update(id, data) {
 		return this.http.put(`documents/${id}`, data);
 	}
@@ -1466,6 +1555,10 @@ var ItemsResource = class {
 	list(params) {
 		const query = new URLSearchParams();
 		if (params?.status) query.set("status", params.status);
+		if (params?.priority) query.set("priority", params.priority);
+		if (params?.dueToday) query.set("dueToday", "1");
+		if (params?.scope) query.set("scope", params.scope);
+		if (params?.tag) query.set("tag", params.tag);
 		const qs = query.toString();
 		return this.http.get(`items${qs ? "?" + qs : ""}`);
 	}
@@ -2785,6 +2878,15 @@ var SocialPostsResource = class {
 	retry(id) {
 		return this.http.post(`social-posts/${id}/retry`, {});
 	}
+	share(id) {
+		return this.http.post(`social-posts/${id}/share`, {});
+	}
+	revokeShare(id) {
+		return this.http.delete(`social-posts/${id}/share`);
+	}
+	getShared(token) {
+		return this.http.get(`social-posts/shared/${token}`);
+	}
 	delete(id) {
 		return this.http.delete(`social-posts/${id}`);
 	}
@@ -3440,4 +3542,4 @@ var DistributionResource = class {
 	}
 };
 //#endregion
-export { AddressesResource, AgentsResource, AlertsResource, ApiTokensResource, AppointmentsResource, AuthResource, AutomationsResource, BillingResource, BlueprintsResource, CachedHttpService, CampaignsResource, CardsResource, CartsResource, ChangelogResource, CharactersResource, CheckoutResource, CommerceResource, ContactsResource, ContentResource, ContractsResource, DeskResource, DistributionResource, DocumentsResource, ElementsResource, EntitiesResource, FlowsResource, FulfillmentsResource, GoalsResource, GuestCheckoutError, HooksResource, IngestionsResource, InquiriesResource, IntegrationsResource, IntentsResource, ItemsResource, JoAiClient, KvResource, LinksResource, LoyaltyResource, McpResource, MeetingsResource, MemoriesResource, MessagesResource, MetricsResource, MissionsResource, NotificationsResource, OfficeResource, OrdersResource, PersonaResource, ProductsResource, ProjectsResource, RemindersResource, ReturnsResource, SegmentsResource, ServicesResource, ShippingResource, ShortcutsResource, SitesResource, SkillsResource, SocialPostsResource, StatsResource, StoreResource, SubscriptionsResource, SwarmsResource, TagsResource, TasksResource, TeamsResource, UpdatesResource, UpgradesResource, UsersResource, VoiceResource, WalletsResource, WarpsResource, WorkspaceResource, assertGuestCheckoutReady, buildGuestCheckoutSnapshotRequest, buildGuestOrderReturnUrl, completePortalSession, createClient, createEmptyGuestCheckoutState, createGuestCheckoutSnapshot, createGuestCommerceStorage, formatOpeningHours, getAuthFragmentToken, isAllowedRedirectUrl, isGuestCheckoutError, isPortalCallbackUrl, openPortalSession, placeGuestCheckoutOrder, readGuestOrderReturnAccess, sanitizePortalCallbackUrl, stripGuestOrderReturnToken, toGuestCheckoutDraft };
+export { AddressesResource, AgentsResource, AlertsResource, ApiTokensResource, AppointmentsResource, AuthResource, AutomationsResource, BillingResource, BlueprintsResource, CachedHttpService, CampaignsResource, CardsResource, CartsResource, ChangelogResource, CharactersResource, CheckoutResource, CommerceResource, ContactsResource, ContentResource, ContractsResource, DeskResource, DistributionResource, DocumentsResource, ElementsResource, EntitiesResource, FlowsResource, FulfillmentsResource, GoalsResource, GuestCheckoutError, GuestCouponError, HooksResource, IngestionsResource, InquiriesResource, IntegrationsResource, IntentsResource, ItemsResource, JoAiClient, KvResource, LinksResource, LoyaltyResource, McpResource, MeetingsResource, MemoriesResource, MessagesResource, MetricsResource, MissionsResource, NotificationsResource, OfficeResource, OrdersResource, PersonaResource, ProductsResource, ProjectsResource, RemindersResource, ReturnsResource, SegmentsResource, ServicesResource, ShippingResource, ShortcutsResource, SitesResource, SkillsResource, SocialPostsResource, StatsResource, StoreResource, SubscriptionsResource, SwarmsResource, TagsResource, TasksResource, TeamsResource, UpdatesResource, UpgradesResource, UsersResource, VoiceResource, WalletsResource, WarpsResource, WorkspaceResource, assertGuestCheckoutReady, buildGuestCheckoutSnapshotRequest, buildGuestOrderReturnUrl, completePortalSession, createClient, createEmptyGuestCheckoutState, createGuestCheckoutSnapshot, createGuestCommerceStorage, formatOpeningHours, getAuthFragmentToken, guestCartAmounts, guestCouponMessageFromErrors, isAllowedRedirectUrl, isGuestCheckoutError, isGuestCouponError, isPortalCallbackUrl, openPortalSession, placeGuestCheckoutOrder, readGuestOrderReturnAccess, revalidateGuestCoupon, sanitizePortalCallbackUrl, stripGuestOrderReturnToken, toGuestCheckoutDraft, validateGuestCoupon };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joai/sdk",
-  "version": "7.0.3",
+  "version": "7.0.5",
   "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.2",
+    "@joai/core": "^4.15.4",
     "@joai/warps": "*"
   },
   "peerDependencies": {
-    "@joai/core": "^4.15.2"
+    "@joai/core": "^4.15.4"
   },
   "devDependencies": {
     "tsdown": "^0.21.0",