@appsemble/lang-sdk 0.40.3 → 0.40.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appsemble/lang-sdk",
-  "version": "0.40.3",
+  "version": "0.40.5",
   "description": "Language SDK for Appsemble",
   "keywords": [
     "app",

package/pageUtils.d.ts

@@ -1,5 +1,5 @@
 import { type MessageGetter } from './remap.js';
-import { type PageDefinition } from './types/index.js';
+import { type PageDefinition, type Remapper } from './types/index.js';
 type NamedPage = Pick<PageDefinition, 'name'>;
 /**
  * The built-in routes whose URL segment an app may translate through a `routes.<Name>` message.
@@ -48,4 +48,11 @@ export declare function findPageById(pages: PageDefinition[], normalizedPageId:
  * @returns The ancestors, root first, excluding the page itself.
  */
 export declare function getPageAncestors(pages: PageDefinition[], page: PageDefinition, appMemberRoles?: string[]): PageDefinition[];
+/**
+ * Check whether or not the given link represents a link related to the Appsemble core.
+ *
+ * @param link The link to check
+ * @returns Whether or not the given link represents a link related to the Appsemble core.
+ */
+export declare function isAppLink(link: Remapper | string[] | string): link is `/${TranslatableRoute}`;
 export {};

package/pageUtils.js

@@ -117,4 +117,13 @@ export function getPageAncestors(pages, page, appMemberRoles = []) {
     }
     return ancestors;
 }
+/**
+ * Check whether or not the given link represents a link related to the Appsemble core.
+ *
+ * @param link The link to check
+ * @returns Whether or not the given link represents a link related to the Appsemble core.
+ */
+export function isAppLink(link) {
+    return (link === '/Login' || link === '/Settings' || link === '/Register' || link === '/Reset-Password');
+}
 //# sourceMappingURL=pageUtils.js.map

package/reference-schemas/remappers/unsorted.js

@@ -254,7 +254,10 @@ For example:
 
 For example:
 
-${schemaExample('xml.parse', { result: 'pretty' })}`,
+${schemaExample('xml.parse', { result: 'pretty' })}
+
+The tag and attribute names \`__proto__\`, \`constructor\` and \`prototype\` appear in the output
+as \`#__proto__\`, \`#constructor\` and \`#prototype\`.`,
         $ref: '#/components/schemas/RemapperDefinition',
     },
     maths: {

package/remap.d.ts

@@ -75,9 +75,7 @@ interface InternalContext extends RemapperContext {
     stepRef?: {
         current: Record<string, any>;
     };
-    tabRef?: {
-        current: Record<string, any>;
-    };
+    tabName?: string;
 }
 export declare function remap(remapper: Remapper, input: unknown, context: InternalContext | RemapperContext): unknown;
 export {};

package/remap.js

@@ -35,6 +35,21 @@ function isEqualObject(a, b) {
 function isNumber(a) {
     return a !== undefined && a != null && a !== '' && !Number.isNaN(Number(a));
 }
+/**
+ * Tag and attribute names fast-xml-parser refuses to parse, because they could pollute object
+ * prototypes.
+ */
+const prototypeNames = new Set(['__proto__', 'constructor', 'prototype']);
+/**
+ * Prefix tag and attribute names that fast-xml-parser refuses with `#`, so the rest of the
+ * document still parses.
+ *
+ * @param name The XML tag or attribute name.
+ * @returns The name to use as the object key.
+ */
+function escapePrototypeName(name) {
+    return prototypeNames.has(name) ? `#${name}` : name;
+}
 export function remap(remapper, input, context) {
     if (typeof remapper === 'string' ||
         typeof remapper === 'number' ||
@@ -177,9 +192,7 @@ const mapperImplementations = {
         return context.stepRef.current[mapper];
     },
     'tab.name'(mapper, input, context) {
-        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-        // @ts-ignore 18048 variable is possibly undefined (strictNullChecks)
-        return context.tabRef.current.name;
+        return context.tabName;
     },
     gt: ([left, right], input, context) => 
     // eslint-disable-next-line @typescript-eslint/ban-ts-comment
@@ -876,6 +889,8 @@ const mapperImplementations = {
         const parser = new XMLParser({
             ignoreAttributes: false,
             attributeNamePrefix: '',
+            transformAttributeName: escapePrototypeName,
+            transformTagName: escapePrototypeName,
         });
         try {
             return parser.parse(remap(value, input, context) || '');

package/schemas/ContainerPageDefinition.js

@@ -40,7 +40,7 @@ pages:
         pages: {
             type: 'array',
             minItems: 1,
-            description: 'The pages of the app.',
+            description: 'The pages grouped in this container. These may be container pages themselves.',
             items: {
                 anyOf: [
                     { $ref: '#/components/schemas/PageDefinition' },

package/schemas/actions/ResourceQueryActionDefinition.js

@@ -21,6 +21,15 @@ export const ResourceQueryActionDefinition = extendJSONSchema(RequestActionDefin
             type: 'string',
             description: 'The view to use for the resource.',
         },
+        query: {
+            $ref: '#/components/schemas/RemapperDefinition',
+            description: `A remapper that results in either an object containing each property of the query
+string, or a string that gets passed through as-is.
+
+Supported query parameters are \`$filter\`, \`$orderby\`, \`$select\`, \`$top\` (the maximum number of
+resources to return) and \`$skip\` (the number of resources to skip). Combine \`$top\` and \`$skip\`
+with \`$orderby\` to get stable pages.`,
+        },
         own: {
             type: 'boolean',
             description: 'If only the resources created by the authenticated app member should be included',

package/validation.d.ts

@@ -1,15 +1,7 @@
 import { type ValidatorResult } from 'jsonschema';
 import { type Promisable } from 'type-fest';
 import { type IdentifiableBlock } from './blockUtils.js';
-import { type TranslatableRoute } from './pageUtils.js';
-import { type AppDefinition, type BlockManifest, type ProjectImplementations, type Remapper } from './types/index.js';
-/**
- * Check whether or not the given link represents a link related to the Appsemble core.
- *
- * @param link The link to check
- * @returns Whether or not the given link represents a link related to the Appsemble core.
- */
-export declare function isAppLink(link: Remapper | string[] | string): link is `/${TranslatableRoute}`;
+import { type AppDefinition, type BlockManifest, type ProjectImplementations } from './types/index.js';
 export type BlockVersionsGetter = (blockMap: IdentifiableBlock[]) => Promisable<BlockManifest[]>;
 /**
  * Validate an app definition.

package/validation.js

@@ -6,6 +6,7 @@ import { BlockParamInstanceValidator } from './BasicValidator.js';
 import { getAppBlocks, normalizeBlockName } from './blockUtils.js';
 import { partialNormalized } from './constants/index.js';
 import { findPageByName } from './findPageByName.js';
+import { isAppLink } from './pageUtils.js';
 import { bottomNavigationGridArea, breadcrumbsGridArea, builtinPagesGridAreaOrder, getBuiltinPagesDefaultGridLayout, getCascadedGridTemplateAreas, getGridTemplateAreas, gridDeviceOrder, resendBannerGridArea, } from './gridUtils.js';
 import { isValidIconName, parseIconReference } from './icons.js';
 import { iterAction, iterApp } from './iterApp.js';
@@ -44,15 +45,6 @@ function hasResourcePermission(permissions, resourceName, resourceAction, view)
         return false;
     });
 }
-/**
- * Check whether or not the given link represents a link related to the Appsemble core.
- *
- * @param link The link to check
- * @returns Whether or not the given link represents a link related to the Appsemble core.
- */
-export function isAppLink(link) {
-    return (link === '/Login' || link === '/Settings' || link === '/Register' || link === '/Reset-Password');
-}
 function validateJSONSchema(schema, prefix, report) {
     if (schema.type !== 'object') {
         return;