@jskit-ai/users-core 0.1.197 → 0.1.198

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/users-core",
-  "version": "0.1.197",
+  "version": "0.1.198",
   "type": "module",
   "scripts": {
     "test": "node --test"
@@ -13,12 +13,12 @@
     "./shared/resources/userSettingsResource": "./src/shared/resources/userSettingsResource.js"
   },
   "dependencies": {
-    "@jskit-ai/database-runtime": "0.1.184",
-    "@jskit-ai/json-rest-api-core": "0.1.128",
-    "@jskit-ai/resource-core": "0.1.126",
-    "@jskit-ai/resource-crud-core": "0.1.126",
-    "@jskit-ai/storage-runtime": "0.1.181",
-    "@jskit-ai/uploads-runtime": "0.1.159",
+    "@jskit-ai/database-runtime": "0.1.185",
+    "@jskit-ai/json-rest-api-core": "0.1.129",
+    "@jskit-ai/resource-core": "0.1.127",
+    "@jskit-ai/resource-crud-core": "0.1.127",
+    "@jskit-ai/storage-runtime": "0.1.182",
+    "@jskit-ai/uploads-runtime": "0.1.160",
     "json-rest-schema": "^1.0.17"
   },
   "description": "Users/account runtime plus HTTP routes for account features.",
@@ -166,8 +166,8 @@
     }
   },
   "peerDependencies": {
-    "@jskit-ai/auth-core": "0.1.182",
-    "@jskit-ai/http-runtime": "0.1.182",
-    "@jskit-ai/kernel": "0.1.184"
+    "@jskit-ai/auth-core": "0.1.183",
+    "@jskit-ai/http-runtime": "0.1.183",
+    "@jskit-ai/kernel": "0.1.185"
   }
 }

package/patterns/user-administration-server/example/packages/users/package.json

@@ -9,8 +9,8 @@
     "./shared": "./src/shared/index.js"
   },
   "dependencies": {
-    "@jskit-ai/crud-core": "0.1.195",
-    "@jskit-ai/resource-crud-core": "0.1.126"
+    "@jskit-ai/crud-core": "0.1.196",
+    "@jskit-ai/resource-crud-core": "0.1.127"
   },
   "jskit": {
     "kind": "runtime",

package/patterns/user-administration-server/example/packages/users-workspace/package.json

@@ -9,9 +9,9 @@
     "./shared": "./src/shared/index.js"
   },
   "dependencies": {
-    "@jskit-ai/crud-core": "0.1.195",
-    "@jskit-ai/resource-crud-core": "0.1.126",
-    "@jskit-ai/workspaces-core": "0.1.162"
+    "@jskit-ai/crud-core": "0.1.196",
+    "@jskit-ai/resource-crud-core": "0.1.127",
+    "@jskit-ai/workspaces-core": "0.1.163"
   },
   "jskit": {
     "kind": "runtime",

package/src/server/accountNotifications/accountNotificationsActions.js

@@ -17,6 +17,13 @@ const accountNotificationsActionSpecifications = Object.freeze([
     },
     input: userSettingsResource.operations.notificationsUpdate.body,
     output: null,
+    extensions: {
+      assistant: {
+        description: "Update the signed-in user’s notification preferences.",
+        output: userSettingsResource.operations.notificationsUpdate.output,
+        transformResult: (result) => result.value
+      }
+    },
     idempotency: "optional",
     audit: {
       actionName: "settings.notifications.update"

package/src/server/accountPreferences/accountPreferencesActions.js

@@ -17,6 +17,13 @@ const accountPreferencesActionSpecifications = Object.freeze([
     },
     input: userSettingsResource.operations.preferencesUpdate.body,
     output: null,
+    extensions: {
+      assistant: {
+        description: "Update the signed-in user’s display and regional preferences.",
+        output: userSettingsResource.operations.preferencesUpdate.output,
+        transformResult: (result) => result.value
+      }
+    },
     idempotency: "optional",
     audit: {
       actionName: "settings.preferences.update"

package/src/server/accountProfile/accountProfileActions.js

@@ -1,3 +1,4 @@
+import { userSettingsResource } from "../../shared/resources/userSettingsResource.js";
 import {
   emptyInputValidator,
   resolveRequest
@@ -24,6 +25,13 @@ const accountProfileActionSpecifications = deepFreeze([
     },
     input: emptyInputValidator,
     output: null,
+    extensions: {
+      assistant: {
+        description: "Read the signed-in user’s profile, preferences, notifications and security status.",
+        output: userSettingsResource.operations.view.output,
+        transformResult: (result) => result.value
+      }
+    },
     idempotency: "none",
     audit: {
       actionName: "settings.read"
@@ -46,6 +54,13 @@ const accountProfileActionSpecifications = deepFreeze([
     },
     input: settingsProfileUpdateInputValidator,
     output: null,
+    extensions: {
+      assistant: {
+        description: "Update the signed-in user’s display name.",
+        output: userSettingsResource.operations.view.output,
+        transformResult: (result) => result.response.value
+      }
+    },
     idempotency: "optional",
     audit: {
       actionName: "settings.profile.update"
@@ -74,6 +89,11 @@ const accountProfileActionSpecifications = deepFreeze([
     },
     input: userProfileResource.operations.avatarUpload.body,
     output: null,
+    extensions: {
+      assistant: {
+        exclude: "Use the authenticated account profile file picker; upload streams must not enter assistant arguments."
+      }
+    },
     idempotency: "none",
     audit: {
       actionName: "settings.profile.avatar.upload"
@@ -109,6 +129,13 @@ const accountProfileActionSpecifications = deepFreeze([
     },
     input: userProfileResource.operations.avatarDelete.body,
     output: null,
+    extensions: {
+      assistant: {
+        description: "Remove the signed-in user’s uploaded avatar.",
+        output: userSettingsResource.operations.view.output,
+        transformResult: (result) => result.value
+      }
+    },
     idempotency: "none",
     audit: {
       actionName: "settings.profile.avatar.delete"

package/src/server/accountSecurity/accountSecurityActions.js

@@ -25,6 +25,11 @@ const accountSecurityActionSpecifications = Object.freeze([
     },
     input: userSettingsResource.operations.passwordChange.body,
     output: null,
+    extensions: {
+      assistant: {
+        exclude: "Use the authenticated account security form; passwords must not enter assistant arguments."
+      }
+    },
     idempotency: "none",
     audit: {
       actionName: "settings.security.password.change"
@@ -52,6 +57,13 @@ const accountSecurityActionSpecifications = Object.freeze([
     },
     input: userSettingsResource.operations.passwordMethodToggle.body,
     output: null,
+    extensions: {
+      assistant: {
+        description: "Enable or disable password sign-in for the signed-in user, subject to the account authentication policy.",
+        output: userSettingsResource.operations.passwordMethodToggle.output,
+        transformResult: (result) => ({ securityStatus: result.value.securityStatus, settings: result.value.settings })
+      }
+    },
     idempotency: "none",
     audit: {
       actionName: "settings.security.password_method.toggle"
@@ -79,6 +91,11 @@ const accountSecurityActionSpecifications = Object.freeze([
     },
     input: oauthLinkStartInputValidator,
     output: null,
+    extensions: {
+      assistant: {
+        exclude: "Use the authenticated account security screen; OAuth authorization URLs contain transient credentials."
+      }
+    },
     idempotency: "none",
     audit: {
       actionName: "settings.security.oauth.link.start"
@@ -106,6 +123,13 @@ const accountSecurityActionSpecifications = Object.freeze([
     },
     input: userSettingsResource.operations.oauthUnlink.params,
     output: null,
+    extensions: {
+      assistant: {
+        description: "Unlink an OAuth sign-in method from the signed-in account, subject to the account authentication policy.",
+        output: userSettingsResource.operations.oauthUnlink.output,
+        transformResult: (result) => ({ securityStatus: result.value.securityStatus })
+      }
+    },
     idempotency: "none",
     audit: {
       actionName: "settings.security.oauth.unlink"
@@ -133,6 +157,13 @@ const accountSecurityActionSpecifications = Object.freeze([
     },
     input: userSettingsResource.operations.logoutOtherSessions.body,
     output: null,
+    extensions: {
+      assistant: {
+        description: "Sign the current user out of other devices.",
+        output: userSettingsResource.operations.logoutOtherSessions.output,
+        transformResult: () => ({ ok: true })
+      }
+    },
     idempotency: "none",
     audit: {
       actionName: "settings.security.sessions.logout_others"