@djangocfg/ext-support 1.0.14 → 1.0.19

package/README.md

@@ -2,7 +2,7 @@
 
 ![DjangoCFG Extension Preview](https://unpkg.com/@djangocfg/ext-support@latest/preview.png)
 
-**[📦 View in Marketplace](https://hub.djangocfg.com/extensions/djangocfg-ext-support)** • **[📖 Documentation](https://djangocfg.com)** • **[⭐ GitHub](https://github.com/markolofsen/django-cfg)**
+**[View in Marketplace](https://hub.djangocfg.com/extensions/djangocfg-ext-support)** | **[Documentation](https://djangocfg.com)** | **[GitHub](https://github.com/markolofsen/django-cfg)**
 
 </div>
 
@@ -14,14 +14,17 @@ Customer support and ticketing system extension for DjangoCFG.
 
 ## Features
 
-- 🎫 **Ticket Management** - Create, track, and resolve support tickets
-- 💬 **Real-time Chat** - Live chat support integration
-- 📧 **Email Integration** - Convert emails to tickets automatically
-- 🏷️ **Categories & Tags** - Organize tickets with custom categories
-- 👥 **Team Assignment** - Assign tickets to support agents
-- 📊 **Analytics** - Track response times and resolution rates
-- 🔔 **Notifications** - Real-time ticket updates
-- 📎 **Attachments** - Support for file attachments
+- Ticket Management - Create, track, and resolve support tickets
+- Real-time Messaging - Live chat within tickets
+- Categories & Priority - Organize tickets efficiently
+- Analytics - Track response times and resolution rates
+
+## Requirements
+
+- Next.js 16+
+- React 19+
+- @djangocfg/ui-core
+- @djangocfg/ext-base
 
 ## Install
 
@@ -29,169 +32,102 @@ Customer support and ticketing system extension for DjangoCFG.
 pnpm add @djangocfg/ext-support
 ```
 
-## Usage
+## Quick Start (Next.js App Router)
 
-### Provider Setup
+### 1. Create layout.tsx (Server Component for metadata)
 
 ```typescript
-import { SupportExtensionProvider } from '@djangocfg/ext-support/hooks';
-
-export default function RootLayout({ children }) {
-  return (
-    <SupportExtensionProvider>
-      {children}
-    </SupportExtensionProvider>
-  );
+// app/support/layout.tsx
+import type { Metadata } from 'next';
+
+export const metadata: Metadata = {
+  title: 'Support',
+  description: 'Help and support center',
+};
+
+export default function SupportLayout({
+  children,
+}: {
+  children: React.ReactNode;
+}) {
+  return children;
 }
 ```
 
-### Create Support Ticket
+### 2. Create page.tsx (Client Component)
 
 ```typescript
-import { useSupportContext } from '@djangocfg/ext-support/hooks';
+// app/support/page.tsx
+'use client';
 
-function ContactSupport() {
-  const { createTicket, isCreatingTicket } = useSupportContext();
-
-  const handleSubmit = async (e: React.FormEvent<HTMLFormElement>) => {
-    e.preventDefault();
-    const formData = new FormData(e.currentTarget);
-
-    await createTicket({
-      subject: formData.get('subject') as string,
-      description: formData.get('description') as string,
-      category: 'technical',
-      priority: 'medium',
-    });
-  };
+import { SupportLayout } from '@djangocfg/ext-support';
 
+export default function SupportPage() {
   return (
-    <form onSubmit={handleSubmit}>
-      <input name="subject" placeholder="Subject" required />
-      <textarea name="description" placeholder="Describe your issue" required />
-      <button type="submit" disabled={isCreatingTicket}>
-        {isCreatingTicket ? 'Submitting...' : 'Submit Ticket'}
-      </button>
-    </form>
+    <SupportLayout>
+      {/* Optional: custom content */}
+    </SupportLayout>
   );
 }
 ```
 
-### View Tickets
+That's it! `SupportLayout` includes everything: providers, ticket list, chat panel, and create ticket dialog.
 
-```typescript
-import { useSupportContext } from '@djangocfg/ext-support/hooks';
+## Custom Integration
 
-function TicketsPage() {
-  const { tickets, isLoadingTickets, updateTicket } = useSupportContext();
+If you need more control, use individual components:
 
-  const handleStatusChange = async (ticketId: string, status: string) => {
-    await updateTicket(ticketId, { status });
-  };
-
-  return (
-    <div>
-      <h2>Support Tickets</h2>
-      {tickets.map(ticket => (
-        <div key={ticket.id}>
-          <h3>{ticket.subject}</h3>
-          <p>{ticket.description}</p>
-          <span>Status: {ticket.status}</span>
-          <span>Priority: {ticket.priority}</span>
-          <select
-            value={ticket.status}
-            onChange={(e) => handleStatusChange(ticket.id, e.target.value)}
-          >
-            <option value="open">Open</option>
-            <option value="in_progress">In Progress</option>
-            <option value="resolved">Resolved</option>
-            <option value="closed">Closed</option>
-          </select>
-        </div>
-      ))}
-    </div>
-  );
-}
-```
-
-### Ticket Details with Comments
+### Provider Setup
 
 ```typescript
-import { useSupportContext } from '@djangocfg/ext-support/hooks';
-
-function TicketDetails({ ticketId }: { ticketId: string }) {
-  const { getTicketById, addComment } = useSupportContext();
-  const [ticket, setTicket] = useState(null);
+// app/providers.tsx
+'use client';
 
-  useEffect(() => {
-    getTicketById(ticketId).then(setTicket);
-  }, [ticketId]);
-
-  const handleAddComment = async (text: string) => {
-    await addComment(ticketId, {
-      text,
-      is_internal: false,
-    });
-    // Refresh ticket
-    getTicketById(ticketId).then(setTicket);
-  };
-
-  if (!ticket) return <div>Loading...</div>;
+import { SupportProvider } from '@djangocfg/ext-support/hooks';
 
+export function Providers({ children }: { children: React.ReactNode }) {
   return (
-    <div>
-      <h2>{ticket.subject}</h2>
-      <p>{ticket.description}</p>
-
-      <div>
-        <h3>Comments</h3>
-        {ticket.comments?.map(comment => (
-          <div key={comment.id}>
-            <strong>{comment.author}</strong>
-            <p>{comment.text}</p>
-            <span>{new Date(comment.created_at).toLocaleString()}</span>
-          </div>
-        ))}
-      </div>
-
-      <textarea
-        placeholder="Add a comment..."
-        onKeyDown={(e) => {
-          if (e.key === 'Enter' && !e.shiftKey) {
-            e.preventDefault();
-            handleAddComment(e.currentTarget.value);
-            e.currentTarget.value = '';
-          }
-        }}
-      />
-    </div>
+    <SupportProvider>
+      {children}
+    </SupportProvider>
   );
 }
 ```
 
-### Ticket Filters
+### Using Context Hooks
 
 ```typescript
+'use client';
+
 import { useSupportContext } from '@djangocfg/ext-support/hooks';
 
-function TicketFilters() {
-  const { tickets, filterTickets } = useSupportContext();
+function MyTicketList() {
+  const {
+    tickets,
+    isLoadingTickets,
+    createTicket,
+    refreshTickets
+  } = useSupportContext();
 
-  const handleFilter = (status: string) => {
-    filterTickets({ status });
+  const handleCreate = async () => {
+    await createTicket({
+      subject: 'New ticket',
+      message: 'Description here',
+    });
+    await refreshTickets();
   };
 
+  if (isLoadingTickets) return <div>Loading...</div>;
+
   return (
     <div>
-      <button onClick={() => handleFilter('open')}>
-        Open ({tickets.filter(t => t.status === 'open').length})
-      </button>
-      <button onClick={() => handleFilter('in_progress')}>
-        In Progress ({tickets.filter(t => t.status === 'in_progress').length})
-      </button>
-      <button onClick={() => handleFilter('resolved')}>
-        Resolved ({tickets.filter(t => t.status === 'resolved').length})
-      </button>
+      <button onClick={handleCreate}>Create Ticket</button>
+      {tickets?.map(ticket => (
+        <div key={ticket.uuid}>
+          <h3>{ticket.subject}</h3>
+          <span>Status: {ticket.status}</span>
+        </div>
+      ))}
     </div>
   );
 }
@@ -199,38 +135,69 @@ function TicketFilters() {
 
 ## API Reference
 
-### Support Context
+### SupportContext
 
-- `tickets` - List of all tickets
-- `createTicket(data)` - Create new ticket
-- `updateTicket(id, data)` - Update ticket
-- `deleteTicket(id)` - Delete ticket
-- `getTicketById(id)` - Get ticket details
-- `addComment(ticketId, data)` - Add comment to ticket
-- `assignTicket(ticketId, agentId)` - Assign ticket to agent
-- `closeTicket(id)` - Close ticket
-- `reopenTicket(id)` - Reopen closed ticket
-- `filterTickets(filters)` - Filter tickets by criteria
-- `isLoadingTickets` - Loading state
-- `isCreatingTicket` - Creation state
+```typescript
+interface SupportContextValue {
+  // Tickets
+  tickets: Ticket[] | undefined;
+  isLoadingTickets: boolean;
+  ticketsError: Error | undefined;
+  refreshTickets: () => Promise<void>;
+
+  // Ticket operations
+  getTicket: (uuid: string) => Promise<Ticket | undefined>;
+  createTicket: (data: TicketRequest) => Promise<Ticket>;
+  updateTicket: (uuid: string, data: TicketRequest) => Promise<Ticket>;
+  partialUpdateTicket: (uuid: string, data: PatchedTicketRequest) => Promise<Ticket>;
+  deleteTicket: (uuid: string) => Promise<void>;
+
+  // Messages
+  getMessages: (ticketUuid: string) => Promise<Message[] | undefined>;
+  createMessage: (ticketUuid: string, data: MessageCreateRequest) => Promise<Message>;
+  updateMessage: (ticketUuid: string, messageUuid: string, data: MessageRequest) => Promise<Message>;
+  deleteMessage: (ticketUuid: string, messageUuid: string) => Promise<void>;
+  refreshMessages: (ticketUuid: string) => Promise<void>;
+}
+```
 
-## Ticket Properties
+### Ticket Type
 
 ```typescript
 interface Ticket {
-  id: string;
+  uuid: string;
   subject: string;
-  description: string;
   status: 'open' | 'in_progress' | 'resolved' | 'closed';
-  priority: 'low' | 'medium' | 'high' | 'urgent';
-  category: string;
-  assigned_to?: string;
   created_at: string;
   updated_at: string;
-  comments?: Comment[];
 }
 ```
 
+### TicketRequest Type
+
+```typescript
+interface TicketRequest {
+  subject: string;
+  message: string;
+}
+```
+
+## Exports
+
+```typescript
+// Main layout (includes all UI)
+import { SupportLayout } from '@djangocfg/ext-support';
+
+// Hooks and context
+import {
+  SupportProvider,
+  useSupportContext
+} from '@djangocfg/ext-support/hooks';
+
+// Server-safe config
+import { extensionConfig } from '@djangocfg/ext-support/config';
+```
+
 ## License
 
 MIT

package/dist/config.cjs

@@ -27,7 +27,7 @@ var import_ext_base = require("@djangocfg/ext-base");
 // package.json
 var package_default = {
   name: "@djangocfg/ext-support",
-  version: "1.0.14",
+  version: "1.0.19",
   description: "Support ticket system extension for DjangoCFG",
   keywords: [
     "django",
@@ -95,9 +95,10 @@ var package_default = {
     next: "^16",
     "p-retry": "^7.0.0",
     react: "^19",
-    "react-hook-form": "7.65.0",
+    "react-hook-form": "^7.69.0",
+    "@hookform/resolvers": "^5.2.2",
     swr: "^2.3.7",
-    zod: "^4.1.13"
+    zod: "^4.3.4"
   },
   devDependencies: {
     "@djangocfg/api": "workspace:*",

package/dist/config.js

@@ -4,7 +4,7 @@ import { createExtensionConfig } from "@djangocfg/ext-base";
 // package.json
 var package_default = {
   name: "@djangocfg/ext-support",
-  version: "1.0.14",
+  version: "1.0.19",
   description: "Support ticket system extension for DjangoCFG",
   keywords: [
     "django",
@@ -72,9 +72,10 @@ var package_default = {
     next: "^16",
     "p-retry": "^7.0.0",
     react: "^19",
-    "react-hook-form": "7.65.0",
+    "react-hook-form": "^7.69.0",
+    "@hookform/resolvers": "^5.2.2",
     swr: "^2.3.7",
-    zod: "^4.1.13"
+    zod: "^4.3.4"
   },
   devDependencies: {
     "@djangocfg/api": "workspace:*",

package/dist/hooks.cjs

@@ -892,7 +892,7 @@ var MessageSchema = zod.z.object({
   sender: SenderSchema,
   is_from_author: zod.z.boolean(),
   text: zod.z.string(),
-  created_at: zod.z.iso.datetime()
+  created_at: zod.z.string().datetime({ offset: true })
 });
 var MessageCreateSchema = zod.z.object({
   text: zod.z.string()
@@ -919,7 +919,7 @@ var TicketSchema = zod.z.object({
   user: zod.z.int(),
   subject: zod.z.string().max(255),
   status: zod.z.nativeEnum(TicketStatus).optional(),
-  created_at: zod.z.iso.datetime(),
+  created_at: zod.z.string().datetime({ offset: true }),
   unanswered_messages_count: zod.z.int()
 });
 
@@ -2656,7 +2656,7 @@ var SupportLayout = () => {
 // package.json
 var package_default = {
   name: "@djangocfg/ext-support",
-  version: "1.0.14",
+  version: "1.0.19",
   description: "Support ticket system extension for DjangoCFG",
   keywords: [
     "django",
@@ -2724,9 +2724,10 @@ var package_default = {
     next: "^16",
     "p-retry": "^7.0.0",
     react: "^19",
-    "react-hook-form": "7.65.0",
+    "react-hook-form": "^7.69.0",
+    "@hookform/resolvers": "^5.2.2",
     swr: "^2.3.7",
-    zod: "^4.1.13"
+    zod: "^4.3.4"
   },
   devDependencies: {
     "@djangocfg/api": "workspace:*",

package/dist/hooks.js

@@ -882,7 +882,7 @@ var MessageSchema = z.object({
   sender: SenderSchema,
   is_from_author: z.boolean(),
   text: z.string(),
-  created_at: z.iso.datetime()
+  created_at: z.string().datetime({ offset: true })
 });
 var MessageCreateSchema = z.object({
   text: z.string()
@@ -909,7 +909,7 @@ var TicketSchema = z.object({
   user: z.int(),
   subject: z.string().max(255),
   status: z.nativeEnum(TicketStatus).optional(),
-  created_at: z.iso.datetime(),
+  created_at: z.string().datetime({ offset: true }),
   unanswered_messages_count: z.int()
 });
 
@@ -2646,7 +2646,7 @@ var SupportLayout = () => {
 // package.json
 var package_default = {
   name: "@djangocfg/ext-support",
-  version: "1.0.14",
+  version: "1.0.19",
   description: "Support ticket system extension for DjangoCFG",
   keywords: [
     "django",
@@ -2714,9 +2714,10 @@ var package_default = {
     next: "^16",
     "p-retry": "^7.0.0",
     react: "^19",
-    "react-hook-form": "7.65.0",
+    "react-hook-form": "^7.69.0",
+    "@hookform/resolvers": "^5.2.2",
     swr: "^2.3.7",
-    zod: "^4.1.13"
+    zod: "^4.3.4"
   },
   devDependencies: {
     "@djangocfg/api": "workspace:*",

package/dist/index.cjs

@@ -892,7 +892,7 @@ var MessageSchema = zod.z.object({
   sender: SenderSchema,
   is_from_author: zod.z.boolean(),
   text: zod.z.string(),
-  created_at: zod.z.iso.datetime()
+  created_at: zod.z.string().datetime({ offset: true })
 });
 var MessageCreateSchema = zod.z.object({
   text: zod.z.string()
@@ -919,7 +919,7 @@ var TicketSchema = zod.z.object({
   user: zod.z.int(),
   subject: zod.z.string().max(255),
   status: zod.z.nativeEnum(TicketStatus).optional(),
-  created_at: zod.z.iso.datetime(),
+  created_at: zod.z.string().datetime({ offset: true }),
   unanswered_messages_count: zod.z.int()
 });
 
@@ -2656,7 +2656,7 @@ var SupportLayout = () => {
 // package.json
 var package_default = {
   name: "@djangocfg/ext-support",
-  version: "1.0.14",
+  version: "1.0.19",
   description: "Support ticket system extension for DjangoCFG",
   keywords: [
     "django",
@@ -2724,9 +2724,10 @@ var package_default = {
     next: "^16",
     "p-retry": "^7.0.0",
     react: "^19",
-    "react-hook-form": "7.65.0",
+    "react-hook-form": "^7.69.0",
+    "@hookform/resolvers": "^5.2.2",
     swr: "^2.3.7",
-    zod: "^4.1.13"
+    zod: "^4.3.4"
   },
   devDependencies: {
     "@djangocfg/api": "workspace:*",

package/dist/index.d.cts

@@ -670,7 +670,7 @@ declare const MessageSchema: z.ZodObject<{
     }, z.core.$strip>;
     is_from_author: z.ZodBoolean;
     text: z.ZodString;
-    created_at: z.ZodISODateTime;
+    created_at: z.ZodString;
 }, z.core.$strip>;
 /**
  * Infer TypeScript type from Zod schema
@@ -748,7 +748,7 @@ declare const PaginatedMessageListSchema: z.ZodObject<{
         }, z.core.$strip>;
         is_from_author: z.ZodBoolean;
         text: z.ZodString;
-        created_at: z.ZodISODateTime;
+        created_at: z.ZodString;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 /**
@@ -770,7 +770,7 @@ declare const PaginatedTicketListSchema: z.ZodObject<{
         user: z.ZodInt;
         subject: z.ZodString;
         status: z.ZodOptional<z.ZodEnum<typeof TicketStatus>>;
-        created_at: z.ZodISODateTime;
+        created_at: z.ZodString;
         unanswered_messages_count: z.ZodInt;
     }, z.core.$strip>>;
 }, z.core.$strip>;
@@ -840,7 +840,7 @@ declare const TicketSchema: z.ZodObject<{
     user: z.ZodInt;
     subject: z.ZodString;
     status: z.ZodOptional<z.ZodEnum<typeof TicketStatus>>;
-    created_at: z.ZodISODateTime;
+    created_at: z.ZodString;
     unanswered_messages_count: z.ZodInt;
 }, z.core.$strip>;
 /**

package/dist/index.d.ts

@@ -670,7 +670,7 @@ declare const MessageSchema: z.ZodObject<{
     }, z.core.$strip>;
     is_from_author: z.ZodBoolean;
     text: z.ZodString;
-    created_at: z.ZodISODateTime;
+    created_at: z.ZodString;
 }, z.core.$strip>;
 /**
  * Infer TypeScript type from Zod schema
@@ -748,7 +748,7 @@ declare const PaginatedMessageListSchema: z.ZodObject<{
         }, z.core.$strip>;
         is_from_author: z.ZodBoolean;
         text: z.ZodString;
-        created_at: z.ZodISODateTime;
+        created_at: z.ZodString;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 /**
@@ -770,7 +770,7 @@ declare const PaginatedTicketListSchema: z.ZodObject<{
         user: z.ZodInt;
         subject: z.ZodString;
         status: z.ZodOptional<z.ZodEnum<typeof TicketStatus>>;
-        created_at: z.ZodISODateTime;
+        created_at: z.ZodString;
         unanswered_messages_count: z.ZodInt;
     }, z.core.$strip>>;
 }, z.core.$strip>;
@@ -840,7 +840,7 @@ declare const TicketSchema: z.ZodObject<{
     user: z.ZodInt;
     subject: z.ZodString;
     status: z.ZodOptional<z.ZodEnum<typeof TicketStatus>>;
-    created_at: z.ZodISODateTime;
+    created_at: z.ZodString;
     unanswered_messages_count: z.ZodInt;
 }, z.core.$strip>;
 /**

package/dist/index.js

@@ -882,7 +882,7 @@ var MessageSchema = z.object({
   sender: SenderSchema,
   is_from_author: z.boolean(),
   text: z.string(),
-  created_at: z.iso.datetime()
+  created_at: z.string().datetime({ offset: true })
 });
 var MessageCreateSchema = z.object({
   text: z.string()
@@ -909,7 +909,7 @@ var TicketSchema = z.object({
   user: z.int(),
   subject: z.string().max(255),
   status: z.nativeEnum(TicketStatus).optional(),
-  created_at: z.iso.datetime(),
+  created_at: z.string().datetime({ offset: true }),
   unanswered_messages_count: z.int()
 });
 
@@ -2646,7 +2646,7 @@ var SupportLayout = () => {
 // package.json
 var package_default = {
   name: "@djangocfg/ext-support",
-  version: "1.0.14",
+  version: "1.0.19",
   description: "Support ticket system extension for DjangoCFG",
   keywords: [
     "django",
@@ -2714,9 +2714,10 @@ var package_default = {
     next: "^16",
     "p-retry": "^7.0.0",
     react: "^19",
-    "react-hook-form": "7.65.0",
+    "react-hook-form": "^7.69.0",
+    "@hookform/resolvers": "^5.2.2",
     swr: "^2.3.7",
-    zod: "^4.1.13"
+    zod: "^4.3.4"
   },
   devDependencies: {
     "@djangocfg/api": "workspace:*",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/ext-support",
-  "version": "1.0.14",
+  "version": "1.0.19",
   "description": "Support ticket system extension for DjangoCFG",
   "keywords": [
     "django",
@@ -59,24 +59,25 @@
     "check": "tsc --noEmit"
   },
   "peerDependencies": {
-    "@djangocfg/api": "^2.1.107",
-    "@djangocfg/ext-base": "^1.0.9",
-    "@djangocfg/ui-core": "^2.1.107",
+    "@djangocfg/api": "^2.1.109",
+    "@djangocfg/ext-base": "^1.0.14",
+    "@djangocfg/ui-core": "^2.1.109",
     "consola": "^3.4.2",
     "lucide-react": "^0.545.0",
     "moment": "^2.30.1",
     "next": "^16",
     "p-retry": "^7.0.0",
     "react": "^19",
-    "react-hook-form": "7.65.0",
+    "react-hook-form": "^7.69.0",
+    "@hookform/resolvers": "^5.2.2",
     "swr": "^2.3.7",
-    "zod": "^4.1.13"
+    "zod": "^4.3.4"
   },
   "devDependencies": {
-    "@djangocfg/api": "^2.1.107",
-    "@djangocfg/ext-base": "^1.0.9",
-    "@djangocfg/ui-core": "^2.1.107",
-    "@djangocfg/typescript-config": "^2.1.107",
+    "@djangocfg/api": "^2.1.109",
+    "@djangocfg/ext-base": "^1.0.14",
+    "@djangocfg/ui-core": "^2.1.109",
+    "@djangocfg/typescript-config": "^2.1.109",
     "@types/node": "^24.7.2",
     "@types/react": "^19.0.0",
     "consola": "^3.4.2",

package/src/api/generated/ext_support/_utils/schemas/Message.schema.ts

@@ -12,7 +12,7 @@ export const MessageSchema = z.object({
   sender: SenderSchema,
   is_from_author: z.boolean(),
   text: z.string(),
-  created_at: z.iso.datetime(),
+  created_at: z.string().datetime({ offset: true }),
 })
 
 /**

package/src/api/generated/ext_support/_utils/schemas/Ticket.schema.ts

@@ -11,7 +11,7 @@ export const TicketSchema = z.object({
   user: z.int(),
   subject: z.string().max(255),
   status: z.nativeEnum(Enums.TicketStatus).optional(),
-  created_at: z.iso.datetime(),
+  created_at: z.string().datetime({ offset: true }),
   unanswered_messages_count: z.int(),
 })
 

package/src/config.ts

@@ -4,6 +4,7 @@
 
 import { createExtensionConfig } from '@djangocfg/ext-base';
 
+// @ts-ignore - package.json is not typed
 import packageJson from '../package.json';
 
 export const extensionConfig = createExtensionConfig(packageJson, {