@eventuras/core-nextjs 0.1.3

package/README.md

@@ -0,0 +1,77 @@
+# @eventuras/core-nextjs
+
+Core Next.js utilities for Eventuras applications.
+
+## Features
+
+### Server Action Utilities
+
+Standardized types and helpers for Next.js server actions with proper success/error handling.
+
+#### Usage
+
+```typescript
+'use server';
+
+import { 
+  ServerActionResult, 
+  actionSuccess, 
+  actionError 
+} from '@eventuras/core-nextjs/actions';
+
+export async function createEvent(
+  formData: FormData
+): Promise<ServerActionResult<{ eventId: number }>> {
+  try {
+    const event = await api.createEvent(...);
+    return actionSuccess({ eventId: event.id }, 'Event created successfully!');
+  } catch (error) {
+    return actionError('Failed to create event', 'CREATE_FAILED');
+  }
+}
+```
+
+#### Client-side usage
+
+```typescript
+'use client';
+
+import { useToast } from '@eventuras/ratio-ui/toast';
+import { createEvent } from './actions';
+
+export function EventForm() {
+  const toast = useToast();
+
+  const handleSubmit = async (formData: FormData) => {
+    const result = await createEvent(formData);
+    
+    if (result.success) {
+      toast.success(result.message || 'Success!');
+      // Access typed data
+      console.log(result.data.eventId);
+    } else {
+      toast.error(result.error.message);
+    }
+  };
+
+  return <form action={handleSubmit}>...</form>;
+}
+```
+
+#### Available Types & Functions
+
+- `ServerActionResult<T>` - Discriminated union for success/error
+- `ServerActionSuccess<T>` - Success type with data
+- `ServerActionError` - Error type with message, code, details
+- `actionSuccess(data, message?)` - Helper to create success result
+- `actionError(message, code?, details?)` - Helper to create error result
+
+## Development
+
+```bash
+# Build the library
+pnpm build
+
+# Watch mode for development
+pnpm dev
+```

package/dist/actions/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Server action utilities
+ * @module actions
+ */
+export type { ServerActionSuccess, ServerActionError, ServerActionResult, } from './serverAction.js';
+export { actionSuccess, actionError } from './serverAction.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/actions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/actions/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/actions/index.js

@@ -0,0 +1,28 @@
+//#region src/actions/serverAction.ts
+/**
+* Helper to create a success result
+*/
+function actionSuccess(data, message) {
+	return {
+		success: true,
+		data,
+		message
+	};
+}
+/**
+* Helper to create an error result
+*/
+function actionError(message, code, details) {
+	return {
+		success: false,
+		error: {
+			message,
+			code,
+			details
+		}
+	};
+}
+//#endregion
+export { actionError, actionSuccess };
+
+//# sourceMappingURL=index.js.map

package/dist/actions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/actions/serverAction.ts"],"sourcesContent":["/**\n * Common types for server actions\n *\n * Provides a standardized interface for server action responses\n * that supports both success and error states with proper typing.\n */\n\n/**\n * Success result from a server action\n */\nexport type ServerActionSuccess<T = void> = {\n  success: true;\n  data: T;\n  message?: string;\n};\n\n/**\n * Error result from a server action\n */\nexport type ServerActionError = {\n  success: false;\n  error: {\n    message: string;\n    code?: string;\n    details?: unknown;\n  };\n};\n\n/**\n * Result type for server actions that can succeed or fail\n *\n * @example\n * // In server action\n * export async function createEvent(formData: FormData): Promise<ServerActionResult<{ eventId: number }>> {\n *   try {\n *     const event = await api.createEvent(...);\n *     return { success: true, data: { eventId: event.id } };\n *   } catch (error) {\n *     return { success: false, error: { message: 'Failed to create event' } };\n *   }\n * }\n *\n * // In client component\n * const result = await createEvent(formData);\n * if (result.success) {\n *   toast.success('Event created!');\n *   router.push(`/admin/events/${result.data.eventId}`);\n * } else {\n *   toast.error(result.error.message);\n * }\n */\nexport type ServerActionResult<T = void> = ServerActionSuccess<T> | ServerActionError;\n\n/**\n * Helper to create a success result\n */\nexport function actionSuccess<T>(data: T, message?: string): ServerActionSuccess<T> {\n  return { success: true, data, message };\n}\n\n/**\n * Helper to create an error result\n */\nexport function actionError(message: string, code?: string, details?: unknown): ServerActionError {\n  return {\n    success: false,\n    error: { message, code, details },\n  };\n}\n"],"mappings":";;;;AAwDA,SAAgB,cAAiB,MAAS,SAA0C;CAClF,OAAO;EAAE,SAAS;EAAM;EAAM;CAAQ;AACxC;;;;AAKA,SAAgB,YAAY,SAAiB,MAAe,SAAsC;CAChG,OAAO;EACL,SAAS;EACT,OAAO;GAAE;GAAS;GAAM;EAAQ;CAClC;AACF"}

package/dist/actions/serverAction.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Common types for server actions
+ *
+ * Provides a standardized interface for server action responses
+ * that supports both success and error states with proper typing.
+ */
+/**
+ * Success result from a server action
+ */
+export type ServerActionSuccess<T = void> = {
+    success: true;
+    data: T;
+    message?: string;
+};
+/**
+ * Error result from a server action
+ */
+export type ServerActionError = {
+    success: false;
+    error: {
+        message: string;
+        code?: string;
+        details?: unknown;
+    };
+};
+/**
+ * Result type for server actions that can succeed or fail
+ *
+ * @example
+ * // In server action
+ * export async function createEvent(formData: FormData): Promise<ServerActionResult<{ eventId: number }>> {
+ *   try {
+ *     const event = await api.createEvent(...);
+ *     return { success: true, data: { eventId: event.id } };
+ *   } catch (error) {
+ *     return { success: false, error: { message: 'Failed to create event' } };
+ *   }
+ * }
+ *
+ * // In client component
+ * const result = await createEvent(formData);
+ * if (result.success) {
+ *   toast.success('Event created!');
+ *   router.push(`/admin/events/${result.data.eventId}`);
+ * } else {
+ *   toast.error(result.error.message);
+ * }
+ */
+export type ServerActionResult<T = void> = ServerActionSuccess<T> | ServerActionError;
+/**
+ * Helper to create a success result
+ */
+export declare function actionSuccess<T>(data: T, message?: string): ServerActionSuccess<T>;
+/**
+ * Helper to create an error result
+ */
+export declare function actionError(message: string, code?: string, details?: unknown): ServerActionError;
+//# sourceMappingURL=serverAction.d.ts.map

package/dist/actions/serverAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverAction.d.ts","sourceRoot":"","sources":["../../src/actions/serverAction.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,GAAG,IAAI,IAAI;IAC1C,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,CAAC,CAAC;IACR,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE;QACL,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;CACH,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,GAAG,IAAI,IAAI,mBAAmB,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC;AAEtF;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAElF;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,iBAAiB,CAKhG"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Core Next.js utilities for Eventuras
+ * @packageDocumentation
+ *
+ * Import utilities from specific submodules:
+ * - @eventuras/core-nextjs/actions
+ */
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@eventuras/core-nextjs",
+  "version": "0.1.3",
+  "description": "Core Next.js utilities for Eventuras",
+  "homepage": "https://github.com/losol/origo/tree/main/packages/core-nextjs#readme",
+  "bugs": {
+    "url": "https://github.com/losol/origo/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/losol/origo.git",
+    "directory": "packages/core-nextjs"
+  },
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    "./actions": {
+      "types": "./dist/actions/index.d.ts",
+      "import": "./dist/actions/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "next": "16.2.9",
+    "react": "^19.2.5",
+    "vite": "^8.1.0",
+    "@eventuras/eslint-config": "1.0.3",
+    "@eventuras/typescript-config": "1.0.0",
+    "@eventuras/vite-config": "0.2.2"
+  },
+  "peerDependencies": {
+    "next": "^16.0.0",
+    "react": "^19.0.0"
+  },
+  "scripts": {
+    "build": "vite build",
+    "dev": "vite build --watch",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  }
+}