@appsemble/lang-sdk 0.36.10-test.3 → 0.36.10

package/authorization.d.ts

@@ -7,4 +7,4 @@ export declare function getAppRoles(appSecurityDefinition?: Security): AppRole[]
 export declare function getAppPossibleGuestPermissions(appDefinition: AppDefinition): CustomAppGuestPermission[];
 export declare function getAppPossiblePermissions(appDefinition: AppDefinition): CustomAppPermission[];
 export declare function getAppRolesByPermissions(appSecurityDefinition: Security, requiredPermissions: CustomAppPermission[]): (AppRole | 'Guest')[];
-export declare function checkAppRoleAppPermissions(appSecurityDefinition: Security, appRole: string, requiredPermissions: CustomAppPermission[]): boolean;
+export declare function checkAppRoleAppPermissions(appSecurityDefinition: Security, appRoles: AppRole | AppRole[] | null | undefined, requiredPermissions: CustomAppPermission[]): boolean;

package/authorization.js

@@ -1,4 +1,10 @@
 import { AppPermission, predefinedAppRolePermissions, } from './types/index.js';
+function normalizeAppRoles(appRoles) {
+    if (!appRoles) {
+        return [];
+    }
+    return Array.isArray(appRoles) ? appRoles : [appRoles];
+}
 function checkAppPermissions(acquiredPermissions, requiredPermissions) {
     const customAppResourcePermissionPattern = /^\$resource:[^:]+:(get|history:get|query|create|delete|patch|update)$/;
     const customAppOwnResourcePermissionPattern = /^\$resource:[^:]+:own:(get|query|delete|patch|update)$/;
@@ -150,8 +156,8 @@ export function getAppRolesByPermissions(appSecurityDefinition, requiredPermissi
     }
     return compliantRoles;
 }
-export function checkAppRoleAppPermissions(appSecurityDefinition, appRole, requiredPermissions) {
-    const appRolePermissions = getAppRolePermissions(appSecurityDefinition, [appRole]);
+export function checkAppRoleAppPermissions(appSecurityDefinition, appRoles, requiredPermissions) {
+    const appRolePermissions = getAppRolePermissions(appSecurityDefinition, normalizeAppRoles(appRoles));
     return checkAppPermissions(appRolePermissions, requiredPermissions);
 }
 //# sourceMappingURL=authorization.js.map

package/examples.js

@@ -1241,7 +1241,7 @@ export function createExampleContext(url, lang, userInfo, history) {
             email_verified: true,
             name: 'default-example-name',
             demo: false,
-            role: 'Member',
+            roles: ['Member'],
             zoneinfo: 'Europe/Amsterdam',
             properties: {
                 completedExamples: [],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appsemble/lang-sdk",
-  "version": "0.36.10-test.3",
+  "version": "0.36.10",
   "description": "Language SDK for Appsemble",
   "keywords": [
     "app",

package/reference-schemas/remappers/data.js

@@ -337,6 +337,7 @@ parameters:
             'locale',
             'zoneinfo',
             'role',
+            'roles',
             'properties',
             'phoneNumber',
             'demo',
@@ -355,7 +356,8 @@ Provides some fields of app member information taken from the OpenID user info.
 - \`locale\`: The app member’s default language [\`BCP47\`](https://en.wikipedia.org/wiki/IETF_language_tag)
   language tag (ex. \`en\`) (Broken)
 - \`zoneinfo\`: The app member’s timezone
-- \`role\`: The role of the app member in the app
+- \`role\`: The app member’s first direct role in the app
+- \`roles\`: The direct roles of the app member in the app (\`string[]\`)
 - \`properties\`: Custom properties defined on the app member
 - \`phoneNumber\`: Phone number of the app member if enabled in app definition.
 - \`demo\`: Whether the app member is used for demo purposes.

package/remap.js

@@ -844,7 +844,7 @@ const mapperImplementations = {
         return message.format() || `{${remappedId}}`;
     },
     group: (property, input, context) => context.group?.[property],
-    'app.member': (property, input, context) => context.appMemberInfo?.[property],
+    'app.member': (property, input, context) => property === 'role' ? context.appMemberInfo?.roles?.[0] : context.appMemberInfo?.[property],
     container(property, input, context) {
         // This value is replaced when the request is made
         // By using the value of the release name

package/schemas/actions/AppMemberInviteActionDefinition.js

@@ -3,11 +3,11 @@ import { extendJSONSchema } from '../utils/extendJSONSchema.js';
 export const AppMemberInviteActionDefinition = extendJSONSchema(BaseActionDefinition, {
     type: 'object',
     additionalProperties: false,
-    required: ['type', 'email', 'role'],
+    required: ['type', 'email', 'roles'],
     properties: {
         type: {
             enum: ['app.member.invite'],
-            description: `Allows the app member to invite another app member using an email address and a role.
+            description: `Allows the app member to invite another app member using an email address and one or more roles.
 
 Does nothing if the app member is not logged in.`,
         },
@@ -15,9 +15,9 @@ Does nothing if the app member is not logged in.`,
             $ref: '#/components/schemas/RemapperDefinition',
             description: 'The email to invite.',
         },
-        role: {
+        roles: {
             $ref: '#/components/schemas/RemapperDefinition',
-            description: 'The role of the invited app member.',
+            description: 'The roles of the invited app member.',
         },
     },
 });

package/schemas/actions/AppMemberRoleUpdateActionDefinition.js

@@ -7,7 +7,7 @@ export const AppMemberRoleUpdateActionDefinition = extendJSONSchema(BaseActionDe
     properties: {
         type: {
             enum: ['app.member.role.update'],
-            description: `Allows the app member to update the role of another app member account.
+            description: `Allows the app member to update the roles of another app member account.
 
 Does nothing if the app member isn’t logged in.`,
         },
@@ -15,12 +15,17 @@ Does nothing if the app member isn’t logged in.`,
             $ref: '#/components/schemas/RemapperDefinition',
             description: 'The id of the app member.',
         },
+        roles: {
+            $ref: '#/components/schemas/RemapperDefinition',
+            description: `The updated roles of the app member.
+
+Every role must exist in the roles property of the app's security definition.`,
+        },
         role: {
             $ref: '#/components/schemas/RemapperDefinition',
             description: `The updated role of the app member.
 
-The role must exist in the roles property of the app's security definition or in the predefined app roles in the system -
-\`Member\`, \`MembersManager\`, \`GroupMembersManager\`, \`GroupsManager\`, \`ResourcesManager\` and \`Owner\``,
+Deprecated: use roles instead.`,
         },
     },
 });

package/schemas/actions/ResourceCountActionDefinition.js

@@ -13,6 +13,10 @@ export const ResourceCountActionDefinition = extendJSONSchema(RequestActionDefin
             type: 'string',
             description: 'The type of the resource to count.',
         },
+        selectedGroupId: {
+            $ref: '#/components/schemas/RemapperDefinition',
+            description: 'The ID of the group to scope the request to. Defaults to the currently selected group.',
+        },
         own: {
             type: 'boolean',
             description: 'If only the resources created by the authenticated app member should be included',

package/schemas/actions/ResourceCreateActionDefinition.js

@@ -13,6 +13,10 @@ export const ResourceCreateActionDefinition = extendJSONSchema(RequestActionDefi
             type: 'string',
             description: 'The type of the resource to create.',
         },
+        selectedGroupId: {
+            $ref: '#/components/schemas/RemapperDefinition',
+            description: 'The ID of the group to scope the request to. Defaults to the currently selected group.',
+        },
     },
 }, ['url', 'method']);
 //# sourceMappingURL=ResourceCreateActionDefinition.js.map

package/schemas/actions/ResourceDeleteActionDefinition.js

@@ -13,6 +13,10 @@ export const ResourceDeleteActionDefinition = extendJSONSchema(RequestActionDefi
             type: 'string',
             description: 'The type of the resource to delete.',
         },
+        selectedGroupId: {
+            $ref: '#/components/schemas/RemapperDefinition',
+            description: 'The ID of the group to scope the request to. Defaults to the currently selected group.',
+        },
     },
 }, ['url', 'method']);
 //# sourceMappingURL=ResourceDeleteActionDefinition.js.map

package/schemas/actions/ResourceDeleteAllActionDefinition.js

@@ -16,6 +16,10 @@ export const ResourceDeleteAllActionDefinition = extendJSONSchema(RequestActionD
             type: 'string',
             description: 'The type of the resource to delete.',
         },
+        selectedGroupId: {
+            $ref: '#/components/schemas/RemapperDefinition',
+            description: 'The ID of the group to scope the request to. Defaults to the currently selected group.',
+        },
     },
 }, ['url', 'method']);
 //# sourceMappingURL=ResourceDeleteAllActionDefinition.js.map

package/schemas/actions/ResourceDeleteBulkActionDefinition.js

@@ -13,6 +13,10 @@ export const ResourceDeleteBulkActionDefinition = extendJSONSchema(RequestAction
             type: 'string',
             description: 'The type of the resource to delete.',
         },
+        selectedGroupId: {
+            $ref: '#/components/schemas/RemapperDefinition',
+            description: 'The ID of the group to scope the request to. Defaults to the currently selected group.',
+        },
     },
 }, ['url', 'method']);
 //# sourceMappingURL=ResourceDeleteBulkActionDefinition.js.map

package/schemas/actions/ResourceGetActionDefinition.js

@@ -13,6 +13,10 @@ export const ResourceGetActionDefinition = extendJSONSchema(RequestActionDefinit
             type: 'string',
             description: 'The type of the resource to get.',
         },
+        selectedGroupId: {
+            $ref: '#/components/schemas/RemapperDefinition',
+            description: 'The ID of the group to scope the request to. Defaults to the currently selected group.',
+        },
         view: {
             type: 'string',
             description: 'The view to use for the resource.',

package/schemas/actions/ResourceHistoryGetActionDefinition.js

@@ -13,6 +13,10 @@ export const ResourceHistoryGetActionDefinition = extendJSONSchema(RequestAction
             type: 'string',
             description: 'The type of the resource to get.',
         },
+        selectedGroupId: {
+            $ref: '#/components/schemas/RemapperDefinition',
+            description: 'The ID of the group to scope the request to. Defaults to the currently selected group.',
+        },
     },
 }, ['url']);
 //# sourceMappingURL=ResourceHistoryGetActionDefinition.js.map

package/schemas/actions/ResourcePatchActionDefinition.js

@@ -13,6 +13,10 @@ export const ResourcePatchActionDefinition = extendJSONSchema(RequestActionDefin
             type: 'string',
             description: 'The type of the resource to patch.',
         },
+        selectedGroupId: {
+            $ref: '#/components/schemas/RemapperDefinition',
+            description: 'The ID of the group to scope the request to. Defaults to the currently selected group.',
+        },
         id: {
             $ref: '#/components/schemas/RemapperDefinition',
         },

package/schemas/actions/ResourceQueryActionDefinition.js

@@ -13,6 +13,10 @@ export const ResourceQueryActionDefinition = extendJSONSchema(RequestActionDefin
             type: 'string',
             description: 'The type of the resource to query.',
         },
+        selectedGroupId: {
+            $ref: '#/components/schemas/RemapperDefinition',
+            description: 'The ID of the group to scope the request to. Defaults to the currently selected group.',
+        },
         view: {
             type: 'string',
             description: 'The view to use for the resource.',

package/schemas/actions/ResourceUpdateActionDefinition.js

@@ -13,6 +13,10 @@ export const ResourceUpdateActionDefinition = extendJSONSchema(RequestActionDefi
             type: 'string',
             description: 'The type of the resource to update.',
         },
+        selectedGroupId: {
+            $ref: '#/components/schemas/RemapperDefinition',
+            description: 'The ID of the group to scope the request to. Defaults to the currently selected group.',
+        },
     },
 }, ['url', 'method']);
 //# sourceMappingURL=ResourceUpdateActionDefinition.js.map

package/schemas/actions/ResourceUpdateGroupActionDefinition.js

@@ -13,6 +13,10 @@ export const ResourceUpdateGroupActionDefinition = extendJSONSchema(RequestActio
             type: 'string',
             description: 'The type of the resource to move.',
         },
+        selectedGroupId: {
+            $ref: '#/components/schemas/RemapperDefinition',
+            description: 'The ID of the group to scope the request to. Defaults to the currently selected group.',
+        },
         id: {
             $ref: '#/components/schemas/RemapperDefinition',
             description: 'The ID of the resource to move.',

package/schemas/actions/ResourceUpdatePositionsActionDefinition.js

@@ -13,9 +13,18 @@ export const ResourceUpdatePositionsActionDefinition = extendJSONSchema(RequestA
             type: 'string',
             description: 'The type of the resource to update.',
         },
+        selectedGroupId: {
+            $ref: '#/components/schemas/RemapperDefinition',
+            description: 'The ID of the group to scope the request to. Defaults to the currently selected group.',
+        },
         id: {
             $ref: '#/components/schemas/RemapperDefinition',
         },
+        order: {
+            type: 'string',
+            enum: ['asc', 'desc'],
+            default: 'asc',
+        },
     },
 }, ['url', 'method']);
 //# sourceMappingURL=ResourceUpdatePositionsActionDefinition.js.map

package/types/actionDefinition.d.ts

@@ -419,9 +419,9 @@ export interface AppMemberInviteAction extends BaseActionDefinition<'app.member.
      */
     email: Remapper;
     /**
-     * The role to invite the app member with.
+     * The roles to invite the app member with.
      */
-    role: Remapper;
+    roles: Remapper;
 }
 export interface AppMemberQueryAction extends BaseActionDefinition<'app.member.query'> {
     /**
@@ -440,9 +440,15 @@ export interface AppMemberRoleUpdateAction extends BaseActionDefinition<'app.mem
      */
     sub: Remapper;
     /**
-     * The role of the updated app member
+     * The roles of the updated app member.
      */
-    role: Remapper;
+    roles?: Remapper;
+    /**
+     * The role of the updated app member.
+     *
+     * @deprecated Use `roles` instead.
+     */
+    role?: Remapper;
 }
 export interface AppMemberPropertiesPatchAction extends BaseActionDefinition<'app.member.properties.patch'> {
     /**
@@ -526,6 +532,13 @@ export interface ResourceActionDefinition<T extends ActionName> extends RequestL
      * The name of the resource.
      */
     resource: string;
+    /**
+     * The ID of the group to scope the request to.
+     *
+     * Defaults to the `selectedGroupId` input property, or the app member's currently selected
+     * group when the property is not present.
+     */
+    selectedGroupId?: Remapper;
 }
 interface ViewResourceDefinition {
     /**
@@ -545,6 +558,12 @@ interface ResourceActionWithIdDefinition {
      */
     id?: Remapper;
 }
+interface ResourceOrderQueryDefinition {
+    /**
+     * Whether the resources loaded are in descending order.
+     */
+    order?: 'asc' | 'desc';
+}
 export interface ControllerActionDefinition extends BaseActionDefinition<'controller'> {
     handler: string;
 }
@@ -561,7 +580,7 @@ export type ResourceUpdateActionDefinition = ResourceActionDefinition<'resource.
 export type ResourceUpdateGroupActionDefinition = ResourceActionDefinition<'resource.update.group'> & ResourceActionWithIdDefinition & {
     groupId?: Remapper;
 };
-export type ResourceUpdatePositionsActionDefinition = ResourceActionDefinition<'resource.update.positions'> & ResourceActionWithIdDefinition;
+export type ResourceUpdatePositionsActionDefinition = ResourceActionDefinition<'resource.update.positions'> & ResourceActionWithIdDefinition & ResourceOrderQueryDefinition;
 export type ResourcePatchActionDefinition = ResourceActionDefinition<'resource.patch'> & ResourceActionWithIdDefinition;
 export type AppMemberLogoutAction = BaseActionDefinition<'app.member.logout'>;
 export interface BaseResourceSubscribeActionDefinition<T extends ActionName> extends BaseActionDefinition<T> {

package/types/member.d.ts

@@ -48,8 +48,14 @@ export interface AppMemberInfo {
     zoneinfo?: string;
     /**
      * The role of the app member.
+     *
+     * @deprecated Use roles instead.
      */
-    role: AppRole;
+    role?: AppRole;
+    /**
+     * The direct roles of the app member.
+     */
+    roles: AppRole[];
     /**
      * The end-user's additional properties
      */

package/types/remapper.d.ts

@@ -1,5 +1,5 @@
 import { type RequireExactlyOne } from 'type-fest';
-type AppMemberInfoKey = 'demo' | 'email_verified' | 'email' | 'locale' | 'name' | 'phoneNumber' | 'picture' | 'properties' | 'role' | 'sub' | 'zoneinfo';
+type AppMemberInfoKey = 'demo' | 'email_verified' | 'email' | 'locale' | 'name' | 'phoneNumber' | 'picture' | 'properties' | 'role' | 'roles' | 'sub' | 'zoneinfo';
 interface BaseICSRemapper {
     /**
      * The start of the icalendar event.
@@ -91,7 +91,8 @@ export interface Remappers {
      * - `picture`: Get the picture of the app member.
      * - `locale`: Get the locale of the app member.
      * - `zoneinfo`: Get the zoneinfo of the app member.
-     * - `role`: Get the role of the app member.
+     * - `role`: Get the first direct role of the app member.
+     * - `roles`: Get the direct roles of the app member.
      * - `properties`: Get the custom properties of the app member.
      */
     'app.member': AppMemberInfoKey;