@axcode/axcloud-sdk 0.1.4 → 0.1.5

package/LICENSE.md

@@ -0,0 +1,9 @@
+# AxCloud SDK License
+
+Copyright (c) 2026 Axcode AB. All rights reserved.
+
+This package is proprietary software owned by Axcode AB.
+
+Use, copying, modification, distribution, or sublicensing of this package is only permitted under a separate written agreement with Axcode AB.
+
+No open source license is granted.

package/README.md

@@ -87,6 +87,21 @@ function NewsPage() {
 
 > **Content visibility:** When the user is authenticated, `useNews`, `useContent('pages')`, and `useContent('events')` automatically fetch **public + internal + members-only** content based on the user's organization membership. For anonymous users, only public content is returned.
 
+Pages can be stored once in AxCloud with translations and requested per language:
+
+```tsx
+import { useContentItem } from '@axcode/axcloud-sdk'
+
+function AboutPage({ locale }: { locale: 'sv' | 'en' }) {
+  const { data: page } = useContentItem('pages', 'about-us', {
+    lang: locale,
+    publicOnly: true,
+  })
+
+  return <h1>{page?.title}</h1>
+}
+```
+
 ### 3. Add authentication
 
 ```tsx
@@ -254,11 +269,14 @@ interface ContentQueryOptions {
   page?: number           // Page number (default: 1)
   pageSize?: number       // Items per page (default: 20)
   status?: 'draft' | 'published' | 'archived'
-  visibility?: 'public' | 'members' | 'section'
+  visibility?: 'draft' | 'published' | 'archived'
+  audience?: 'public' | 'internal' | 'members' | 'section'
   sectionId?: string      // Filter by specific section
   search?: string         // Search in title/content
   sortBy?: string         // Sort field (default: 'createdAt')
   sortOrder?: 'asc' | 'desc'
+  lang?: string           // Return translated title/slug/blocks when available
+  publicOnly?: boolean    // Force public endpoint even when authenticated
 }
 ```
 

package/dist/index.d.mts

@@ -197,21 +197,66 @@ interface Membership {
     expiresAt?: string;
     metadata?: Record<string, unknown>;
 }
+interface ContentBlock {
+    id: string;
+    type: string;
+    content?: string;
+    url?: string;
+    alt?: string;
+    level?: 1 | 2 | 3 | 4 | 5 | 6;
+    items?: unknown[];
+    language?: string;
+    caption?: string;
+    attributes?: Record<string, unknown>;
+    ordered?: boolean;
+    author?: string;
+}
+interface ContentTranslation {
+    title: string;
+    slug: string;
+    description?: string;
+    blocks: ContentBlock[];
+    metaTitle?: string;
+    metaDescription?: string;
+    keywords?: string[];
+}
+type ContentPublicationState = 'draft' | 'published' | 'archived';
+type ContentAudience = 'public' | 'internal' | 'members' | 'section';
 interface ContentItem {
     id: string;
     organizationId: string;
     type: string;
     title: string;
     slug: string;
-    content: string;
+    /** Legacy string content. New AxCloud content uses `blocks`. */
+    content?: string;
+    description?: string;
+    blocks?: ContentBlock[];
     excerpt?: string;
     author?: {
         id: string;
         name: string;
     };
-    status: 'draft' | 'published' | 'archived';
-    visibility: 'public' | 'members' | 'section';
+    status?: ContentPublicationState;
+    visibility?: ContentPublicationState;
+    audience?: ContentAudience;
     sectionId?: string;
+    tags?: string[];
+    lang?: string;
+    featuredImage?: string;
+    metaTitle?: string;
+    metaDescription?: string;
+    keywords?: string[];
+    translations?: Record<string, ContentTranslation>;
+    currentLanguage?: string;
+    availableLanguages?: string[];
+    seo?: {
+        canonical: string;
+        hreflang: Array<{
+            lang: string;
+            href: string;
+        }>;
+    };
     publishedAt?: string;
     createdAt: string;
     updatedAt: string;
@@ -253,12 +298,15 @@ interface AxCloudConfig {
 interface ContentQueryOptions {
     page?: number;
     pageSize?: number;
-    status?: 'draft' | 'published' | 'archived';
-    visibility?: 'public' | 'members' | 'section';
+    status?: ContentPublicationState;
+    visibility?: ContentPublicationState;
+    audience?: ContentAudience;
     sectionId?: string;
     search?: string;
     sortBy?: string;
     sortOrder?: 'asc' | 'desc';
+    /** Return the requested translation when content has language variants. */
+    lang?: string;
     /** Force public endpoint even when authenticated (for public pages) */
     publicOnly?: boolean;
 }
@@ -685,7 +733,7 @@ interface PublicOrganization {
  *
  * Automatically uses the appropriate endpoint:
  * - With API key (public): `/content/public/{orgId}/org`
- * - With JWT auth: `/{stage}/api/organizations/{orgId}`
+ * - With JWT auth: `/orgs/api/organizations/{orgId}`
  *
  * @example
  * ```tsx
@@ -817,6 +865,8 @@ declare function useContent<T extends ContentItem = ContentItem>(contentType: st
 interface ContentItemOptions {
     /** Force public endpoint even when authenticated */
     publicOnly?: boolean;
+    /** Return the requested translation when content has language variants. */
+    lang?: string;
 }
 /**
  * useContentItem - Fetch a single content item by ID or slug
@@ -833,7 +883,7 @@ interface ContentItemOptions {
  * @example
  * ```tsx
  * // Fetch a page by slug
- * const { data: page } = useContentItem('pages', 'about-us')
+ * const { data: page } = useContentItem('pages', 'about-us', { lang: 'sv' })
  *
  * // Force public endpoint
  * const { data: page } = useContentItem('pages', 'about-us', { publicOnly: true })

package/dist/index.d.ts

@@ -197,21 +197,66 @@ interface Membership {
     expiresAt?: string;
     metadata?: Record<string, unknown>;
 }
+interface ContentBlock {
+    id: string;
+    type: string;
+    content?: string;
+    url?: string;
+    alt?: string;
+    level?: 1 | 2 | 3 | 4 | 5 | 6;
+    items?: unknown[];
+    language?: string;
+    caption?: string;
+    attributes?: Record<string, unknown>;
+    ordered?: boolean;
+    author?: string;
+}
+interface ContentTranslation {
+    title: string;
+    slug: string;
+    description?: string;
+    blocks: ContentBlock[];
+    metaTitle?: string;
+    metaDescription?: string;
+    keywords?: string[];
+}
+type ContentPublicationState = 'draft' | 'published' | 'archived';
+type ContentAudience = 'public' | 'internal' | 'members' | 'section';
 interface ContentItem {
     id: string;
     organizationId: string;
     type: string;
     title: string;
     slug: string;
-    content: string;
+    /** Legacy string content. New AxCloud content uses `blocks`. */
+    content?: string;
+    description?: string;
+    blocks?: ContentBlock[];
     excerpt?: string;
     author?: {
         id: string;
         name: string;
     };
-    status: 'draft' | 'published' | 'archived';
-    visibility: 'public' | 'members' | 'section';
+    status?: ContentPublicationState;
+    visibility?: ContentPublicationState;
+    audience?: ContentAudience;
     sectionId?: string;
+    tags?: string[];
+    lang?: string;
+    featuredImage?: string;
+    metaTitle?: string;
+    metaDescription?: string;
+    keywords?: string[];
+    translations?: Record<string, ContentTranslation>;
+    currentLanguage?: string;
+    availableLanguages?: string[];
+    seo?: {
+        canonical: string;
+        hreflang: Array<{
+            lang: string;
+            href: string;
+        }>;
+    };
     publishedAt?: string;
     createdAt: string;
     updatedAt: string;
@@ -253,12 +298,15 @@ interface AxCloudConfig {
 interface ContentQueryOptions {
     page?: number;
     pageSize?: number;
-    status?: 'draft' | 'published' | 'archived';
-    visibility?: 'public' | 'members' | 'section';
+    status?: ContentPublicationState;
+    visibility?: ContentPublicationState;
+    audience?: ContentAudience;
     sectionId?: string;
     search?: string;
     sortBy?: string;
     sortOrder?: 'asc' | 'desc';
+    /** Return the requested translation when content has language variants. */
+    lang?: string;
     /** Force public endpoint even when authenticated (for public pages) */
     publicOnly?: boolean;
 }
@@ -685,7 +733,7 @@ interface PublicOrganization {
  *
  * Automatically uses the appropriate endpoint:
  * - With API key (public): `/content/public/{orgId}/org`
- * - With JWT auth: `/{stage}/api/organizations/{orgId}`
+ * - With JWT auth: `/orgs/api/organizations/{orgId}`
  *
  * @example
  * ```tsx
@@ -817,6 +865,8 @@ declare function useContent<T extends ContentItem = ContentItem>(contentType: st
 interface ContentItemOptions {
     /** Force public endpoint even when authenticated */
     publicOnly?: boolean;
+    /** Return the requested translation when content has language variants. */
+    lang?: string;
 }
 /**
  * useContentItem - Fetch a single content item by ID or slug
@@ -833,7 +883,7 @@ interface ContentItemOptions {
  * @example
  * ```tsx
  * // Fetch a page by slug
- * const { data: page } = useContentItem('pages', 'about-us')
+ * const { data: page } = useContentItem('pages', 'about-us', { lang: 'sv' })
  *
  * // Force public endpoint
  * const { data: page } = useContentItem('pages', 'about-us', { publicOnly: true })

package/dist/index.js

@@ -706,6 +706,7 @@ function useNews(options = {}) {
   };
 }
 var MEMBER_ENDPOINT_TYPES = ["news", "pages", "events"];
+var PAGE_CONTENT_TYPES = ["page", "pages"];
 function useContent(contentType, options = {}) {
   const { client, orgId, isPublicMode } = useAxCloudContext();
   const {
@@ -717,7 +718,8 @@ function useContent(contentType, options = {}) {
     sectionId,
     search,
     sortBy = "createdAt",
-    sortOrder = "desc"
+    sortOrder = "desc",
+    lang
   } = options;
   const query = reactQuery.useQuery({
     queryKey: [
@@ -734,7 +736,8 @@ function useContent(contentType, options = {}) {
       sectionId,
       search,
       sortBy,
-      sortOrder
+      sortOrder,
+      lang
     ],
     queryFn: async () => {
       const useMemberEndpoint = !isPublicMode && !publicOnly && MEMBER_ENDPOINT_TYPES.includes(contentType);
@@ -747,7 +750,8 @@ function useContent(contentType, options = {}) {
         sectionId,
         search,
         sortBy,
-        sortOrder
+        sortOrder,
+        lang
       });
     },
     staleTime: 1e3 * 60 * 5
@@ -765,13 +769,15 @@ function useContent(contentType, options = {}) {
 }
 function useContentItem(contentType, idOrSlug, options = {}) {
   const { client, orgId, isPublicMode } = useAxCloudContext();
-  const { publicOnly = false } = options;
-  const useMemberEndpoint = !isPublicMode && !publicOnly && MEMBER_ENDPOINT_TYPES.includes(contentType);
+  const { publicOnly = false, lang } = options;
+  const useMemberEndpoint = !isPublicMode && !publicOnly && (MEMBER_ENDPOINT_TYPES.includes(contentType) || PAGE_CONTENT_TYPES.includes(contentType));
   const query = reactQuery.useQuery({
-    queryKey: ["axcloud", "content", orgId, contentType, idOrSlug, useMemberEndpoint],
+    queryKey: ["axcloud", "content", orgId, contentType, idOrSlug, useMemberEndpoint, lang],
     queryFn: async () => {
       const basePath = useMemberEndpoint ? "members" : "public";
-      return client.get(`/content/${basePath}/${orgId}/${contentType}/${idOrSlug}`);
+      const encodedIdOrSlug = encodeURIComponent(idOrSlug);
+      const endpoint = PAGE_CONTENT_TYPES.includes(contentType) ? `/content/${basePath}/${orgId}/page/${encodedIdOrSlug}` : `/content/${basePath}/${orgId}/${contentType}/${encodedIdOrSlug}`;
+      return lang ? client.get(endpoint, { lang }) : client.get(endpoint);
     },
     enabled: !!idOrSlug,
     staleTime: 1e3 * 60 * 5
@@ -800,7 +806,7 @@ function useMySection(options = {}) {
         `/orgs/api/organizations/${orgId}/sections/${sectionId}`,
         { includeMembers: includeMembers ? "true" : void 0 }
       );
-      return "success" in response && response.data ? response.data : response;
+      return "success" in response && response.success === true && response.data ? response.data : response;
     },
     enabled: isAuthenticated && !isUserLoading && !!sectionId,
     staleTime: 1e3 * 60 * 5
@@ -827,7 +833,7 @@ function useSections() {
     queryKey: ["axcloud", "sections", orgId, stage],
     queryFn: async () => {
       const response = await client.get(`/orgs/api/organizations/${orgId}/sections`);
-      return "success" in response && response.data ? response.data : response;
+      return "success" in response && response.success === true && response.data ? response.data : response;
     },
     staleTime: 1e3 * 60 * 10
     // 10 minutes