@escalated-dev/escalated 0.8.0 → 0.11.1

package/src/composables/useI18n.js

@@ -1,102 +1,102 @@
-import { ref, computed } from 'vue';
-import overrideLocales from '../locales/index.js';
-
-// Central translations published from escalated-dev/escalated-locale.
-// This is the BASE layer. Local src/locales/*.json files in this repo are
-// loaded as OVERRIDES and win over the central source for any matching key.
-//
-// Until @escalated-dev/locale v0.1.0 ships its consolidated strings, this
-// import resolves to a stub object with the same shape. Local overrides
-// (src/locales/) preserve the current behavior so components keep rendering
-// the strings they always rendered. After Codex finishes consolidating
-// translations into the central package, the local override files can be
-// trimmed (or deleted entirely) and the central source becomes authoritative.
-import centralLocales from '@escalated-dev/locale';
-
-const currentLocale = ref('en');
-const customMessages = ref({});
-
-function resolve(obj, path) {
-    return path.split('.').reduce((acc, key) => acc?.[key], obj);
-}
-
-function applyReplacements(str, replacements) {
-    if (!replacements) return str;
-    return Object.entries(replacements).reduce(
-        (result, [key, value]) => result.replace(new RegExp(`:${key}`, 'g'), value),
-        str,
-    );
-}
-
-export function setLocale(locale) {
-    currentLocale.value = locale;
-}
-
-export function getLocale() {
-    return currentLocale.value;
-}
-
-export function mergeMessages(locale, messages) {
-    customMessages.value = {
-        ...customMessages.value,
-        [locale]: deepMerge(customMessages.value[locale] || {}, messages),
-    };
-}
-
-function deepMerge(target, source) {
-    const result = { ...target };
-    for (const key of Object.keys(source)) {
-        if (
-            source[key] &&
-            typeof source[key] === 'object' &&
-            !Array.isArray(source[key]) &&
-            target[key] &&
-            typeof target[key] === 'object'
-        ) {
-            result[key] = deepMerge(target[key], source[key]);
-        } else {
-            result[key] = source[key];
-        }
-    }
-    return result;
-}
-
-export function useI18n() {
-    const locale = computed(() => currentLocale.value);
-
-    function t(key, replacements) {
-        const lang = currentLocale.value;
-
-        // 1. Host-app supplied messages for the current locale (highest priority).
-        const custom = resolve(customMessages.value[lang], key);
-        if (typeof custom === 'string') return applyReplacements(custom, replacements);
-
-        // 2. Local plugin overrides for the current locale (src/locales/*.json).
-        //    These exist to let this repo win over the central source for any
-        //    string the plugin needs to phrase differently.
-        const override = resolve(overrideLocales[lang], key);
-        if (typeof override === 'string') return applyReplacements(override, replacements);
-
-        // 3. Central source for the current locale (@escalated-dev/locale).
-        //    This is the canonical base layer.
-        const central = resolve(centralLocales?.[lang], key);
-        if (typeof central === 'string') return applyReplacements(central, replacements);
-
-        // 4. English fallbacks, in the same priority order.
-        if (lang !== 'en') {
-            const customEn = resolve(customMessages.value.en, key);
-            if (typeof customEn === 'string') return applyReplacements(customEn, replacements);
-
-            const overrideEn = resolve(overrideLocales.en, key);
-            if (typeof overrideEn === 'string') return applyReplacements(overrideEn, replacements);
-
-            const centralEn = resolve(centralLocales?.en, key);
-            if (typeof centralEn === 'string') return applyReplacements(centralEn, replacements);
-        }
-
-        // Return raw key
-        return key;
-    }
-
-    return { t, locale };
-}
+import { ref, computed } from 'vue';
+import overrideLocales from '../locales/index.js';
+
+// Central translations published from escalated-dev/escalated-locale.
+// This is the BASE layer. Local src/locales/*.json files in this repo are
+// loaded as OVERRIDES and win over the central source for any matching key.
+//
+// Until @escalated-dev/locale v0.1.0 ships its consolidated strings, this
+// import resolves to a stub object with the same shape. Local overrides
+// (src/locales/) preserve the current behavior so components keep rendering
+// the strings they always rendered. After Codex finishes consolidating
+// translations into the central package, the local override files can be
+// trimmed (or deleted entirely) and the central source becomes authoritative.
+import centralLocales from '@escalated-dev/locale';
+
+const currentLocale = ref('en');
+const customMessages = ref({});
+
+function resolve(obj, path) {
+    return path.split('.').reduce((acc, key) => acc?.[key], obj);
+}
+
+function applyReplacements(str, replacements) {
+    if (!replacements) return str;
+    return Object.entries(replacements).reduce(
+        (result, [key, value]) => result.replace(new RegExp(`:${key}`, 'g'), value),
+        str,
+    );
+}
+
+export function setLocale(locale) {
+    currentLocale.value = locale;
+}
+
+export function getLocale() {
+    return currentLocale.value;
+}
+
+export function mergeMessages(locale, messages) {
+    customMessages.value = {
+        ...customMessages.value,
+        [locale]: deepMerge(customMessages.value[locale] || {}, messages),
+    };
+}
+
+function deepMerge(target, source) {
+    const result = { ...target };
+    for (const key of Object.keys(source)) {
+        if (
+            source[key] &&
+            typeof source[key] === 'object' &&
+            !Array.isArray(source[key]) &&
+            target[key] &&
+            typeof target[key] === 'object'
+        ) {
+            result[key] = deepMerge(target[key], source[key]);
+        } else {
+            result[key] = source[key];
+        }
+    }
+    return result;
+}
+
+export function useI18n() {
+    const locale = computed(() => currentLocale.value);
+
+    function t(key, replacements) {
+        const lang = currentLocale.value;
+
+        // 1. Host-app supplied messages for the current locale (highest priority).
+        const custom = resolve(customMessages.value[lang], key);
+        if (typeof custom === 'string') return applyReplacements(custom, replacements);
+
+        // 2. Local plugin overrides for the current locale (src/locales/*.json).
+        //    These exist to let this repo win over the central source for any
+        //    string the plugin needs to phrase differently.
+        const override = resolve(overrideLocales[lang], key);
+        if (typeof override === 'string') return applyReplacements(override, replacements);
+
+        // 3. Central source for the current locale (@escalated-dev/locale).
+        //    This is the canonical base layer.
+        const central = resolve(centralLocales?.[lang], key);
+        if (typeof central === 'string') return applyReplacements(central, replacements);
+
+        // 4. English fallbacks, in the same priority order.
+        if (lang !== 'en') {
+            const customEn = resolve(customMessages.value.en, key);
+            if (typeof customEn === 'string') return applyReplacements(customEn, replacements);
+
+            const overrideEn = resolve(overrideLocales.en, key);
+            if (typeof overrideEn === 'string') return applyReplacements(overrideEn, replacements);
+
+            const centralEn = resolve(centralLocales?.en, key);
+            if (typeof centralEn === 'string') return applyReplacements(centralEn, replacements);
+        }
+
+        // Return raw key
+        return key;
+    }
+
+    return { t, locale };
+}

package/src/composables/useMentions.js

@@ -1,134 +1,134 @@
-import { ref, onUnmounted } from 'vue';
-
-/**
- * Composable that detects `@` typed in a text input/textarea,
- * fetches agent suggestions from the API (debounced), and provides
- * an insert function to replace the mention token.
- *
- * @param {Object} options
- * @param {string} [options.searchEndpoint] - API endpoint for agent search (default: route-based)
- * @param {number} [options.debounce=250] - Debounce delay in ms
- * @returns {Object}
- */
-export function useMentions(options = {}) {
-    const { debounce = 250 } = options;
-
-    const suggestions = ref([]);
-    const isActive = ref(false);
-    const query = ref('');
-    const mentionStart = ref(null); // cursor position where `@` was typed
-    const loading = ref(false);
-
-    let timer = null;
-
-    function clearTimer() {
-        if (timer !== null) {
-            window.clearTimeout(timer);
-            timer = null;
-        }
-    }
-
-    /**
-     * Call this on every input/keyup event with the textarea element
-     * and the current text value.
-     */
-    function onTextChange(textareaEl, text) {
-        if (!textareaEl) return;
-
-        const cursorPos = textareaEl.selectionStart;
-        const textBeforeCursor = text.slice(0, cursorPos);
-
-        // Find the last `@` that starts a mention (preceded by whitespace or start of string)
-        const mentionMatch = textBeforeCursor.match(/(?:^|[\s(])@([a-zA-Z0-9_ ]*)$/);
-
-        if (mentionMatch) {
-            const searchQuery = mentionMatch[1];
-            // The @ is at cursorPos minus the matched group minus 1 for the @
-            mentionStart.value = cursorPos - searchQuery.length - 1;
-            query.value = searchQuery;
-            isActive.value = true;
-            debouncedFetch(searchQuery);
-        } else {
-            close();
-        }
-    }
-
-    function debouncedFetch(searchQuery) {
-        clearTimer();
-
-        if (searchQuery.length < 1) {
-            fetchSuggestions('');
-            return;
-        }
-
-        timer = window.setTimeout(() => {
-            fetchSuggestions(searchQuery);
-        }, debounce);
-    }
-
-    async function fetchSuggestions(searchQuery) {
-        loading.value = true;
-        try {
-            const endpoint = options.searchEndpoint || '/support/admin/agents/search';
-            const url = `${endpoint}?q=${encodeURIComponent(searchQuery)}`;
-            const response = await fetch(url, {
-                headers: {
-                    Accept: 'application/json',
-                    'X-Requested-With': 'XMLHttpRequest',
-                    'X-CSRF-TOKEN': document.querySelector('meta[name="csrf-token"]')?.content || '',
-                },
-            });
-            if (response.ok) {
-                suggestions.value = await response.json();
-            } else {
-                suggestions.value = [];
-            }
-        } catch {
-            suggestions.value = [];
-        } finally {
-            loading.value = false;
-        }
-    }
-
-    /**
-     * Insert the selected agent mention into the text.
-     * Returns the new text value with the mention inserted.
-     *
-     * @param {string} currentText - Current textarea value
-     * @param {Object} agent - Agent object with `name` property
-     * @returns {string} Updated text
-     */
-    function insertMention(currentText, agent) {
-        if (mentionStart.value === null) return currentText;
-
-        const before = currentText.slice(0, mentionStart.value);
-        const cursorPos = mentionStart.value + 1 + query.value.length;
-        const after = currentText.slice(cursorPos);
-
-        const mentionText = `@{${agent.name}} `;
-        const newText = before + mentionText + after;
-
-        close();
-        return newText;
-    }
-
-    function close() {
-        isActive.value = false;
-        suggestions.value = [];
-        query.value = '';
-        mentionStart.value = null;
-        clearTimer();
-    }
-
-    onUnmounted(clearTimer);
-
-    return {
-        suggestions,
-        isActive,
-        query,
-        loading,
-        onTextChange,
-        insertMention,
-        close,
-    };
-}
+import { ref, onUnmounted } from 'vue';
+
+/**
+ * Composable that detects `@` typed in a text input/textarea,
+ * fetches agent suggestions from the API (debounced), and provides
+ * an insert function to replace the mention token.
+ *
+ * @param {Object} options
+ * @param {string} [options.searchEndpoint] - API endpoint for agent search (default: route-based)
+ * @param {number} [options.debounce=250] - Debounce delay in ms
+ * @returns {Object}
+ */
+export function useMentions(options = {}) {
+    const { debounce = 250 } = options;
+
+    const suggestions = ref([]);
+    const isActive = ref(false);
+    const query = ref('');
+    const mentionStart = ref(null); // cursor position where `@` was typed
+    const loading = ref(false);
+
+    let timer = null;
+
+    function clearTimer() {
+        if (timer !== null) {
+            window.clearTimeout(timer);
+            timer = null;
+        }
+    }
+
+    /**
+     * Call this on every input/keyup event with the textarea element
+     * and the current text value.
+     */
+    function onTextChange(textareaEl, text) {
+        if (!textareaEl) return;
+
+        const cursorPos = textareaEl.selectionStart;
+        const textBeforeCursor = text.slice(0, cursorPos);
+
+        // Find the last `@` that starts a mention (preceded by whitespace or start of string)
+        const mentionMatch = textBeforeCursor.match(/(?:^|[\s(])@([a-zA-Z0-9_ ]*)$/);
+
+        if (mentionMatch) {
+            const searchQuery = mentionMatch[1];
+            // The @ is at cursorPos minus the matched group minus 1 for the @
+            mentionStart.value = cursorPos - searchQuery.length - 1;
+            query.value = searchQuery;
+            isActive.value = true;
+            debouncedFetch(searchQuery);
+        } else {
+            close();
+        }
+    }
+
+    function debouncedFetch(searchQuery) {
+        clearTimer();
+
+        if (searchQuery.length < 1) {
+            fetchSuggestions('');
+            return;
+        }
+
+        timer = window.setTimeout(() => {
+            fetchSuggestions(searchQuery);
+        }, debounce);
+    }
+
+    async function fetchSuggestions(searchQuery) {
+        loading.value = true;
+        try {
+            const endpoint = options.searchEndpoint || '/support/admin/agents/search';
+            const url = `${endpoint}?q=${encodeURIComponent(searchQuery)}`;
+            const response = await fetch(url, {
+                headers: {
+                    Accept: 'application/json',
+                    'X-Requested-With': 'XMLHttpRequest',
+                    'X-CSRF-TOKEN': document.querySelector('meta[name="csrf-token"]')?.content || '',
+                },
+            });
+            if (response.ok) {
+                suggestions.value = await response.json();
+            } else {
+                suggestions.value = [];
+            }
+        } catch {
+            suggestions.value = [];
+        } finally {
+            loading.value = false;
+        }
+    }
+
+    /**
+     * Insert the selected agent mention into the text.
+     * Returns the new text value with the mention inserted.
+     *
+     * @param {string} currentText - Current textarea value
+     * @param {Object} agent - Agent object with `name` property
+     * @returns {string} Updated text
+     */
+    function insertMention(currentText, agent) {
+        if (mentionStart.value === null) return currentText;
+
+        const before = currentText.slice(0, mentionStart.value);
+        const cursorPos = mentionStart.value + 1 + query.value.length;
+        const after = currentText.slice(cursorPos);
+
+        const mentionText = `@{${agent.name}} `;
+        const newText = before + mentionText + after;
+
+        close();
+        return newText;
+    }
+
+    function close() {
+        isActive.value = false;
+        suggestions.value = [];
+        query.value = '';
+        mentionStart.value = null;
+        clearTimer();
+    }
+
+    onUnmounted(clearTimer);
+
+    return {
+        suggestions,
+        isActive,
+        query,
+        loading,
+        onTextChange,
+        insertMention,
+        close,
+    };
+}

package/src/composables/usePermissions.js

@@ -0,0 +1,31 @@
+import { computed } from 'vue';
+import { usePage } from '@inertiajs/vue3';
+
+/**
+ * Read the current user's permission slugs from Inertia shared props.
+ * Canonical source: `page.props.escalated.permissions` (string[]).
+ */
+export function usePermissions() {
+    const page = usePage();
+
+    const permissions = computed(() => {
+        const raw = page.props.escalated?.permissions;
+        if (raw === undefined || raw === null) {
+            return null;
+        }
+        return Array.isArray(raw) ? raw : [];
+    });
+
+    function hasPermission(slug) {
+        const perms = permissions.value;
+        if (perms === null) {
+            return page.props.escalated?.is_admin === true;
+        }
+        if (perms.includes('*')) {
+            return true;
+        }
+        return perms.includes(slug);
+    }
+
+    return { permissions, hasPermission };
+}