@mapomodule/core 1.0.0 → 2.0.0-beta.2

package/dist/runtime/middleware/roles.js

@@ -0,0 +1,13 @@
+import { defineNuxtRouteMiddleware, createError } from "nuxt/app";
+import { useAuthStore } from "@mapomodule/store/runtime/stores/auth";
+export default defineNuxtRouteMiddleware((to) => {
+  const auth = useAuthStore();
+  const required = to.meta.roles;
+  if (!required?.length) return;
+  if (auth.info?.is_superuser) return;
+  const userGroups = auth.info?.groups ?? [];
+  const hasRole = required.some((r) => userGroups.includes(r));
+  if (!hasRole) {
+    throw createError({ statusCode: 403, message: "Forbidden" });
+  }
+});

package/dist/runtime/page-meta.nuxt.d.ts

@@ -0,0 +1,23 @@
+declare module "#app" {
+  interface PageMeta {
+    /**
+     * Permissions required to access this route. Checked by the 'permissions' middleware and sidebar visibility.
+     * - `{ model: string }` — derives `view_<model>` from a Django model name and populates `authStore.pagePermissions`
+     * - `string[]` — raw Django permission codenames (e.g. `['view_article', 'change_article']`)
+     */
+    permissions?: { model: string } | string[];
+    /** Required role/group names. Checked by the 'roles' middleware. */
+    roles?: string[];
+  }
+}
+
+declare module "vue-router" {
+  interface RouteMeta {
+    permissions?: { model: string } | string[];
+    roles?: string[];
+    /** Route middleware names applied to this route. Read by useCanAccessRoute for sidebar visibility. */
+    middleware?: string | string[];
+  }
+}
+
+export {};

package/dist/runtime/plugins/00.fetch.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Registers the global Mapo fetch client and loading state.
+ *
+ * The plugin provides:
+ * - `$mapoFetch`: a shared `$fetch` instance with centralized request/response hooks.
+ * - `$mapoFetchLoading`: a computed boolean based on a global pending-request counter.
+ *
+ * Error handling behavior:
+ * - `401` (except logout calls): reset auth state and, on client, redirect to login
+ *   with the current route encoded in a `redirect` query parameter.
+ * - `403`: show a global "Permission denied" error snackbar.
+ */
+declare const _default: import("nuxt/app").Plugin<{
+    mapoFetch: import("nitropack/types").$Fetch<unknown, import("nitropack/types").NitroFetchRequest>;
+    mapoFetchLoading: import("vue").ComputedRef<boolean>;
+}> & import("nuxt/app").ObjectPlugin<{
+    mapoFetch: import("nitropack/types").$Fetch<unknown, import("nitropack/types").NitroFetchRequest>;
+    mapoFetchLoading: import("vue").ComputedRef<boolean>;
+}>;
+export default _default;
+//# sourceMappingURL=00.fetch.d.ts.map

package/dist/runtime/plugins/00.fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"00.fetch.d.ts","sourceRoot":"","sources":["../../../src/runtime/plugins/00.fetch.ts"],"names":[],"mappings":"AAWA;;;;;;;;;;;GAWG;;;;;;;;AACH,wBA6DG"}

package/dist/runtime/plugins/00.fetch.js

@@ -0,0 +1,57 @@
+import { ref, computed } from "vue";
+import {
+  defineNuxtPlugin,
+  navigateTo,
+  useRoute,
+  useRuntimeConfig
+} from "nuxt/app";
+import { useAuthStore } from "@mapomodule/store/runtime/stores/auth";
+import { useSnackStore } from "@mapomodule/store/runtime/stores/snack";
+export default defineNuxtPlugin({
+  name: "mapo-core:fetch",
+  enforce: "pre",
+  setup() {
+    const rc = useRuntimeConfig().public.mapoCore;
+    const logoutUrl = rc.logoutUrl;
+    const loginUrl = rc.loginUrl;
+    let redirectInFlight = false;
+    const handle = (status, requestUrl) => {
+      if (status === 401 && !requestUrl.includes(logoutUrl) && !redirectInFlight) {
+        redirectInFlight = true;
+        const auth = useAuthStore();
+        auth.reset();
+        if (import.meta.client) {
+          const route = useRoute();
+          navigateTo(
+            `${loginUrl}?redirect=${encodeURIComponent(route.fullPath)}`
+          );
+        }
+      }
+      if (status === 403) {
+        useSnackStore().show("Permission denied", "error");
+      }
+    };
+    const pending = ref(0);
+    const mapoFetchLoading = computed(() => pending.value > 0);
+    const mapoFetch = $fetch.create({
+      onRequest() {
+        pending.value++;
+      },
+      onResponse({ response, request }) {
+        pending.value--;
+        handle(response.status, String(request));
+      },
+      onResponseError({ response, request, error }) {
+        pending.value--;
+        handle(response?.status ?? 0, String(request));
+        return Promise.reject(error);
+      },
+      onRequestError() {
+        pending.value--;
+      }
+    });
+    return {
+      provide: { mapoFetch, mapoFetchLoading }
+    };
+  }
+});

package/dist/runtime/plugins/01.init.server.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Performs server-side bootstrap of Mapo runtime stores.
+ *
+ * On each SSR request, this plugin:
+ * - Activates the request Pinia instance and initializes auth/sidebar stores.
+ * - Restores sidebar UI state from cookies.
+ * - If the HttpOnly session cookie is present, calls the configured `userInfoApi`
+ *   (forwarding request cookies) to restore the authenticated user in the auth store.
+ *
+ * On session restore failure, it resets auth state and clears the session cookie.
+ */
+declare const _default: import("nuxt/app").Plugin<Record<string, unknown>> & import("nuxt/app").ObjectPlugin<Record<string, unknown>>;
+export default _default;
+//# sourceMappingURL=01.init.server.d.ts.map

package/dist/runtime/plugins/01.init.server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"01.init.server.d.ts","sourceRoot":"","sources":["../../../src/runtime/plugins/01.init.server.ts"],"names":[],"mappings":"AAeA;;;;;;;;;;GAUG;;AACH,wBAmCG"}

package/dist/runtime/plugins/01.init.server.js

@@ -0,0 +1,37 @@
+import {
+  defineNuxtPlugin,
+  useRuntimeConfig,
+  useCookie,
+  useRequestHeaders,
+  useRequestURL
+} from "nuxt/app";
+import { setActivePinia } from "pinia";
+import { useAuthStore } from "@mapomodule/store/runtime/stores/auth";
+import { useSidebarStore } from "@mapomodule/store/runtime/stores/sidebar";
+import { CoreCookieEnum } from "../types.js";
+export default defineNuxtPlugin({
+  name: "mapo-core:init",
+  async setup(nuxtApp) {
+    const runtimeConfig = useRuntimeConfig().public.mapoCore;
+    const userInfoApi = runtimeConfig?.userInfoApi ?? "/api/profiles/me/";
+    const pinia = nuxtApp.$pinia;
+    setActivePinia(pinia);
+    const authStore = useAuthStore(pinia);
+    const sidebarStore = useSidebarStore(pinia);
+    sidebarStore.hydrateFromCookies();
+    const sessionCookie = useCookie(CoreCookieEnum.Session);
+    if (!sessionCookie.value) return;
+    try {
+      const headers = useRequestHeaders(["cookie"]);
+      const url = useRequestURL();
+      const absolute = `${url.protocol}//${url.host}${userInfoApi}`;
+      const user = await nuxtApp.$mapoFetch(absolute, { method: "GET", headers });
+      authStore.setUser(user);
+    } catch (e) {
+      console.error(`[mapo] Cannot restore session from cookie:
+${e}`);
+      authStore.reset();
+      sessionCookie.value = null;
+    }
+  }
+});

package/dist/runtime/types.d.ts

@@ -0,0 +1,62 @@
+export declare enum MultipartPolicyEnum {
+    Auto = "auto",
+    Force = "force",
+    Disable = "disable"
+}
+export type MultipartPolicy = `${MultipartPolicyEnum}`;
+export declare enum CoreCookieEnum {
+    Session = "__mapo_session"
+}
+export interface ListParams {
+    page?: number;
+    limit?: number;
+    search?: string;
+    ordering?: string;
+    [key: string]: unknown;
+}
+export interface PaginatedResponse<T> {
+    results: T[];
+    count: number;
+    next?: string | null;
+    previous?: string | null;
+}
+export type ApiResponse<T> = T;
+export interface CrudConfig {
+    baseURL?: string;
+    headers?: Record<string, string>;
+    [key: string]: unknown;
+}
+export interface CrudOptions {
+    multipart?: MultipartPolicy;
+}
+export interface CrudRepository<T> {
+    list(params?: ListParams, config?: CrudConfig): Promise<PaginatedResponse<T>>;
+    detail(id: string | number, config?: CrudConfig): Promise<T>;
+    create(data: Partial<T>, config?: CrudConfig, opts?: CrudOptions): Promise<T>;
+    update(id: string | number, data: Partial<T>, config?: CrudConfig, opts?: CrudOptions): Promise<T>;
+    partialUpdate(id: string | number, diff: Partial<T>, config?: CrudConfig, opts?: CrudOptions): Promise<T>;
+    delete(id: string | number, config?: CrudConfig): Promise<void>;
+    updateOrCreate(data: Partial<T> & {
+        id?: string | number;
+    }, config?: CrudConfig, opts?: CrudOptions): Promise<T>;
+    updateOrder(startId: string | number, endId: string | number, config?: CrudConfig): Promise<void>;
+}
+export interface Credentials {
+    username: string;
+    password: string;
+}
+export interface AuthToken {
+    token: string;
+    [key: string]: unknown;
+}
+/**
+ * Shape of `runtimeConfig.public.mapoCore` as written by the module setup.
+ * All entries are guaranteed by the module `defaults`.
+ */
+export interface MapoCoreRuntimeConfig {
+    authLoginUrl: string;
+    userInfoApi: string;
+    logoutUrl: string;
+    loginUrl: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/runtime/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/runtime/types.ts"],"names":[],"mappings":"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"}

package/dist/runtime/types.js

@@ -0,0 +1,10 @@
+export var MultipartPolicyEnum = /* @__PURE__ */ ((MultipartPolicyEnum2) => {
+  MultipartPolicyEnum2["Auto"] = "auto";
+  MultipartPolicyEnum2["Force"] = "force";
+  MultipartPolicyEnum2["Disable"] = "disable";
+  return MultipartPolicyEnum2;
+})(MultipartPolicyEnum || {});
+export var CoreCookieEnum = /* @__PURE__ */ ((CoreCookieEnum2) => {
+  CoreCookieEnum2["Session"] = "__mapo_session";
+  return CoreCookieEnum2;
+})(CoreCookieEnum || {});

package/dist/runtime/types.nuxt.d.ts

@@ -0,0 +1,18 @@
+import type { $Fetch } from "ofetch";
+
+declare module "nuxt/app" {
+  interface NuxtApp {
+    $mapoFetch: $Fetch;
+  }
+}
+
+declare module "vue-router" {
+  interface RouteMeta {
+    permissions?: { model: string } | string[];
+    roles?: string[];
+    /** Route middleware names applied to this route. Read by useCanAccessRoute for sidebar visibility. */
+    middleware?: string | string[];
+  }
+}
+
+export {};

package/dist/runtime/utils/useMapoFetch.d.ts

@@ -0,0 +1,30 @@
+import type { $Fetch } from "ofetch";
+import type { ComputedRef } from "vue";
+export interface UseMapoFetchReturn {
+    /** The auth-aware `$mapoFetch` instance (same one provided by the plugin). */
+    fetch: $Fetch;
+    /**
+     * `true` while at least one `$mapoFetch` request is in flight — globally,
+     * across the entire app. Incremented by the plugin-level `onRequest` hook
+     * and decremented by `onResponse` / `onResponseError`, so it stays accurate
+     * even for raw `useNuxtApp().$mapoFetch` calls outside this composable.
+     */
+    loading: ComputedRef<boolean>;
+}
+/**
+ * Returns the global `$mapoFetch` instance together with a centralized
+ * `loading` indicator that tracks **all** in-flight `$mapoFetch` requests,
+ * not just the ones made through this composable.
+ *
+ * @example
+ * ```ts
+ * const { fetch, loading } = useMapoFetch()
+ * await fetch('/api/articles/', { method: 'POST', body: payload })
+ * ```
+ *
+ * ```vue
+ * <UButton :loading="loading" @click="submit">Save</UButton>
+ * ```
+ */
+export declare function useMapoFetch(): UseMapoFetchReturn;
+//# sourceMappingURL=useMapoFetch.d.ts.map

package/dist/runtime/utils/useMapoFetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMapoFetch.d.ts","sourceRoot":"","sources":["../../../src/runtime/utils/useMapoFetch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AAEvC,MAAM,WAAW,kBAAkB;IACjC,8EAA8E;IAC9E,KAAK,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;CAC/B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,IAAI,kBAAkB,CASjD"}

package/dist/runtime/utils/useMapoFetch.js

@@ -0,0 +1,8 @@
+import { useNuxtApp } from "nuxt/app";
+export function useMapoFetch() {
+  const nuxt = useNuxtApp();
+  return {
+    fetch: nuxt.$mapoFetch,
+    loading: nuxt.$mapoFetchLoading
+  };
+}

package/dist/types.d.mts

@@ -0,0 +1,13 @@
+import type { NuxtModule } from '@nuxt/schema'
+
+import type { default as Module } from './module.mjs'
+
+export type ModuleOptions = typeof Module extends NuxtModule<infer O> ? Partial<O> : Record<string, any>
+
+export { type ApiResponse, type AuthToken, type CoreCookieEnum, type Credentials, type CrudConfig, type CrudOptions, type CrudRepository, type ListParams, type MultipartPolicy, type MultipartPolicyEnum, type PaginatedResponse } from '../dist/runtime/types.js'
+
+export { type MapoApiLayer, type MapoFacade } from '../dist/runtime/composables/useMapo.js'
+
+export { type RoutePermissions } from '../dist/runtime/auth/useCanAccessRoute.js'
+
+export { type MapoOptions, default } from './module.mjs'

package/dist/types.d.ts

@@ -0,0 +1,13 @@
+export interface MapoOptions {
+    authLoginUrl?: string;
+    userInfoApi?: string;
+    logoutUrl?: string;
+    loginUrl?: string;
+}
+export declare const MAPO_DEFAULTS: {
+    authLoginUrl: string;
+    userInfoApi: string;
+    logoutUrl: string;
+    loginUrl: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,aAAa;;;;;CAKO,CAAC"}

package/package.json

@@ -1,22 +1,65 @@
 {
   "name": "@mapomodule/core",
-  "version": "1.0.0",
-  "description": "This is part of Mapo nuxt module. Injects the core mapo plugin helpers.",
-  "author": "bnznamco <gabriele.baldi.01@gmail.com>",
-  "keywords": [
-    "mapo",
-    "nuxt",
-    "Admin",
-    "Panel"
-  ],
+  "version": "2.0.0-beta.2",
+  "description": "Mapo core: API layer, auth, composables, middleware",
+  "type": "module",
   "license": "MIT",
-  "repository": "https://github.com/lotrekagency/mapo",
-  "main": "./module.js",
-  "dependencies": {
-    "@mapomodule/utils": "^1.0.0"
+  "author": "Lotrek Agency (https://lotrek.it)",
+  "homepage": "https://lotrekagency.github.io/mapo-new/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lotrekagency/mapo-new.git",
+    "directory": "packages/@mapomodule/core"
+  },
+  "bugs": {
+    "url": "https://github.com/lotrekagency/mapo-new/issues"
   },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "tag": "next"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/module.d.mts",
+      "import": "./dist/module.mjs"
+    },
+    "./types": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    },
+    "./runtime/*": {
+      "types": "./src/runtime/*.ts",
+      "import": "./dist/runtime/*.js",
+      "default": "./src/runtime/*"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "dev": "nuxt-module-build build --stub --watch",
+    "build": "nuxt-module-build build && tsc -p tsconfig.build-types.json",
+    "prepack": "pnpm build",
+    "dev:prepare": "nuxt-module-build build --stub",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src"
+  },
+  "dependencies": {
+    "@mapomodule/store": "2.0.0-beta.2",
+    "@mapomodule/utils": "2.0.0-beta.1"
+  },
+  "peerDependencies": {
+    "nuxt": ">=4.0.0"
   },
-  "gitHead": "1e825711fb068d6195fe6dda607d1fb0e05109ec"
+  "devDependencies": {
+    "@nuxt/kit": "4.4.2",
+    "@nuxt/module-builder": "^1.0.2",
+    "@nuxt/schema": "4.4.2",
+    "nuxt": "^4.4.2",
+    "ofetch": "^1.5.1",
+    "pinia": "^3.0.4",
+    "vue": "^3.5.32",
+    "vue-router": "^5.0.4"
+  }
 }

package/src/index.ts

@@ -0,0 +1,4 @@
+export type * from "./module";
+export { MultipartPolicyEnum, CoreCookieEnum } from "./runtime/types";
+export { useCanAccessRoute } from "./runtime/auth/useCanAccessRoute";
+export { useMapoFetch } from "./runtime/utils/useMapoFetch";

package/src/module.ts

@@ -0,0 +1,102 @@
+import { readFileSync } from "node:fs";
+import {
+  defineNuxtModule,
+  addImports,
+  addPlugin,
+  addRouteMiddleware,
+  addTypeTemplate,
+  hasNuxtModule,
+  installModule,
+  createResolver,
+} from "@nuxt/kit";
+import type { NuxtModule } from "@nuxt/schema";
+import { MAPO_DEFAULTS } from "./types";
+import type { MapoOptions } from "./types";
+
+export type { MapoOptions } from "./types";
+export type {
+  ListParams,
+  PaginatedResponse,
+  ApiResponse,
+  CrudConfig,
+  CrudOptions,
+  CrudRepository,
+  MultipartPolicy,
+  Credentials,
+  AuthToken,
+} from "./runtime/types";
+export { MultipartPolicyEnum, CoreCookieEnum } from "./runtime/types";
+export type { MapoFacade, MapoApiLayer } from "./runtime/composables/useMapo";
+export type { RoutePermissions } from "./runtime/auth/useCanAccessRoute";
+
+export default defineNuxtModule<MapoOptions>({
+  meta: {
+    name: "@mapomodule/core",
+    configKey: "mapoCore",
+  },
+
+  defaults: MAPO_DEFAULTS,
+
+  async setup(options, nuxt) {
+    const resolver = createResolver(import.meta.url);
+
+    addTypeTemplate({
+      filename: "types/mapo-core-page-meta.d.ts",
+      getContents: () =>
+        readFileSync(
+          resolver.resolve("./runtime/page-meta.nuxt.d.ts"),
+          "utf-8",
+        ),
+    });
+
+    if (!hasNuxtModule("@mapomodule/store")) {
+      await installModule("@mapomodule/store");
+    }
+
+    // `defaults` guarantees these are set at runtime, but MapoOptions keeps
+    // them optional — spread the defaults so the assignment is fully defined.
+    nuxt.options.runtimeConfig.public.mapoCore = {
+      ...MAPO_DEFAULTS,
+      ...options,
+    };
+
+    addPlugin({ src: resolver.resolve("./runtime/plugins/00.fetch") });
+    addPlugin({
+      src: resolver.resolve("./runtime/plugins/01.init.server"),
+      mode: "server",
+    });
+
+    addImports([
+      { name: "useCrud", from: resolver.resolve("./runtime/api/crud") },
+      {
+        name: "useMapoAuth",
+        from: resolver.resolve("./runtime/auth/useMapoAuth"),
+      },
+      {
+        name: "useMapo",
+        from: resolver.resolve("./runtime/composables/useMapo"),
+      },
+      {
+        name: "useCanAccessRoute",
+        from: resolver.resolve("./runtime/auth/useCanAccessRoute"),
+      },
+      {
+        name: "useMapoFetch",
+        from: resolver.resolve("./runtime/utils/useMapoFetch"),
+      },
+    ]);
+
+    addRouteMiddleware({
+      name: "auth",
+      path: resolver.resolve("./runtime/middleware/auth"),
+    });
+    addRouteMiddleware({
+      name: "permissions",
+      path: resolver.resolve("./runtime/middleware/permissions"),
+    });
+    addRouteMiddleware({
+      name: "roles",
+      path: resolver.resolve("./runtime/middleware/roles"),
+    });
+  },
+}) satisfies NuxtModule<MapoOptions>;