@joai/sdk 4.2.0 → 4.2.1

package/dist/index.d.mts

@@ -154,8 +154,33 @@ type WalletList = Partial<Record<WarpChainName, {
   provider: WarpWalletProvider;
   address?: string;
 }>>; //#endregion
+//#region src/user/permissions.d.ts
+/** Permission string values — must match joai--api `UserPermission::value`. */
+declare const UserPermissions: {
+  readonly BillingManage: "billing-manage";
+  readonly TeamManage: "team-manage";
+  readonly TeamView: "team-view";
+  readonly TeamMemberInvite: "team-member-invite";
+  readonly TeamMemberRemove: "team-member-remove";
+  readonly TeamSecretView: "team-secret-view";
+  readonly TeamSecretManage: "team-secret-manage";
+  readonly AgentExecute: "agent-execute";
+  readonly AgentWalletManage: "agent-wallet-manage";
+  readonly SwarmCreate: "swarm-create";
+};
+type UserPermission = (typeof UserPermissions)[keyof typeof UserPermissions];
+//#endregion
+//#region src/user/roles.d.ts
+/** Team member roles — values must match joai--api `UserRole::toName()`. */
+declare const UserRoles: {
+  readonly Owner: "owner";
+  readonly Admin: "admin";
+  readonly Member: "member";
+  readonly Developer: "developer";
+};
+type UserRole = (typeof UserRoles)[keyof typeof UserRoles];
+//#endregion
 //#region src/user/types.d.ts
-type UserRole = 'owner' | 'member';
 type UserMode = 'simple' | 'advanced';
 type UserInterest = 'payments' | 'health' | 'content' | 'business' | 'finance' | 'research' | 'shopping' | 'web3' | 'developer' | 'fitness' | 'ecommerce';
 type UserSettings = {
@@ -191,7 +216,6 @@ type UserPrivate = {
   socials: UserSocialAccount[];
   justCreated: boolean;
   affiliate: Affiliate | null;
-  betaRestricted: boolean;
   kyc?: Kyc | null;
   settings: UserSettings;
 };
@@ -242,8 +266,6 @@ type AffiliateTier = {
   threshold: number;
 };
 type AffiliateStatus = 'pending' | 'approved' | 'rejected' | 'suspended' | 'demoted'; //#endregion
-//#region src/team/constants.d.ts
-declare const teamCategories: readonly ["general", "food-drink", "retail", "beauty-wellness", "health", "sports-fitness", "trades-services", "professional-services", "education-culture", "clubs-organizations", "leisure-tourism"]; //#endregion
 //#region src/team/apps.d.ts
 declare const NativeApps: {
   readonly Board: "board";
@@ -264,6 +286,25 @@ declare const NativeApps: {
 };
 type NativeApp = (typeof NativeApps)[keyof typeof NativeApps];
 //#endregion
+//#region src/access/team-access.d.ts
+type TeamFeatureArea = 'nativeApps' | 'agentSettings' | 'teamSettings' | 'developerHub' | 'areas' | 'commerce';
+/** Keys per area that the API evaluates in `team.access`. */
+type TeamAccessCatalog = Partial<Record<TeamFeatureArea, string[]>>;
+type TeamAccessConfig = {
+  accessCatalog: TeamAccessCatalog;
+};
+/** Resolved feature access from API `TeamPrivate.access` — do not evaluate rules on the client. */
+type TeamFeatureAccess = {
+  nativeApps?: Partial<Record<NativeApp, boolean>>;
+  agentSettings?: Partial<Record<string, boolean>>;
+  teamSettings?: Partial<Record<string, boolean>>;
+  developerHub?: Partial<Record<string, boolean>>;
+  areas?: Partial<Record<string, boolean>>;
+  commerce?: Partial<Record<string, boolean>>;
+};
+//#endregion
+//#region src/team/constants.d.ts
+declare const teamCategories: readonly ["general", "food-drink", "retail", "beauty-wellness", "health", "sports-fitness", "trades-services", "professional-services", "education-culture", "clubs-organizations", "leisure-tourism"]; //#endregion
 //#region src/team/types.d.ts
 type TeamCategory = (typeof teamCategories)[number];
 type TeamFeature = 'shop' | 'appointments';
@@ -375,6 +416,10 @@ type TeamPrivate = {
   category: TeamCategory;
   createdAt: string;
   justCreated: boolean;
+  role?: UserRole | null;
+  permissions?: UserPermission[];
+  access?: TeamFeatureAccess;
+  accessCatalog?: TeamAccessCatalog;
 };
 type ByokProviderConfig = {
   apiKey?: string;
@@ -442,8 +487,14 @@ type AiCostsResponse = {
     };
   };
 }; //#endregion
+//#region src/address/enums.d.ts
+declare const AddressTypes: {
+  readonly Billing: "billing";
+  readonly Shipping: "shipping";
+};
+type AddressType = (typeof AddressTypes)[keyof typeof AddressTypes];
+//#endregion
 //#region src/address/types.d.ts
-type AddressType = 'shipping' | 'billing';
 type Address = {
   id: string;
   type: AddressType;
@@ -495,8 +546,30 @@ type AddressCreatePayload = {
   team?: string;
 };
 type AddressUpdatePayload = Partial<Omit<AddressCreatePayload, 'contact' | 'team'>>; //#endregion
+//#region src/commerce/enums.d.ts
+declare const FulfillmentStatuses: {
+  readonly Pending: "pending";
+  readonly ReadyForPickup: "ready_for_pickup";
+  readonly Shipped: "shipped";
+  readonly Delivered: "delivered";
+  readonly Cancelled: "cancelled";
+};
+type FulfillmentStatus = (typeof FulfillmentStatuses)[keyof typeof FulfillmentStatuses];
+declare const FulfillmentMethods: {
+  readonly Shipping: "shipping";
+  readonly Pickup: "pickup";
+};
+type FulfillmentMethod = (typeof FulfillmentMethods)[keyof typeof FulfillmentMethods];
+declare const ReturnStatuses: {
+  readonly Requested: "requested";
+  readonly Approved: "approved";
+  readonly Rejected: "rejected";
+  readonly Received: "received";
+  readonly Closed: "closed";
+};
+type ReturnStatus = (typeof ReturnStatuses)[keyof typeof ReturnStatuses];
+//#endregion
 //#region src/commerce/types.d.ts
-type FulfillmentMethod = 'shipping' | 'pickup';
 type ShippingRate = {
   id: number;
   name: string;
@@ -554,7 +627,6 @@ type FulfillmentLocation = {
   instructions: string | null;
   active: boolean;
 };
-type FulfillmentStatus = 'pending' | 'ready_for_pickup' | 'shipped' | 'delivered' | 'cancelled';
 type Fulfillment = {
   id: string;
   orderId: number;
@@ -571,7 +643,6 @@ type Fulfillment = {
   readyForPickupAt: string | null;
   deliveredAt: string | null;
 };
-type ReturnStatus = 'requested' | 'approved' | 'rejected' | 'received' | 'closed';
 type Return = {
   id: string;
   orderId: number;
@@ -4486,7 +4557,7 @@ type TeamMutationPayload = {
   settings?: Record<string, JsonValue>;
   emails?: {
     email: string;
-    role: 'owner' | 'admin' | 'member';
+    role: UserRole;
   }[];
   website?: string | null;
   phone?: string | null;
@@ -4512,7 +4583,7 @@ declare class TeamsResource {
   updateTagline(teamSlug: string, tagline: TranslatableValue | null): Promise<IAppResponse<TeamPrivate>>;
   invite(teamSlug: string, payload: {
     email: string;
-    role: 'owner' | 'admin' | 'member';
+    role: UserRole;
   }): Promise<IAppResponse<void>>;
   inviteMember(teamSlug: string, email: string, role: UserRole): Promise<IAppResponse<void>>;
   removeMember(teamSlug: string, memberId: string): Promise<IAppResponse<void>>;
@@ -4527,6 +4598,7 @@ declare class TeamsResource {
   }): Promise<IAppResponse<TeamPlace[]>>;
   selectPlace(teamSlug: string, sourceId: string | null): Promise<IAppResponse<TeamPrivate>>;
   listPrivate(): Promise<IAppResponse<TeamPrivate[]>>;
+  accessConfig(): Promise<IAppResponse<TeamAccessConfig>>;
   getInviteByToken(token: string): Promise<IAppResponse<TeamInviteInfo>>;
   acceptInvite(slug: string): Promise<IAppResponse<void>>;
   usage(teamSlug: string): Promise<IAppResponse<TeamUsage>>;

package/dist/index.mjs

@@ -110,6 +110,34 @@ var HttpService = class {
 		};
 	}
 };
+Object.values({
+	Billing: "billing",
+	Shipping: "shipping"
+});
+Object.values({
+	Pending: "pending",
+	ReadyForPickup: "ready_for_pickup",
+	Shipped: "shipped",
+	Delivered: "delivered",
+	Cancelled: "cancelled"
+});
+Object.values({
+	Shipping: "shipping",
+	Pickup: "pickup"
+});
+Object.values({
+	Requested: "requested",
+	Approved: "approved",
+	Rejected: "rejected",
+	Received: "received",
+	Closed: "closed"
+});
+Object.values({
+	Approved: "approved",
+	Rejected: "rejected",
+	Received: "received",
+	Closed: "closed"
+});
 Object.values({
 	Board: "board",
 	Shop: "shop",
@@ -127,6 +155,47 @@ Object.values({
 	Sites: "sites",
 	Contracts: "contracts"
 });
+/** Permission string values — must match joai--api `UserPermission::value`. */
+const UserPermissions = {
+	BillingManage: "billing-manage",
+	TeamManage: "team-manage",
+	TeamView: "team-view",
+	TeamMemberInvite: "team-member-invite",
+	TeamMemberRemove: "team-member-remove",
+	TeamSecretView: "team-secret-view",
+	TeamSecretManage: "team-secret-manage",
+	AgentExecute: "agent-execute",
+	AgentWalletManage: "agent-wallet-manage",
+	SwarmCreate: "swarm-create"
+};
+Object.values(UserPermissions);
+const teamManageOr = (...permissions) => ({ permissionsAny: [UserPermissions.TeamManage, ...permissions] });
+const permissionPresetRules = {
+	teamManage: { permissions: [UserPermissions.TeamManage] },
+	teamView: teamManageOr(UserPermissions.TeamView),
+	billingManage: teamManageOr(UserPermissions.BillingManage),
+	agentTooling: teamManageOr(UserPermissions.AgentExecute),
+	secretView: teamManageOr(UserPermissions.TeamSecretView),
+	secretManage: teamManageOr(UserPermissions.TeamSecretManage),
+	teamMemberInvite: teamManageOr(UserPermissions.TeamMemberInvite),
+	teamMemberRemove: teamManageOr(UserPermissions.TeamMemberRemove),
+	agentWalletManage: teamManageOr(UserPermissions.AgentWalletManage),
+	swarmCreate: teamManageOr(UserPermissions.SwarmCreate)
+};
+permissionPresetRules.teamManage;
+permissionPresetRules.teamView;
+permissionPresetRules.agentTooling;
+permissionPresetRules.billingManage;
+/** Team member roles — values must match joai--api `UserRole::toName()`. */
+const UserRoles = {
+	Owner: "owner",
+	Admin: "admin",
+	Member: "member",
+	Developer: "developer"
+};
+Object.values(UserRoles);
+UserRoles.Member, UserRoles.Developer, UserRoles.Admin;
+UserRoles.Member;
 //#endregion
 //#region src/resources/agents.ts
 var AgentsResource = class {
@@ -2298,6 +2367,9 @@ var TeamsResource = class {
 	listPrivate() {
 		return this.http.get("teams?me=true");
 	}
+	accessConfig() {
+		return this.http.get("teams/access-config");
+	}
 	getInviteByToken(token) {
 		return this.http.get(`teams/invite/${token}`);
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joai/sdk",
-  "version": "4.2.0",
+  "version": "4.2.1",
   "description": "JoAi public API SDK — build with your AI agents",
   "license": "MIT",
   "type": "module",