@axcode/axcloud-sdk 0.1.6 → 0.1.7-dev.332678a

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { createContext, useContext, useMemo, useCallback, useRef } from 'react';
+import { createContext, useContext, useMemo, useCallback, useState, useRef } from 'react';
 import { Auth0Provider, useAuth0 } from '@auth0/auth0-react';
 import { QueryClient, QueryClientProvider, useQuery, useQueryClient, useMutation } from '@tanstack/react-query';
 import { jsx, Fragment, jsxs } from 'react/jsx-runtime';
@@ -122,7 +122,7 @@ var AxCloudClient = class {
    */
   shouldAttachApiKey(path) {
     const normalized = path.startsWith("/") ? path : `/${path}`;
-    return normalized.startsWith("/public/") || normalized.startsWith("/api/public/") || normalized.startsWith("/content/public/");
+    return normalized.startsWith("/public/") || normalized.startsWith("/api/public/") || normalized.startsWith("/content/public/") || normalized.startsWith("/media/public/") || normalized.startsWith("/documents/public/") || normalized.startsWith("/barnsport/public/") || normalized.startsWith("/api/barnsport/public/");
   }
   /**
    * Make an authenticated request
@@ -431,6 +431,98 @@ function createFormHelper(config) {
     })
   };
 }
+
+// src/core/voting.ts
+function baseOf(votingApiUrl) {
+  return votingApiUrl.replace(/\/$/, "");
+}
+async function readJson(response) {
+  const json = await response.json().catch(() => ({}));
+  if (json && typeof json === "object" && "success" in json && "data" in json) {
+    return json.data;
+  }
+  return json;
+}
+async function ensureOk(response) {
+  if (!response.ok) {
+    const body = await response.json().catch(() => ({}));
+    const message = body && (body.error || body.message) || `Request failed with status ${response.status}`;
+    throw new Error(message);
+  }
+}
+async function checkVotingCode(votingApiUrl, params) {
+  const response = await fetch(
+    `${baseOf(votingApiUrl)}/public/organizations/${params.orgId}/polls/${params.pollId}/eligibility`,
+    {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ code: params.code })
+    }
+  );
+  await ensureOk(response);
+  return readJson(response);
+}
+async function castVoteWithCode(votingApiUrl, params) {
+  const response = await fetch(
+    `${baseOf(votingApiUrl)}/public/organizations/${params.orgId}/polls/${params.pollId}/vote`,
+    {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ code: params.code, selected_options: params.selectedOptions, rankings: params.rankings })
+    }
+  );
+  await ensureOk(response);
+  return readJson(response);
+}
+async function getVotingReceipt(votingApiUrl, params) {
+  const response = await fetch(
+    `${baseOf(votingApiUrl)}/public/organizations/${params.orgId}/polls/${params.pollId}/receipt`,
+    {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ code: params.code })
+    }
+  );
+  await ensureOk(response);
+  return readJson(response);
+}
+function authHeaders(accessToken) {
+  return { "Content-Type": "application/json", Authorization: `Bearer ${accessToken}` };
+}
+async function getBallot(votingApiUrl, params) {
+  const base = `${baseOf(votingApiUrl)}/organizations/${params.orgId}/polls/${params.pollId}`;
+  const pollResp = await fetch(base, { headers: authHeaders(params.accessToken) });
+  await ensureOk(pollResp);
+  const poll = await readJson(pollResp);
+  let candidates = [];
+  if (poll.poll_type === "election") {
+    const candResp = await fetch(`${base}/candidates`, { headers: authHeaders(params.accessToken) });
+    await ensureOk(candResp);
+    const data = await readJson(candResp);
+    candidates = data.candidates || [];
+  }
+  return { ...poll, candidates };
+}
+async function checkEligibility(votingApiUrl, params) {
+  const response = await fetch(
+    `${baseOf(votingApiUrl)}/organizations/${params.orgId}/polls/${params.pollId}/eligibility`,
+    { headers: authHeaders(params.accessToken) }
+  );
+  await ensureOk(response);
+  return readJson(response);
+}
+async function castVote(votingApiUrl, params) {
+  const response = await fetch(
+    `${baseOf(votingApiUrl)}/organizations/${params.orgId}/polls/${params.pollId}/vote`,
+    {
+      method: "POST",
+      headers: authHeaders(params.accessToken),
+      body: JSON.stringify({ selected_options: params.selectedOptions, rankings: params.rankings })
+    }
+  );
+  await ensureOk(response);
+  return readJson(response);
+}
 var AxCloudContext = createContext(null);
 function useAxCloudContext() {
   const context = useContext(AxCloudContext);
@@ -519,14 +611,15 @@ function AxCloudProvider({
       clientId: auth0.clientId,
       authorizationParams: {
         redirect_uri: auth0.redirectUri,
-        audience: auth0.audience
+        audience: auth0.audience,
+        ...auth0.organization ? { organization: auth0.organization } : {}
       },
       children: /* @__PURE__ */ jsx(AxCloudInnerProvider, { config, timeout, children })
     }
   ) });
 }
 function useAuth() {
-  const { config } = useAxCloudContext();
+  const { config, client } = useAxCloudContext();
   const {
     isAuthenticated,
     isLoading,
@@ -542,10 +635,15 @@ function useAuth() {
       return loginWithRedirect({
         appState: {
           returnTo: options?.returnTo || window.location.pathname
-        }
+        },
+        ...config.auth0.organization ? {
+          authorizationParams: {
+            organization: config.auth0.organization
+          }
+        } : {}
       });
     },
-    [loginWithRedirect]
+    [config.auth0.organization, loginWithRedirect]
   );
   const logout = useCallback(
     (options) => {
@@ -564,6 +662,60 @@ function useAuth() {
       return void 0;
     }
   }, [getAccessTokenSilently]);
+  const refreshUser = useCallback(async () => {
+    await getAccessTokenSilently({ cacheMode: "off" });
+    const claims = await getIdTokenClaims();
+    return claims?.email_verified === true;
+  }, [getAccessTokenSilently, getIdTokenClaims]);
+  const requestEmailVerification = useCallback(
+    async (options) => {
+      if (!isAuthenticated || !auth0User) {
+        return {
+          success: false,
+          status: "failed",
+          message: "You must be signed in to verify your email."
+        };
+      }
+      if (auth0User.email_verified === true) {
+        return {
+          success: true,
+          status: "already_verified",
+          message: "Your email address is already verified."
+        };
+      }
+      try {
+        const response = await client.post("/email/identity/verification-email", {
+          return_to: options?.returnTo || window.location.href
+        });
+        const data = response.data || {};
+        return {
+          success: true,
+          status: data.status || "sent",
+          message: data.message || "A verification email has been sent.",
+          ...data.retry_after_seconds !== void 0 ? { retryAfterSeconds: data.retry_after_seconds } : {}
+        };
+      } catch (requestError) {
+        if (isAxCloudError(requestError) && requestError.status === 429) {
+          const responseDetails = requestError.details?.details;
+          const retryAfterSeconds = Number(
+            responseDetails && typeof responseDetails === "object" ? responseDetails.retry_after_seconds : void 0
+          );
+          return {
+            success: false,
+            status: "rate_limited",
+            message: "Please wait before requesting another verification email.",
+            ...Number.isFinite(retryAfterSeconds) ? { retryAfterSeconds } : {}
+          };
+        }
+        return {
+          success: false,
+          status: "failed",
+          message: "Failed to send the verification email. Please try again."
+        };
+      }
+    },
+    [auth0User, client, isAuthenticated]
+  );
   const getAuth0Client = useCallback(() => {
     return {
       loginWithRedirect,
@@ -637,13 +789,17 @@ function useAuth() {
       id: auth0User.sub || "",
       email: auth0User.email || "",
       name: auth0User.name || "",
-      avatar: auth0User.picture
+      avatar: auth0User.picture,
+      ...typeof auth0User.email_verified === "boolean" ? { emailVerified: auth0User.email_verified } : {}
     } : null,
+    needsEmailVerification: isAuthenticated && auth0User?.email_verified === false,
     login,
     logout,
     // Escape hatch for advanced use cases
     getAccessToken,
     getAuth0Client,
+    refreshUser,
+    requestEmailVerification,
     // Password management
     requestPasswordReset
   };
@@ -741,6 +897,7 @@ function useNews(options = {}) {
     search,
     sortBy = "publishedAt",
     sortOrder = "desc",
+    lang,
     publicOnly = false
   } = options;
   const usePublicEndpoint = isPublicMode || publicOnly;
@@ -757,7 +914,8 @@ function useNews(options = {}) {
       sectionId,
       search,
       sortBy,
-      sortOrder
+      sortOrder,
+      lang
     ],
     queryFn: async () => {
       const endpoint = usePublicEndpoint ? `/content/public/${orgId}/news` : `/content/members/${orgId}/news`;
@@ -769,7 +927,8 @@ function useNews(options = {}) {
         sectionId,
         search,
         sortBy,
-        sortOrder
+        sortOrder,
+        lang
       });
     },
     staleTime: 1e3 * 60 * 5
@@ -998,6 +1157,76 @@ function useUpdateFormSubmission() {
     }
   });
 }
+function useCodeBallot({ pollId, votingApiUrl }) {
+  const { orgId, config } = useAxCloudContext();
+  const baseUrl = votingApiUrl || `${config.apiUrl.replace(/\/$/, "")}/voting`;
+  const [stage, setStage] = useState("enter_code");
+  const [code, setCode] = useState("");
+  const [ballot, setBallot] = useState(null);
+  const [receipt, setReceipt] = useState(null);
+  const [reason, setReason] = useState(void 0);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState(null);
+  const validateCode = useCallback(
+    async (inputCode) => {
+      setLoading(true);
+      setError(null);
+      try {
+        const result = await checkVotingCode(baseUrl, { orgId, pollId, code: inputCode });
+        setCode(inputCode);
+        setReason(result.reason);
+        if (result.has_voted) {
+          const r = await getVotingReceipt(baseUrl, { orgId, pollId, code: inputCode }).catch(() => null);
+          setReceipt(r);
+          setStage("already_voted");
+        } else if (result.eligible && result.ballot) {
+          setBallot(result.ballot);
+          setStage("ballot");
+        } else {
+          setError(result.reason || "This code cannot be used to vote right now.");
+        }
+        return result;
+      } catch (e) {
+        setError(e instanceof Error ? e.message : "Failed to validate code");
+        return null;
+      } finally {
+        setLoading(false);
+      }
+    },
+    [baseUrl, orgId, pollId]
+  );
+  const submitVote = useCallback(
+    async (selectedOptions, rankings) => {
+      setLoading(true);
+      setError(null);
+      try {
+        await castVoteWithCode(baseUrl, { orgId, pollId, code, selectedOptions, rankings });
+        const r = await getVotingReceipt(baseUrl, { orgId, pollId, code }).catch(() => null);
+        setReceipt(r);
+        setStage("submitted");
+        return true;
+      } catch (e) {
+        setError(e instanceof Error ? e.message : "Failed to submit vote");
+        return false;
+      } finally {
+        setLoading(false);
+      }
+    },
+    [baseUrl, orgId, pollId, code]
+  );
+  const reset = useCallback(() => {
+    setStage("enter_code");
+    setCode("");
+    setBallot(null);
+    setReceipt(null);
+    setReason(void 0);
+    setError(null);
+  }, []);
+  return useMemo(
+    () => ({ stage, code, ballot, receipt, reason, loading, error, validateCode, submitVote, reset }),
+    [stage, code, ballot, receipt, reason, loading, error, validateCode, submitVote, reset]
+  );
+}
 var LINKED_ACCOUNTS_QUERY_KEY = ["axcloud", "linked-accounts"];
 function useLinkedAccounts() {
   const { client, stage } = useAxCloudContext();
@@ -1156,6 +1385,245 @@ function useMedia(mediaId) {
     refetch: query.refetch
   };
 }
+function buildDocumentParams(options) {
+  return {
+    search: options?.search,
+    tags: options?.tags?.join(","),
+    limit: options?.limit
+  };
+}
+function useDocuments(options) {
+  const { client, orgId } = useAxCloudContext();
+  const params = buildDocumentParams(options);
+  const query = useQuery({
+    queryKey: ["axcloud", "documents", "list", orgId, options],
+    queryFn: async () => {
+      return client.get(`/documents/public/${orgId}/documents`, params);
+    },
+    staleTime: 1e3 * 60 * 5
+  });
+  return {
+    documents: query.data?.items ?? [],
+    items: query.data?.items ?? [],
+    count: query.data?.count ?? 0,
+    isLoading: query.isLoading,
+    isError: query.isError,
+    error: query.error,
+    refetch: query.refetch
+  };
+}
+function useDocumentDownload(documentId) {
+  const { client, orgId } = useAxCloudContext();
+  const query = useQuery({
+    queryKey: ["axcloud", "documents", "download", orgId, documentId],
+    queryFn: async () => {
+      return client.get(
+        `/documents/public/${orgId}/documents/${encodeURIComponent(documentId || "")}/download`
+      );
+    },
+    enabled: !!documentId,
+    staleTime: 1e3 * 60 * 10,
+    gcTime: 1e3 * 60 * 14
+  });
+  return {
+    url: query.data?.url ?? null,
+    documentUrl: query.data?.url ?? null,
+    filename: query.data?.filename ?? null,
+    mimeType: query.data?.mimeType ?? null,
+    expiresIn: query.data?.expiresIn ?? null,
+    isLoading: query.isLoading,
+    isError: query.isError,
+    error: query.error,
+    refetch: query.refetch
+  };
+}
+function useMemberDocuments(options) {
+  const { client, orgId } = useAxCloudContext();
+  const params = buildDocumentParams(options);
+  const folderId = options?.folderId;
+  const query = useQuery({
+    queryKey: ["axcloud", "documents", "member", "list", orgId, options],
+    queryFn: async () => {
+      return client.get(`/documents/members/${orgId}/documents`, params);
+    },
+    staleTime: 1e3 * 60 * 5
+  });
+  const allItems = query.data?.items ?? [];
+  const items = folderId ? allItems.filter((doc) => doc.folder_ids?.includes(folderId)) : allItems;
+  return {
+    documents: items,
+    items,
+    count: folderId ? items.length : query.data?.count ?? 0,
+    isLoading: query.isLoading,
+    isError: query.isError,
+    error: query.error,
+    refetch: query.refetch
+  };
+}
+function useMemberDocumentFolders() {
+  const { client, orgId } = useAxCloudContext();
+  const query = useQuery({
+    queryKey: ["axcloud", "documents", "member", "folders", orgId],
+    queryFn: async () => {
+      return client.get(
+        `/documents/members/${orgId}/document-folders`
+      );
+    },
+    staleTime: 1e3 * 60 * 5
+  });
+  return {
+    folders: query.data?.folders ?? [],
+    isLoading: query.isLoading,
+    isError: query.isError,
+    error: query.error,
+    refetch: query.refetch
+  };
+}
+function useMemberDocumentDownload(documentId) {
+  const { client, orgId } = useAxCloudContext();
+  const query = useQuery({
+    queryKey: ["axcloud", "documents", "member", "download", orgId, documentId],
+    queryFn: async () => {
+      return client.get(
+        `/documents/members/${orgId}/documents/${encodeURIComponent(documentId || "")}/download`
+      );
+    },
+    enabled: !!documentId,
+    staleTime: 1e3 * 60 * 10,
+    gcTime: 1e3 * 60 * 14
+  });
+  return {
+    url: query.data?.url ?? null,
+    documentUrl: query.data?.url ?? null,
+    filename: query.data?.filename ?? null,
+    mimeType: query.data?.mimeType ?? null,
+    expiresIn: query.data?.expiresIn ?? null,
+    isLoading: query.isLoading,
+    isError: query.isError,
+    error: query.error,
+    refetch: query.refetch
+  };
+}
+function useBarnsportMunicipalities() {
+  const { client, orgId } = useAxCloudContext();
+  const query = useQuery({
+    queryKey: ["axcloud", "barnsport", "municipalities", orgId],
+    queryFn: () => client.get(
+      `/barnsport/public/${orgId}/municipalities`
+    ),
+    staleTime: 1e3 * 60 * 30
+  });
+  return {
+    municipalities: query.data?.items ?? [],
+    count: query.data?.count ?? 0,
+    isLoading: query.isLoading,
+    isError: query.isError,
+    error: query.error,
+    refetch: query.refetch
+  };
+}
+function useBarnsportSports() {
+  const { client, orgId } = useAxCloudContext();
+  const query = useQuery({
+    queryKey: ["axcloud", "barnsport", "sports", orgId],
+    queryFn: () => client.get(
+      `/barnsport/public/${orgId}/sports`
+    ),
+    staleTime: 1e3 * 60 * 30
+  });
+  return {
+    sports: query.data?.items ?? [],
+    count: query.data?.count ?? 0,
+    isLoading: query.isLoading,
+    isError: query.isError,
+    error: query.error,
+    refetch: query.refetch
+  };
+}
+function useBarnsportSport(slug) {
+  const { client, orgId } = useAxCloudContext();
+  const query = useQuery({
+    queryKey: ["axcloud", "barnsport", "sport", orgId, slug],
+    queryFn: () => client.get(
+      `/barnsport/public/${orgId}/sports/${slug || ""}`
+    ),
+    enabled: Boolean(slug),
+    staleTime: 1e3 * 60 * 15
+  });
+  return {
+    sport: query.data?.sport ?? null,
+    isLoading: query.isLoading,
+    isError: query.isError,
+    error: query.error,
+    refetch: query.refetch
+  };
+}
+function useBarnsportActivities(filters = {}) {
+  const { client, orgId } = useAxCloudContext();
+  const params = { ...filters };
+  const query = useQuery({
+    queryKey: ["axcloud", "barnsport", "activities", orgId, filters],
+    queryFn: () => client.get(
+      `/barnsport/public/${orgId}/activities`,
+      params
+    ),
+    staleTime: 1e3 * 60 * 5
+  });
+  return {
+    activities: query.data?.items ?? [],
+    count: query.data?.count ?? 0,
+    nextCursor: query.data?.nextCursor ?? null,
+    isLoading: query.isLoading,
+    isError: query.isError,
+    error: query.error,
+    refetch: query.refetch
+  };
+}
+function useBarnsportActivity(slug) {
+  const { client, orgId } = useAxCloudContext();
+  const query = useQuery({
+    queryKey: ["axcloud", "barnsport", "activity", orgId, slug],
+    queryFn: () => client.get(
+      `/barnsport/public/${orgId}/activities/${slug || ""}`
+    ),
+    enabled: Boolean(slug),
+    staleTime: 1e3 * 60 * 5
+  });
+  return {
+    activity: query.data?.activity ?? null,
+    isLoading: query.isLoading,
+    isError: query.isError,
+    error: query.error,
+    refetch: query.refetch
+  };
+}
+function useBarnsportSitemap(baseUrl) {
+  const { client, orgId } = useAxCloudContext();
+  const query = useQuery({
+    queryKey: ["axcloud", "barnsport", "sitemap", orgId, baseUrl],
+    queryFn: () => client.get(`/barnsport/public/${orgId}/sitemap`, {
+      baseUrl
+    }),
+    staleTime: 1e3 * 60 * 15
+  });
+  return {
+    sitemap: query.data ?? null,
+    urls: query.data?.urls ?? [],
+    isLoading: query.isLoading,
+    isError: query.isError,
+    error: query.error,
+    refetch: query.refetch
+  };
+}
+function useSubmitBarnsportInterest() {
+  const { client, orgId } = useAxCloudContext();
+  return useMutation({
+    mutationFn: (submission) => client.post(
+      `/barnsport/public/${orgId}/interest`,
+      submission
+    )
+  });
+}
 function LoginButton({
   children = "Log in",
   returnTo,
@@ -1399,6 +1867,6 @@ function LinkedAccountsList({
   ] });
 }
 
-export { AxCloudClient, AxCloudError, AxCloudProvider, LinkedAccountsList, LoginButton, LogoutButton, ModuleGate, ProtectedRoute, createClient, createContentSlotReader, createFormHelper, getClient, getContentSlotMap, isAxCloudError, submitForm, useAuth, useAvatar, useAxCloudContext, useBranding, useContent, useContentItem, useFormStats, useForms, useLinkedAccounts, useLogo, useMedia, useMediaList, useModuleAccess, useMySection, useNews, useOrg, usePageContent, useSections, useUpdateFormSubmission, useUser, userHasAllPermissions, userHasAnyPermission, userHasPermission };
+export { AxCloudClient, AxCloudError, AxCloudProvider, LinkedAccountsList, LoginButton, LogoutButton, ModuleGate, ProtectedRoute, castVote, castVoteWithCode, checkEligibility, checkVotingCode, createClient, createContentSlotReader, createFormHelper, getBallot, getClient, getContentSlotMap, getVotingReceipt, isAxCloudError, submitForm, useAuth, useAvatar, useAxCloudContext, useBarnsportActivities, useBarnsportActivity, useBarnsportMunicipalities, useBarnsportSitemap, useBarnsportSport, useBarnsportSports, useBranding, useCodeBallot, useContent, useContentItem, useDocumentDownload, useDocuments, useFormStats, useForms, useLinkedAccounts, useLogo, useMedia, useMediaList, useMemberDocumentDownload, useMemberDocumentFolders, useMemberDocuments, useModuleAccess, useMySection, useNews, useOrg, usePageContent, useSections, useSubmitBarnsportInterest, useUpdateFormSubmission, useUser, userHasAllPermissions, userHasAnyPermission, userHasPermission };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map