@directus/app 9.5.0 → 9.5.1

package/dist/assets/use-sync.4163a308.js

@@ -1 +0,0 @@
-var K=Object.defineProperty,Y=Object.defineProperties;var Z=Object.getOwnPropertyDescriptors;var W=Object.getOwnPropertySymbols;var ee=Object.prototype.hasOwnProperty,te=Object.prototype.propertyIsEnumerable;var J=(e,l,r)=>l in e?K(e,l,{enumerable:!0,configurable:!0,writable:!0,value:r}):e[l]=r,I=(e,l)=>{for(var r in l||(l={}))ee.call(l,r)&&J(e,r,l[r]);if(W)for(var r of W(l))te.call(l,r)&&J(e,r,l[r]);return e},L=(e,l)=>Y(e,Z(l));import{ad as M,l as S,G as k,v as R,o as g,y as ne,ah as E,ac as B,n as le,ao as re,a0 as se}from"./vendor.9c15ff54.js";function Ee(e){return e}function xe(e){return e}function $e(e){return e}function Fe(e){return e}function Oe(e){return e}function Te(e){return e}function Re(e){return e}const $=M.extend({type:"string",base:M.string(),messages:{"string.contains":"{{#label}} must contain [{{#substring}}]","string.ncontains":"{{#label}} can't contain [{{#substring}}]"},rules:{contains:{args:[{name:"substring",ref:!0,assert:e=>typeof e=="string",message:"must be a string"}],method(e){return this.$_addRule({name:"contains",args:{substring:e}})},validate(e,l,{substring:r}){return e.includes(r)===!1?l.error("string.contains",{substring:r}):e}},ncontains:{args:[{name:"substring",ref:!0,assert:e=>typeof e=="string",message:"must be a string"}],method(e){return this.$_addRule({name:"ncontains",args:{substring:e}})},validate(e,l,{substring:r}){return e.includes(r)===!0?l.error("string.ncontains",{substring:r}):e}}}}),ae={requireAll:!1};function ie(e,l){var r,u;e=e||{},l=S.exports.merge({},ae,l);const t={},n=Object.keys(e)[0];if(!n)throw new Error(`[generateJoi] Filter doesn't contain field key. Passed filter: ${JSON.stringify(e)}`);const o=Object.values(e)[0];if(!o)throw new Error(`[generateJoi] Filter doesn't contain filter rule. Passed filter: ${JSON.stringify(e)}`);if(((r=Object.keys(o)[0])===null||r===void 0?void 0:r.startsWith("_"))===!1)t[n]=$.object({[n]:ie(o,l)});else{const i=Object.keys(o)[0],a=Object.values(o)[0],p=()=>{var s;return(s=t[n])!==null&&s!==void 0?s:$.any()},d=()=>{var s;return(s=t[n])!==null&&s!==void 0?s:$.string()},b=()=>{var s;return(s=t[n])!==null&&s!==void 0?s:$.number()},v=()=>{var s;return(s=t[n])!==null&&s!==void 0?s:$.date()};if(i==="_eq"&&(t[n]=p().equal(a)),i==="_neq"&&(t[n]=p().not(a)),i==="_contains"&&(t[n]=d().contains(a)),i==="_ncontains"&&(t[n]=d().ncontains(a)),i==="_starts_with"&&(t[n]=d().pattern(new RegExp(`^${S.exports.escapeRegExp(a)}.*`),{name:"starts_with"})),i==="_nstarts_with"&&(t[n]=d().pattern(new RegExp(`^${S.exports.escapeRegExp(a)}.*`),{name:"starts_with",invert:!0})),i==="_ends_with"&&(t[n]=d().pattern(new RegExp(`.*${S.exports.escapeRegExp(a)}$`),{name:"ends_with"})),i==="_nends_with"&&(t[n]=d().pattern(new RegExp(`.*${S.exports.escapeRegExp(a)}$`),{name:"ends_with",invert:!0})),i==="_in"&&(t[n]=p().equal(...a)),i==="_nin"&&(t[n]=p().not(...a)),i==="_gt"&&(t[n]=Number.isSafeInteger(a)?b().greater(a):v().greater(a)),i==="_gte"&&(t[n]=Number.isSafeInteger(a)?b().min(a):v().min(a)),i==="_lt"&&(t[n]=Number.isSafeInteger(a)?b().less(a):v().less(a)),i==="_lte"&&(t[n]=Number.isSafeInteger(a)?b().max(a):v().max(a)),i==="_null"&&(t[n]=p().valid(null)),i==="_nnull"&&(t[n]=p().invalid(null)),i==="_empty"&&(t[n]=p().valid("")),i==="_nempty"&&(t[n]=p().invalid("")),i==="_between")if(a.every(s=>Number.isSafeInteger(s))){const s=a;t[n]=b().greater(s[0]).less(s[1])}else{const s=a;t[n]=v().greater(s[0]).less(s[1])}if(i==="_nbetween")if(a.every(s=>Number.isSafeInteger(s))){const s=a;t[n]=b().less(s[0]).greater(s[1])}else{const s=a;t[n]=v().less(s[0]).greater(s[1])}if(i==="_submitted"&&(t[n]=p().required()),i==="_regex"){const s=a.startsWith("/")&&a.endsWith("/");t[n]=d().regex(new RegExp(s?a.slice(1,-1):a))}}return t[n]=(u=t[n])!==null&&u!==void 0?u:$.any(),l.requireAll&&(t[n]=t[n].required()),$.object(t).unknown()}function je(e){if(e===null)return[];const l=/{{(.*?)}}/g;let r=e.match(l);return Array.isArray(r)?(r=r.map(u=>u.replace(/{{/g,"").replace(/}}/g,"").trim()),r):[]}function Ie(e){var l,r,u;const{relation:t,collection:n,field:o}=e;return t?t.collection===n&&t.field===o&&((l=t.meta)===null||l===void 0?void 0:l.one_collection_field)&&((r=t.meta)===null||r===void 0?void 0:r.one_allowed_collections)?"m2a":t.collection===n&&t.field===o?"m2o":t.related_collection===n&&((u=t.meta)===null||u===void 0?void 0:u.one_field)===o?"o2m":null:null}const ue="stores",oe="api",ce="extensions";function fe(e,l,r){const u=e[l],t=e.length,n=l-r;if(u===void 0)return e;if(n>0)return[...e.slice(0,r),u,...e.slice(r,l),...e.slice(l+1,t)];if(n<0){const o=r+1;return[...e.slice(0,l),...e.slice(l+1,o),u,...e.slice(o,t)]}return e}function de(){const e=k(ue);if(!e)throw new Error("[useStores]: The stores could not be found.");return e}function ve(){const e=k(oe);if(!e)throw new Error("[useApi]: The api could not be found.");return e}function pe(){const e=k(ce);if(!e)throw new Error("[useExtensions]: The extensions could not be found.");return e}function me(e){const{useCollectionsStore:l,useFieldsStore:r}=de(),u=l(),t=r(),n=typeof e=="string"?R(e):e,o=g(()=>u.collections.find(({collection:c})=>c===n.value)||null),i=g(()=>n.value?t.getFieldsForCollection(n.value):[]),a=g(()=>{var c;if(!i.value)return{};const f={};for(const w of i.value)((c=w.schema)===null||c===void 0?void 0:c.default_value)&&(f[w.field]=w.schema.default_value);return f}),p=g(()=>i.value.find(c=>{var f;return c.collection===n.value&&((f=c.schema)===null||f===void 0?void 0:f.is_primary_key)===!0})||null),d=g(()=>{var c;return((c=i.value)===null||c===void 0?void 0:c.find(f=>{var w;return(((w=f.meta)===null||w===void 0?void 0:w.special)||[]).includes("user_created")}))||null}),b=g(()=>{var c,f;return((f=(c=o.value)===null||c===void 0?void 0:c.meta)===null||f===void 0?void 0:f.sort_field)||null}),v=g(()=>{var c,f;return((f=(c=o.value)===null||c===void 0?void 0:c.meta)===null||f===void 0?void 0:f.singleton)===!0}),s=g(()=>!o.value||!o.value.meta?null:o.value.meta.accountability);return{info:o,fields:i,defaults:a,primaryKeyField:p,userCreatedField:d,sortField:b,isSingleton:v,accountabilityScope:s}}function Ne(e,l,r=!0){const u=ve(),{primaryKeyField:t}=me(e),{fields:n,limit:o,sort:i,search:a,filter:p,page:d}=l,b=g(()=>e.value?e.value.startsWith("directus_")?`/${e.value.substring(9)}`:`/items/${e.value}`:null),v=R([]),s=R(!1),c=R(null),f=R(null),w=R(null),D=g(()=>{var _,y;return f.value===null||f.value<((_=E(o))!==null&&_!==void 0?_:100)?1:Math.ceil(f.value/((y=E(o))!==null&&y!==void 0?y:100))});let F=null,O=null;const A=S.exports.throttle(q,500);return r&&A(),ne([e,o,i,a,p,n,d],async(_,y)=>{if(S.exports.isEqual(_,y))return;const[h,m,x,T,N,j,ye]=_,[P,G,H,V,z,he,be]=y;!h||!l||((!S.exports.isEqual(N,z)||!S.exports.isEqual(x,H)||m!==G||T!==V)&&P&&(d.value=1),h!==P&&Q(),A())},{deep:!0,immediate:!0}),{itemCount:f,totalCount:w,items:v,totalPages:D,loading:s,error:c,changeManualSort:X,getItems:q};async function q(){var _,y;if(!b.value)return;F==null||F.cancel(),F=null,c.value=null,O&&clearTimeout(O),O=setTimeout(()=>{s.value=!0},150);let h=[...(_=E(n))!==null&&_!==void 0?_:[]];!((y=E(n))===null||y===void 0?void 0:y.includes("*"))&&t.value&&h.includes(t.value.field)===!1&&h.push(t.value.field),h=h.filter(m=>m.startsWith("$")===!1);try{F=B.CancelToken.source();const m=await u.get(b.value,{params:{limit:E(o),fields:h,sort:E(i),page:E(d),search:E(a),filter:E(p),meta:["filter_count","total_count"]},cancelToken:F.token});let x=m.data.data;e.value==="directus_files"&&(x=x.map(T=>L(I({},T),{$thumbnail:T}))),v.value=x,w.value=m.data.meta.total_count,f.value=m.data.meta.filter_count,d&&x.length===0&&(d==null?void 0:d.value)!==1&&(d.value=1)}catch(m){B.isCancel(m)||(c.value=m)}finally{O&&(clearTimeout(O),O=null),s.value=!1}}function Q(){v.value=[],w.value=null,f.value=null}async function X({item:_,to:y}){var h;const m=(h=t.value)===null||h===void 0?void 0:h.field;if(!m)return;const x=v.value.findIndex(j=>j[m]===_),T=v.value.findIndex(j=>j[m]===y);v.value=fe(v.value,x,T);const N=g(()=>`/utils/sort/${e.value}`);await u.post(N.value,{item:_,to:y})}}const C="wrapper",U=["selection","layoutOptions","layoutQuery"];function ge(e){return U.includes(e)}function _e(e){return le({name:`${e.id}-${C}`,props:{collection:{type:String,required:!0},selection:{type:Array,default:()=>[]},layoutOptions:{type:Object,default:()=>({})},layoutQuery:{type:Object,default:()=>({})},filter:{type:Object,default:null},filterUser:{type:Object,default:null},filterSystem:{type:Object,default:null},search:{type:String,default:null},showSelect:{type:String,default:"multiple"},selectMode:{type:Boolean,default:!1},readonly:{type:Boolean,default:!1},resetPreset:{type:Function,default:null},clearFilters:{type:Function,default:null}},emits:U.map(l=>`update:${l}`),setup(l,{emit:r}){const u=re(I(I({},e.setup(l,{emit:r})),se(l)));for(const t in u)u[`onUpdate:${t}`]=n=>{ge(t)?r(`update:${t}`,n):Object.keys(l).includes(t)||(u[t]=n)};return{state:u}},render(l){return l.$slots.default!==void 0?l.$slots.default({layoutState:l.state}):null}})}function ke(e){const{layouts:l}=pe(),r=g(()=>l.value.map(t=>_e(t)));return{layoutWrapper:g(()=>{const t=r.value.find(n=>n.name===`${e.value}-${C}`);return t===void 0?r.value.find(n=>n.name===`tabular-${C}`):t})}}function Ce(e,l,r){return g({get(){return e[l]},set(u){r(`update:${l}`,u)}})}export{oe as A,ce as E,ue as S,ke as a,me as b,je as c,Fe as d,Ie as e,Re as f,ie as g,xe as h,Ee as i,$e as j,Ne as k,Oe as l,Te as m,de as n,ve as o,pe as p,Ce as u};

package/dist/assets/user-directory.88f66846.js

@@ -1 +0,0 @@
-import{r as i,p as c,q as u,w as t,z as e,t as n,R as s}from"./vendor.9c15ff54.js";const h={class:"markdown-body"},d=s("Users"),g=s(" are the individual accounts for logging in to the App. Each user belongs to a "),p=s("Role"),_=s(" which defines its "),f=s("Permissions"),m=s(". The User Directory shows all users within the project, each with their own customizable profile page."),w=e("p",null,[e("div",{class:"table-of-contents"},[e("ul",null,[e("li",null,[e("a",{href:"#browsing-users"},"Browsing Users")]),e("li",null,[e("a",{href:"#viewing-a-user"},"Viewing a User")]),e("li",null,[e("a",{href:"#editing-a-user"},"Editing a User")])])])],-1),y=e("h2",{id:"browsing-users"},[s("Browsing Users "),e("a",{class:"header-anchor",href:"#browsing-users"},"#")],-1),v=s("Lists all users of the project, with a navigation that allows quick access to the different role groups. This page has the same functionality as other "),b=s("Content Pages"),T=s("."),A=e("h2",{id:"viewing-a-user"},[s("Viewing a User "),e("a",{class:"header-anchor",href:"#viewing-a-user"},"#")],-1),U=e("p",null,"Users are referenced throughout the app, often for accountability purposes. Hovering over a user in this context will provide a popover for basic information, and clicking that popover will navigate you to a readonly view of that user\u2019s profile page.",-1),k=e("h2",{id:"editing-a-user"},[s("Editing a User "),e("a",{class:"header-anchor",href:"#editing-a-user"},"#")],-1),x=s("You can access your profile page from the User Directory or by clicking the User Menu in the "),D=s("Module Bar"),L=s(". The profile page has the same features and functionality as the "),B=s("Item Page"),E=s(". Administrators can customize the fields on this page, but the following are available by default."),N=e("ul",null,[e("li",null,[e("strong",null,"First Name"),s(" \u2014 The given name")]),e("li",null,[e("strong",null,"Last Name"),s(" \u2014 The family/surname")]),e("li",null,[e("strong",null,"Email"),s(" \u2014 A unique email address")]),e("li",null,[e("strong",null,"Password"),s(" \u2014 A hashed system password")]),e("li",null,[e("strong",null,"Avatar"),s(" \u2014 An image to represent the user")]),e("li",null,[e("strong",null,"Location"),s(" \u2014 The city, country, office, or branch name")]),e("li",null,[e("strong",null,"Title"),s(" \u2014 The professional staff title")]),e("li",null,[e("strong",null,"Description"),s(" \u2014 A freeform text description")]),e("li",null,[e("strong",null,"Tags"),s(" \u2014 Keywords for searchability")]),e("li",null,[e("strong",null,"Language"),s(" \u2014 The preferred App language/locale")]),e("li",null,[e("strong",null,"Theme"),s(" \u2014 Light or Dark mode (or based on system preferences)")]),e("li",null,[e("strong",null,"Multi-Factor Authentication"),s(" \u2014 Configuration for MFA")]),e("li",null,[e("strong",null,"Email Notifications"),s(" - Receive emails for notifications")])],-1),P=e("p",null,"The sidebar\u2019s info component also includes the following readonly details:",-1),V=e("ul",null,[e("li",null,[e("strong",null,"User Key"),s(" \u2014 The primary key of the user")]),e("li",null,[e("strong",null,"Last Page"),s(" \u2014 The last App page accessed by the user")]),e("li",null,[e("strong",null,"Last Access"),s(" \u2014 The timestamp of the user\u2019s last App or API action")])],-1),q=e("div",{class:"tip hint"},[e("div",{class:"hint-title"},"System Fields"),e("p",null,"Administrators have access to additional system fields.")],-1),z={setup(C,{expose:a}){const l={title:"User Directory",modularExtension:!1};return a({frontmatter:l}),(F,M)=>{const o=i("router-link"),r=i("DocsWrapper");return c(),u(r,{frontmatter:l},{default:t(()=>[e("div",h,[e("blockquote",null,[e("p",null,[n(o,{to:"/docs/getting-started/glossary#users"},{default:t(()=>[d]),_:1}),g,n(o,{to:"/docs/getting-started/glossary#roles"},{default:t(()=>[p]),_:1}),_,n(o,{to:"/docs/getting-started/glossary#permissions"},{default:t(()=>[f]),_:1}),m])]),w,y,e("p",null,[v,n(o,{to:"/docs/app/content-collections/"},{default:t(()=>[b]),_:1}),T]),A,U,k,e("p",null,[x,n(o,{to:"/docs/app/overview/#_1-module-bar"},{default:t(()=>[D]),_:1}),L,n(o,{to:"/docs/app/content-items/"},{default:t(()=>[B]),_:1}),E]),N,P,V,q])]),_:1})}}};export{z as default};

package/dist/assets/users-roles-permissions.2c43c5a9.js

@@ -1 +0,0 @@
-import{r as o,p as c,q as u,w as t,z as e,t as n,R as s}from"./vendor.9c15ff54.js";const d={class:"markdown-body"},h=s("Users"),g=s(" are the individual accounts for authenticating into the API and App. Each user belongs to a "),_=s("Role"),f=s(" which defines its access "),p=s("Permissions"),m=s("."),b=e("p",null,[e("div",{class:"table-of-contents"},[e("ul",null,[e("li",null,[e("a",{href:"#creating-a-user"},"Creating a User")]),e("li",null,[e("a",{href:"#inviting-a-user"},"Inviting a User")]),e("li",null,[e("a",{href:"#configuring-a-user"},"Configuring a User")]),e("li",null,[e("a",{href:"#archiving-a-user"},"Archiving a User")]),e("li",null,[e("a",{href:"#deleting-a-user"},"Deleting a User")]),e("li",null,[e("a",{href:"#creating-a-role"},"Creating a Role")]),e("li",null,[e("a",{href:"#configuring-a-role"},"Configuring a Role")]),e("li",null,[e("a",{href:"#deleting-a-role"},"Deleting a Role")]),e("li",null,[e("a",{href:"#configuring-permissions"},"Configuring Permissions")]),e("li",null,[e("a",{href:"#configuring-workflows"},"Configuring Workflows")])])])],-1),y=e("h2",{id:"creating-a-user"},[s("Creating a User "),e("a",{class:"header-anchor",href:"#creating-a-user"},"#")],-1),v=e("ol",null,[e("li",null,[s("Navigate to the "),e("strong",null,"User Library")]),e("li",null,[s("Click the "),e("strong",null,"Create User"),s(" action button in the header")]),e("li",null,[s("Enter an "),e("strong",null,"Email Address")]),e("li",null,[s("Optional: Complete the "),e("strong",null,"other user form fields")])],-1),w=e("h2",{id:"inviting-a-user"},[s("Inviting a User "),e("a",{class:"header-anchor",href:"#inviting-a-user"},"#")],-1),A=e("ol",null,[e("li",null,[s("Navigate to the "),e("strong",null,"User Library")]),e("li",null,[s("Click the "),e("strong",null,"Invite Users"),s(" button in the header")]),e("li",null,[s("Enter "),e("strong",null,"one or more email addresses"),s(", separated by new lines, in the modal")]),e("li",null,[s("Click "),e("strong",null,"Invite")])],-1),C=e("p",null,"At this point the invited user(s) will receive an email with a link to the App where they set a password and enable their account.",-1),P=e("h2",{id:"configuring-a-user"},[s("Configuring a User "),e("a",{class:"header-anchor",href:"#configuring-a-user"},"#")],-1),k=e("li",null,[s("Navigate to the "),e("strong",null,"User Library")],-1),R=e("li",null,[e("strong",null,"Click on the user"),s(" you wish to manage")],-1),U=e("strong",null,"Complete the form",-1),I=s(" of "),D=s("User Fields"),T=e("p",null,"The User Detail is only editable by the current user and admins, and the following fields are only available to admins:",-1),F=e("li",null,[e("strong",null,"Status"),s(" \u2014 Determines if an account is able to access the platform or not. Only the "),e("code",null,"active"),s(" state is able to authenticate, all others are simply descriptive inactive states. "),e("ul",null,[e("li",null,[e("strong",null,"Draft"),s(" \u2014 An incomplete user; no App/API access")]),e("li",null,[e("strong",null,"Invited"),s(" \u2014 Has a pending invite to the project; no App/API access until accepted")]),e("li",null,[e("strong",null,"Active"),s(" \u2014 The only status that has proper access to the App and API")]),e("li",null,[e("strong",null,"Suspended"),s(" \u2014 A user that has been temporarily disabled; no App/API access")]),e("li",null,[e("strong",null,"Archived"),s(" \u2014 A soft-deleted user; no App/API access")])])],-1),N=e("li",null,[e("strong",null,"Role"),s(" \u2014 The user\u2019s role determines their permissions and access")],-1),S=e("strong",null,"Token",-1),x=s(" \u2014 A user\u2019s token is an alternate way to "),L=s("authenticate into the API"),E=s(" using a static string. When NULL, the token is disabled. When enabled, ensure that a secure string is used."),q=e("h2",{id:"archiving-a-user"},[s("Archiving a User "),e("a",{class:"header-anchor",href:"#archiving-a-user"},"#")],-1),W=e("ol",null,[e("li",null,[s("Navigate to the "),e("strong",null,"User Library")]),e("li",null,"Click the user you with to archive to go to their User Detail page"),e("li",null,[s("Click the orange "),e("strong",null,"Archive User"),s(" action button in the header")]),e("li",null,[s("Confirm this decision by clicking "),e("strong",null,"Archive"),s(" in the dialog")])],-1),j=e("div",{class:"warning hint"},[e("div",{class:"hint-title"},"Disables Access"),e("p",null,[s("Archiving uses "),e("em",null,"soft-delete"),s(", therefore archived users are unable to access the App or API.")])],-1),V=e("h2",{id:"deleting-a-user"},[s("Deleting a User "),e("a",{class:"header-anchor",href:"#deleting-a-user"},"#")],-1),z=e("ol",null,[e("li",null,[s("Navigate to the "),e("strong",null,"User Library")]),e("li",null,"Select one or more users you wish to delete"),e("li",null,[s("Click the red "),e("strong",null,"Delete User"),s(" action button in the header")]),e("li",null,[s("Confirm this decision by clicking "),e("strong",null,"Delete"),s(" in the dialog")])],-1),B=e("div",{class:"danger hint"},[e("div",{class:"hint-title"},"Irreversible Change"),e("p",null,"Unlike the soft-delete of archiving, this process is a hard-delete. Therefore, this action is permanent and can not be undone. Please proceed with caution.")],-1),M=e("h2",{id:"creating-a-role"},[s("Creating a Role "),e("a",{class:"header-anchor",href:"#creating-a-role"},"#")],-1),O=e("ol",null,[e("li",null,[s("Navigate to "),e("strong",null,"Settings > Roles & Permissions")]),e("li",null,[s("Click the "),e("strong",null,"Create Role"),s(" action button in the header")]),e("li",null,[s("Enter a unique "),e("strong",null,"Role Name")]),e("li",null,[s("Enabling "),e("strong",null,"App Access"),s(" allows logging in to the App")]),e("li",null,[s("Enabling "),e("strong",null,"Admin Access"),s(" gives full permission to project data and Settings")])],-1),Y=e("h2",{id:"configuring-a-role"},[s("Configuring a Role "),e("a",{class:"header-anchor",href:"#configuring-a-role"},"#")],-1),G=e("ul",null,[e("li",null,[e("strong",null,"Permissions"),s(" \u2014 Defines the role\u2019s access permissions")]),e("li",null,[e("strong",null,"Role Name"),s(" \u2014 This is the name of the role")]),e("li",null,[e("strong",null,"Role Icon"),s(" \u2014 The icon used throughout the App when referencing this role")]),e("li",null,[e("strong",null,"Description"),s(" \u2014 A helpful note that explains the role\u2019s purpose")]),e("li",null,[e("strong",null,"App Access"),s(" \u2014 Allows logging in to the App")]),e("li",null,[e("strong",null,"Admin Access"),s(" \u2014 Gives full permission to project data and Settings")]),e("li",null,[e("strong",null,"IP Access"),s(" \u2014 An allow-list of IP addresses from which the platform can be accessed, empty allows all")]),e("li",null,[e("strong",null,"Require 2FA"),s(" \u2014 Forces all users within this role to use two-factor authentication")]),e("li",null,[e("strong",null,"Users in Role"),s(" \u2014 A list of all users within this role")])],-1),H=e("h2",{id:"deleting-a-role"},[s("Deleting a Role "),e("a",{class:"header-anchor",href:"#deleting-a-role"},"#")],-1),K=e("ol",null,[e("li",null,[s("Navigate to "),e("strong",null,"Settings > Roles & Permissions > [Role Name]")]),e("li",null,[s("Click the red "),e("strong",null,"Delete Role"),s(" action button in the header")]),e("li",null,[s("Confirm this decision by clicking "),e("strong",null,"Delete"),s(" in the dialog")])],-1),J={class:"warning hint"},Q=e("div",{class:"hint-title"},"Users in a Deleted Role",-1),X=s("If you delete a role that still has users in it, those users will be given a "),Z=e("code",null,"NULL",-1),$=s(" role, which denies their App access and limits them to the "),ee=s("Public Role"),se=s(" permissions. They can then be reassigned to a new role by an admin."),te=e("div",{class:"warning hint"},[e("div",{class:"hint-title"},"Last Admin"),e("p",null,"You must maintain at least one role/user with Admin Access so that you can still properly manage the project.")],-1),le=e("div",{class:"warning hint"},[e("div",{class:"hint-title"},"Public Role"),e("p",null,"You can not delete the Public role, as it is part of the core platform. To disable it completely, simply turn off all Public access permissions.")],-1),ne=e("h2",{id:"configuring-permissions"},[s("Configuring Permissions "),e("a",{class:"header-anchor",href:"#configuring-permissions"},"#")],-1),ie=e("p",null,"Directus possesses an extremely granular, yet easy to configure, permissions system. When creating a new role, permissions are disabled for all project collections by default \u2014 allowing you to give explicit access to only what is required. Individual permissions are applied to the role, and each is scoped to a specific collection and CRUD action (create, read, update, delete).",-1),oe=e("div",{class:"warning hint"},[e("div",{class:"hint-title"},"Saves Automatically"),e("p",null,"Every change made to the permissions of a role is saved automatically and instantly.")],-1),ae=e("div",{class:"warning hint"},[e("div",{class:"hint-title"},"Admin Roles"),e("p",null,[s("If a role is set to "),e("strong",null,"Admin Access"),s(" then it is granted complete access to the platform, and therefore the permission configuration field is disabled.")])],-1),re=e("ol",null,[e("li",null,[s("Navigate to "),e("strong",null,"Settings > Roles & Permissions > [Role Name]")]),e("li",null,[s("Scroll to the "),e("strong",null,"Permissions"),s(" section")]),e("li",null,[e("strong",null,"Click the icon"),s(" for the collection (row) and action (column) you want to set")]),e("li",null,[s("Choose the desired permission level: "),e("strong",null,"All Access"),s(", "),e("strong",null,"No Access"),s(", or "),e("strong",null,"Use Custom")])],-1),ce=e("p",null,[e("strong",null,"If you selected \u201CAll Access\u201D or \u201CNo Access\u201D then setup is complete."),s(" If you chose to customize permissions then continue with the appropriate guide below based on the relevant "),e("em",null,"action"),s(".")],-1),ue=e("h3",{id:"create-(custom-access)"},[s("Create (Custom Access) "),e("a",{class:"header-anchor",href:"#create-(custom-access)"},"#")],-1),de=e("ol",{start:"5"},[e("li",null,[e("strong",null,"Field Permissions"),s(" control which fields accept a value on create. Fields are individually toggled.")]),e("li",null,[e("strong",null,"Field Validation"),s(" define the rules for field values on create")]),e("li",null,[e("strong",null,"Field Presets"),s(" control the field defaults when creating an item")])],-1),he=e("h3",{id:"read-(custom-access)"},[s("Read (Custom Access) "),e("a",{class:"header-anchor",href:"#read-(custom-access)"},"#")],-1),ge={start:"5"},_e=e("strong",null,"Item Permissions",-1),fe=s(" control which items can be read, as defined by the "),pe=s("Filter Rules"),me=s(" entered."),be=e("li",null,[e("strong",null,"Field Permissions"),s(" control which fields can be read. Fields are individually toggled.")],-1),ye=e("div",{class:"warning hint"},[e("div",{class:"hint-title"},"Read Field Permissions"),e("p",null,[s("The Directus App always requires read access to the Primary Key field (eg: "),e("code",null,"id"),s(") so it can uniquely identify items. Also, if a Collection has \u201CArchive\u201D or \u201CSort\u201D fields configured, those fields will also need read access to use the App\u2019s soft-delete and manual sorting features.")])],-1),ve=e("h3",{id:"update-(custom-access)"},[s("Update (Custom Access) "),e("a",{class:"header-anchor",href:"#update-(custom-access)"},"#")],-1),we={start:"5"},Ae=e("strong",null,"Item Permissions",-1),Ce=s(" control which items can be updated, as defined by "),Pe=s("Filter Rules"),ke=s("."),Re=e("li",null,[e("strong",null,"Field Permissions"),s(" control which fields can be updated. Fields are individually toggled.")],-1),Ue=e("strong",null,"Field Validation",-1),Ie=s(" define the rules for field values on update, as defined by "),De=s("Filter Rules"),Te=s("."),Fe=e("li",null,[e("strong",null,"Field Presets"),s(" control the field defaults when updating an item")],-1),Ne=e("h3",{id:"delete-(custom-access)"},[s("Delete (Custom Access) "),e("a",{class:"header-anchor",href:"#delete-(custom-access)"},"#")],-1),Se={start:"5"},xe=e("strong",null,"Item Permissions",-1),Le=s(" control which items can be deleted, as defined by the "),Ee=s("Filter Rules"),qe=s(" entered."),We=e("hr",null,null,-1),je=e("h3",{id:"configuring-public-permissions"},[s("Configuring Public Permissions "),e("a",{class:"header-anchor",href:"#configuring-public-permissions"},"#")],-1),Ve=e("p",null,"The Public permissions control what project data is accessible without authentication. This is managed via the Public \u201Crole\u201D, which is included in the system by default and can not be deleted.",-1),ze=e("div",{class:"warning hint"},[e("div",{class:"hint-title"},"Private by Default"),e("p",null,"All of the data within the platform is private by default. Permissions for the public role can be granted on a case-by-case basis by administrators.")],-1),Be=e("h3",{id:"configuring-system-permissions"},[s("Configuring System Permissions "),e("a",{class:"header-anchor",href:"#configuring-system-permissions"},"#")],-1),Me=e("p",null,[s("In addition to permissions for "),e("em",null,"your"),s(" custom collections, you can also customize the permissions for "),e("em",null,"system"),s(" collections. It is important to note that when App Access is enabled for a role, Directus will automatically add permission for the necessary system collections. To edit system permissions, simply click \u201CSystem Collections\u201D at the bottom of the permissions configuration.")],-1),Oe=e("p",null,"There are two pre-configured options you can use for resetting the role\u2019s system permissions and ensure proper App access. To access these, click \u201CSystem Collections\u201D to expand, and then click one of the buttons at the bottom of the listing.",-1),Ye=e("ul",null,[e("li",null,[e("strong",null,"App Access Minimum"),s(" \u2014 The minimum permissions required to properly access the App")]),e("li",null,[e("strong",null,"Recommended Defaults"),s(" \u2014 More permissive but balanced for a better App user experience")])],-1),Ge=e("h2",{id:"configuring-workflows"},[s("Configuring Workflows "),e("a",{class:"header-anchor",href:"#configuring-workflows"},"#")],-1),He=e("p",null,"Workflows are a way to add structured stages to the flow of content authoring. They are primarily defined through the permissions for a Collection, but can be further enhanced via email notifications, custom interfaces, and automation. Directus supports endlessly configurable workflows, so we will only cover one simple example below.",-1),Ke=s("To create a structured workflow for "),Je=e("strong",null,"Articles",-1),Qe=s(", the first step is "),Xe=s("Creating a Field"),Ze=s(" to track the article \u201Cstatus\u201D \u2014 we\u2019ll call it "),$e=e("strong",null,"Status",-1),es=s(", but it can be named anything."),ss=e("li",null,[s("Next, create different Roles for each stage of the workflow, such as "),e("code",null,"author"),s(" and "),e("code",null,"manager"),s(".")],-1),ts=e("li",null,[s("Finally, configure the Role permissions based on the possible values of that Status field, such as "),e("code",null,"draft"),s(", "),e("code",null,"review"),s(", "),e("code",null,"approved"),s(", and "),e("code",null,"published"),s(", so that they are properly restricted to create content and update the status. "),e("ul",null,[e("li",null,[s("The Author can create content, but only save a status of "),e("code",null,"draft"),s(" or "),e("code",null,"review"),s(".")]),e("li",null,[s("The Manager has additional permissions that allow them to save statuses of "),e("code",null,"approved"),s(" or "),e("code",null,"published"),s(".")])])],-1),as={setup(ls,{expose:a}){const i={title:"Users, Roles & Permissions",modularExtension:!1};return a({frontmatter:i}),(ns,is)=>{const l=o("router-link"),r=o("DocsWrapper");return c(),u(r,{frontmatter:i},{default:t(()=>[e("div",d,[e("blockquote",null,[e("p",null,[n(l,{to:"/docs/getting-started/glossary/#users"},{default:t(()=>[h]),_:1}),g,n(l,{to:"/docs/getting-started/glossary/#roles"},{default:t(()=>[_]),_:1}),f,n(l,{to:"/docs/getting-started/glossary/#permissions"},{default:t(()=>[p]),_:1}),m])]),b,y,v,w,A,C,P,e("ol",null,[k,R,e("li",null,[U,I,n(l,{to:"/docs/app/user-directory/#editing-a-user"},{default:t(()=>[D]),_:1})])]),T,e("ul",null,[F,N,e("li",null,[S,x,n(l,{to:"/docs/reference/authentication/"},{default:t(()=>[L]),_:1}),E])]),q,W,j,V,z,B,M,O,Y,G,H,K,e("div",J,[Q,e("p",null,[X,Z,$,n(l,{to:"/docs/configuration/users-roles-permissions/#configuring-public-permissions"},{default:t(()=>[ee]),_:1}),se])]),te,le,ne,ie,oe,ae,re,ce,ue,de,he,e("ol",ge,[e("li",null,[_e,fe,n(l,{to:"/docs/configuration/filter-rules"},{default:t(()=>[pe]),_:1}),me]),be]),ye,ve,e("ol",we,[e("li",null,[Ae,Ce,n(l,{to:"/docs/configuration/filter-rules/"},{default:t(()=>[Pe]),_:1}),ke]),Re,e("li",null,[Ue,Ie,n(l,{to:"/docs/configuration/filter-rules/"},{default:t(()=>[De]),_:1}),Te]),Fe]),Ne,e("ol",Se,[e("li",null,[xe,Le,n(l,{to:"/docs/configuration/filter-rules/"},{default:t(()=>[Ee]),_:1}),qe])]),We,je,Ve,ze,Be,Me,Oe,Ye,Ge,He,e("ol",null,[e("li",null,[Ke,Je,Qe,n(l,{to:"/docs/configuration/data-model/#creating-a-field"},{default:t(()=>[Xe]),_:1}),Ze,$e,es]),ss,ts])])]),_:1})}}};export{as as default};

package/dist/assets/vue-i18n.eb71fdd3.entry.js

@@ -1 +0,0 @@
-import{dn as e,dp as r,dq as t,dr as d,c as n,u as o,ds as m}from"./vendor.9c15ff54.js";export{e as DatetimeFormat,r as NumberFormat,t as Translation,d as VERSION,n as createI18n,o as useI18n,m as vTDirective};

package/dist/assets/vue-router.568152dc.entry.js

@@ -1 +0,0 @@
-import{dt as s,du as t,X as r,dv as o,dw as u,at as i,dx as d,dy as y,au as c,dz as n,dA as R,S as f,ag as v,dB as L,dC as p,dD as K,dE as g,dF as h,aI as w,Z as H,U as T,dG as m}from"./vendor.9c15ff54.js";export{s as NavigationFailureType,t as RouterLink,r as RouterView,o as START_LOCATION,u as createMemoryHistory,i as createRouter,d as createRouterMatcher,y as createWebHashHistory,c as createWebHistory,n as isNavigationFailure,R as matchedRouteKey,f as onBeforeRouteLeave,v as onBeforeRouteUpdate,L as parseQuery,p as routeLocationKey,K as routerKey,g as routerViewLocationKey,h as stringifyQuery,w as useLink,H as useRoute,T as useRouter,m as viewDepthKey};

package/dist/assets/vue.40191742.entry.js

@@ -1 +0,0 @@
-import{c0 as s,c1 as t,cR as o,Y as c,c2 as r,cS as n,c3 as i,c4 as d,aF as l,c5 as p,aE as m,aG as f,bQ as u,c6 as R,c7 as S,d8 as v,d9 as h,c8 as C,c9 as w,bP as y,o as b,bF as E,q as g,K as T,V as x,z as k,ca as D,cb as M,cc as P,bR as V,B as A,aL as H,R as B,t as N,cT as F,bp as U,n as z,bS as I,cd as K,ce as W,cf as q,bT as G,cg as J,cU as L,cV as j,ch as O,cW as Q,ci as Y,P as _,W as $,cj as X,bU as Z,ck as ee,bV as ae,G as se,cl as te,cX as oe,cY as ce,cZ as re,E as ne,cm as ie,cn as de,c_ as le,co as pe,Q as me,am as fe,M as ue,O as Re,ax as Se,bI as ve,ae as he,af as Ce,cp as we,bJ as ye,cq as be,D as Ee,cr as ge,cs as Te,c$ as xe,ct as ke,F as De,cu as Me,p as Pe,a2 as Ve,T as Ae,d0 as He,a1 as Be,cv as Ne,ao as Fe,d1 as Ue,v as ze,cw as Ie,bW as Ke,$ as We,C as qe,r as Ge,H as Je,N as Le,cx as je,cy as Oe,cz as Qe,cA as Ye,cB as _e,d2 as $e,d3 as Xe,s as Ze,cC as ea,cD as aa,d4 as sa,A as ta,da as oa,aH as ca,d5 as ra,d6 as na,a0 as ia,cE as da,d7 as la,ah as pa,cF as ma,bX as fa,bq as ua,cG as Ra,cH as Sa,cI as va,bY as ha,bZ as Ca,b_ as wa,b$ as ya,aJ as ba,L as Ea,cJ as ga,cK as Ta,y as xa,a7 as ka,cL as Da,cM as Ma,cN as Pa,w as Va,cO as Aa,I as Ha,_ as Ba,cP as Na,J as Fa,cQ as Ua}from"./vendor.9c15ff54.js";export{s as BaseTransition,t as Comment,o as EffectScope,c as Fragment,r as KeepAlive,n as ReactiveEffect,i as Static,d as Suspense,l as Teleport,p as Text,m as Transition,f as TransitionGroup,u as VueElement,R as callWithAsyncErrorHandling,S as callWithErrorHandling,v as camelize,h as capitalize,C as cloneVNode,w as compatUtils,y as compile,b as computed,E as createApp,g as createBlock,T as createCommentVNode,x as createElementBlock,k as createElementVNode,D as createHydrationRenderer,M as createPropsRestProxy,P as createRenderer,V as createSSRApp,A as createSlots,H as createStaticVNode,B as createTextVNode,N as createVNode,F as customRef,U as defineAsyncComponent,z as defineComponent,I as defineCustomElement,K as defineEmits,W as defineExpose,q as defineProps,G as defineSSRCustomElement,J as devtools,L as effect,j as effectScope,O as getCurrentInstance,Q as getCurrentScope,Y as getTransitionRawChildren,_ as guardReactiveProps,$ as h,X as handleError,Z as hydrate,ee as initCustomFormatter,ae as initDirectivesForSSR,se as inject,te as isMemoSame,oe as isProxy,ce as isReactive,re as isReadonly,ne as isRef,ie as isRuntimeOnly,de as isVNode,le as markRaw,pe as mergeDefaults,me as mergeProps,fe as nextTick,ue as normalizeClass,Re as normalizeProps,Se as normalizeStyle,ve as onActivated,he as onBeforeMount,Ce as onBeforeUnmount,we as onBeforeUpdate,ye as onDeactivated,be as onErrorCaptured,Ee as onMounted,ge as onRenderTracked,Te as onRenderTriggered,xe as onScopeDispose,ke as onServerPrefetch,De as onUnmounted,Me as onUpdated,Pe as openBlock,Ve as popScopeId,Ae as provide,He as proxyRefs,Be as pushScopeId,Ne as queuePostFlushCb,Fe as reactive,Ue as readonly,ze as ref,Ie as registerRuntimeCompiler,Ke as render,We as renderList,qe as renderSlot,Ge as resolveComponent,Je as resolveDirective,Le as resolveDynamicComponent,je as resolveFilter,Oe as resolveTransitionHooks,Qe as setBlockTracking,Ye as setDevtoolsHook,_e as setTransitionHooks,$e as shallowReactive,Xe as shallowReadonly,Ze as shallowRef,ea as ssrContextKey,aa as ssrUtils,sa as stop,ta as toDisplayString,oa as toHandlerKey,ca as toHandlers,ra as toRaw,na as toRef,ia as toRefs,da as transformVNodeArgs,la as triggerRef,pa as unref,ma as useAttrs,fa as useCssModule,ua as useCssVars,Ra as useSSRContext,Sa as useSlots,va as useTransitionState,ha as vModelCheckbox,Ca as vModelDynamic,wa as vModelRadio,ya as vModelSelect,ba as vModelText,Ea as vShow,ga as version,Ta as warn,xa as watch,ka as watchEffect,Da as watchPostEffect,Ma as watchSyncEffect,Pa as withAsyncContext,Va as withCtx,Aa as withDefaults,Ha as withDirectives,Ba as withKeys,Na as withMemo,Fa as withModifiers,Ua as withScopeId};

package/dist/assets/webhooks.dcd21715.js

@@ -1 +0,0 @@
-import{r as s,p as i,q as r,w as a,z as e,R as l}from"./vendor.9c15ff54.js";const h=e("div",{class:"markdown-body"},[e("blockquote",null,[e("p",null,[l("Webhooks are configured within the App (no code required) and send HTTP requests when a specific event is triggered. "),e("a",{href:"https://en.wikipedia.org/wiki/Webhook",target:"_blank",rel:"noopener noreferrer"},"Learn more about Webhooks"),l(".")])]),e("h2",{id:"creating-webhooks"},[l("Creating Webhooks "),e("a",{class:"header-anchor",href:"#creating-webhooks"},"#")]),e("ol",null,[e("li",null,[l("Navigate to "),e("strong",null,"Settings > Webhooks")]),e("li",null,[l("Click the "),e("strong",null,"Create Webhook"),l(" action button in the header")]),e("li",null,[l("Complete the "),e("strong",null,"other webhook form fields"),l(" outlined below")])]),e("ul",null,[e("li",null,[e("strong",null,"Name"),l(" \u2014 A name to help remember this webhooks purpose")]),e("li",null,[e("strong",null,"Method"),l(" \u2014 Send as either a HTTP "),e("code",null,"GET"),l(" or "),e("code",null,"POST"),l(" request")]),e("li",null,[e("strong",null,"URL"),l(" \u2014 The URL to send the request to")]),e("li",null,[e("strong",null,"Status"),l(" \u2014 Whether the webhook is active (enabled) or inactive (disabled)")]),e("li",null,[e("strong",null,"Data"),l(" \u2014 Whether the event\u2019s data should be sent along with the request")]),e("li",null,[e("strong",null,"Request Headers"),l(" \u2014 Custom headers that will be added to the webhook request")]),e("li",null,[e("strong",null,"Trigger Actions"),l(" \u2014 The specific actions that will trigger the event")]),e("li",null,[e("strong",null,"Trigger Collections"),l(" \u2014 The specific collections for which the above actions will trigger events")])]),e("h2",{id:"disabling-webhooks"},[l("Disabling Webhooks "),e("a",{class:"header-anchor",href:"#disabling-webhooks"},"#")]),e("ol",null,[e("li",null,[l("Navigate to "),e("strong",null,"Settings > Webhooks > [Webhook]")]),e("li",null,[l("Set the "),e("strong",null,"status field to inactive")])]),e("h2",{id:"deleting-webhooks"},[l("Deleting Webhooks "),e("a",{class:"header-anchor",href:"#deleting-webhooks"},"#")]),e("ol",null,[e("li",null,[l("Navigate to "),e("strong",null,"Settings > Webhooks > [Webhook]")]),e("li",null,[l("Click the red "),e("strong",null,"Delete Webhook"),l(" action button in the header")]),e("li",null,[l("Confirm this decision by clicking "),e("strong",null,"Delete"),l(" in the dialog")])]),e("div",{class:"danger hint"},[e("div",{class:"hint-title"},"Irreversible Change"),e("p",null,"This action is permanent and can not be undone. Please proceed with caution.")])],-1),b={setup(u,{expose:o}){const t={title:"Webhooks",modularExtension:!1};return o({frontmatter:t}),(c,d)=>{const n=s("DocsWrapper");return i(),r(n,{frontmatter:t},{default:a(()=>[h]),_:1})}}};export{b as default};

package/dist/assets/yaml-frontmatter.2536f248.js

@@ -1 +0,0 @@
-import{bK as b}from"./vendor.9c15ff54.js";import{a as v}from"./yaml.0f11002b.js";function S(m,c){return c.forEach(function(t){t&&typeof t!="string"&&!Array.isArray(t)&&Object.keys(t).forEach(function(r){if(r!=="default"&&!(r in m)){var a=Object.getOwnPropertyDescriptor(t,r);Object.defineProperty(m,r,a.get?a:{enumerable:!0,get:function(){return t[r]}})}})}),Object.freeze(m)}var d={exports:{}};(function(m,c){(function(t){t(b.exports,v.exports)})(function(t){var r=0,a=1,y=2;t.defineMode("yaml-frontmatter",function(s,p){var o=t.getMode(s,"yaml"),l=t.getMode(s,p&&p.base||"gfm");function i(e){return e.state==a?{mode:o,state:e.yaml}:{mode:l,state:e.inner}}return{startState:function(){return{state:r,yaml:null,inner:t.startState(l)}},copyState:function(e){return{state:e.state,yaml:e.yaml&&t.copyState(o,e.yaml),inner:t.copyState(l,e.inner)}},token:function(e,n){if(n.state==r)return e.match("---",!1)?(n.state=a,n.yaml=t.startState(o),o.token(e,n.yaml)):(n.state=y,l.token(e,n.inner));if(n.state==a){var u=e.sol()&&e.match(/(---|\.\.\.)/,!1),f=o.token(e,n.yaml);return u&&(n.state=y,n.yaml=null),f}else return l.token(e,n.inner)},innerMode:i,indent:function(e,n,u){var f=i(e);return f.mode.indent?f.mode.indent(f.state,n,u):t.Pass},blankLine:function(e){var n=i(e);if(n.mode.blankLine)return n.mode.blankLine(n.state)}}})})})();var g=d.exports,x=Object.freeze(S({__proto__:null,[Symbol.toStringTag]:"Module",default:g},[d.exports]));export{x as y};