@smartsides/oracle-ebs-sdk 1.0.0

package/LICENSE

@@ -0,0 +1,17 @@
+PROPRIETARY LICENSE
+
+Copyright (c) 2026 SmartSides Development Team
+
+All rights reserved.
+
+This software and associated documentation files (the "Software") are the proprietary 
+property of SmartSides Development Team. The Software is confidential and may not be 
+copied, distributed, or disclosed to third parties without express written permission 
+from SmartSides Development Team.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, 
+INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A 
+PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT 
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION 
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE 
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,314 @@
+# @smartsides/oracle-ebs-sdk
+
+TypeScript SDK for Oracle EBS API - Optimized for Next.js 15+
+
+## Features
+
+- ✅ **Full TypeScript Support** - Complete type safety with autocomplete
+- ✅ **All API Endpoints** - 9 modules covering all Oracle EBS functionality
+- ✅ **Error Handling** - Typed errors with automatic retry logic
+- ✅ **React Query Integration** - Built-in hooks for Next.js
+- ✅ **Server Components** - Optimized for Next.js App Router
+- ✅ **Logging & Monitoring** - Configurable logging system
+- ✅ **Caching** - Built-in request caching
+
+## Installation
+
+```bash
+npm install @smartsides/oracle-ebs-sdk
+# or
+yarn add @smartsides/oracle-ebs-sdk
+# or
+pnpm add @smartsides/oracle-ebs-sdk
+```
+
+## Quick Start
+
+### Basic Usage
+
+```typescript
+import { OracleEBSClient } from '@smartsides/oracle-ebs-sdk';
+
+const client = new OracleEBSClient({
+  baseUrl: 'http://localhost:3000/api/v1',
+  logging: { enabled: true },
+});
+
+// Login
+const { access_token } = await client.auth.login({
+  username: 'your-username',
+  password: 'your-password',
+});
+
+// Get leave types
+const types = await client.leaves.getRestrictedTypes();
+
+// Create leave request
+const request = await client.leaves.createRequest({
+  absenceTypeId: '71',
+  startDate: '2026-01-20',
+  endDate: '2026-01-22',
+  days: 3,
+  comments: 'Family vacation',
+});
+```
+
+### Next.js App Router (Client Component)
+
+```typescript
+'use client';
+
+import { OracleEBSClient } from '@smartsides/oracle-ebs-sdk';
+import { useLeaveTypes } from '@smartsides/oracle-ebs-sdk/hooks';
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
+
+const client = new OracleEBSClient({
+  baseUrl: process.env.NEXT_PUBLIC_API_URL!,
+});
+
+const queryClient = new QueryClient();
+
+export default function LeavesPage() {
+  return (
+    <QueryClientProvider client={queryClient}>
+      <LeavesList />
+    </QueryClientProvider>
+  );
+}
+
+function LeavesList() {
+  const { data, isLoading, error } = useLeaveTypes(client);
+
+  if (isLoading) return <div>Loading...</div>;
+  if (error) return <div>Error: {error.message}</div>;
+
+  return (
+    <ul>
+      {data?.absenceTypes.map((type) => (
+        <li key={type.absenceAttendanceTypeId}>{type.name}</li>
+      ))}
+    </ul>
+  );
+}
+```
+
+### Next.js Server Components
+
+```typescript
+import { createServerClient } from '@smartsides/oracle-ebs-sdk/server';
+
+export default async function Page() {
+  const client = createServerClient({
+    baseUrl: process.env.API_URL!,
+    token: process.env.API_TOKEN,
+  });
+
+  const leaves = await client.leaves.getHistory();
+
+  return (
+    <div>
+      <h1>Leave History</h1>
+      {leaves.leaveHistory.map((leave) => (
+        <div key={leave.transactionId}>
+          {leave.leaveTypeName}: {leave.startDate} - {leave.endDate}
+        </div>
+      ))}
+    </div>
+  );
+}
+```
+
+## API Modules
+
+### Authentication
+
+```typescript
+// Login
+await client.auth.login({ username, password });
+
+// Get user context
+const user = await client.auth.getUserContext();
+
+// Logout
+await client.auth.logout();
+```
+
+### Leaves & Absences
+
+```typescript
+// Get absence types
+const types = await client.leaves.getRestrictedTypes();
+
+// Get leave history
+const history = await client.leaves.getHistory();
+
+// Create leave request
+const request = await client.leaves.createRequest({
+  absenceTypeId: '71',
+  startDate: '2026-01-20',
+  endDate: '2026-01-22',
+  days: 3,
+});
+```
+
+### SIT Requests
+
+```typescript
+// Get segments
+const segments = await client.sitRequests.getSegments({ idFlexNum: '50496' });
+
+// Save and preview
+const preview = await client.sitRequests.saveAndPreview(data);
+
+// Submit
+const result = await client.sitRequests.submit(data);
+```
+
+### Notifications
+
+```typescript
+// Get notifications
+const notifications = await client.notifications.getList();
+
+// Get details
+const details = await client.notifications.getDetails({ notificationId: '123' });
+
+// Process approval
+await client.notifications.processApproval({
+  notificationId: '123',
+  action: 'APPROVE',
+});
+```
+
+### Payslip
+
+```typescript
+// Get header
+const header = await client.payslip.getHeader({ periodName: '6 2025' });
+
+// Get details
+const details = await client.payslip.getDetails({ periodName: '6 2025' });
+```
+
+### Employee
+
+```typescript
+// Get personal info
+const info = await client.employee.getPersonalInfo();
+
+// Get hierarchy
+const hierarchy = await client.employee.getHierarchy();
+```
+
+### Forms
+
+```typescript
+// Get table columns
+const columns = await client.forms.getTableColumns({ tableName: 'HR_EMPLOYEES' });
+
+// Get DFF segments
+const segments = await client.forms.getDffSegments({
+  applicationId: '800',
+  flexfieldName: 'PER_PEOPLE_EXTRA_INFO',
+});
+```
+
+### Health
+
+```typescript
+// Check health
+const health = await client.health.check();
+
+// Ping
+const message = await client.health.ping();
+```
+
+## Error Handling
+
+```typescript
+import {
+  ValidationError,
+  UnauthorizedError,
+  NetworkError,
+} from '@smartsides/oracle-ebs-sdk';
+
+try {
+  await client.leaves.createRequest(data);
+} catch (error) {
+  if (error instanceof ValidationError) {
+    console.error('Validation failed:', error.fields);
+  } else if (error instanceof UnauthorizedError) {
+    // Redirect to login
+    router.push('/login');
+  } else if (error instanceof NetworkError) {
+    // Show retry button
+    console.error('Network error:', error.message);
+  }
+}
+```
+
+## Configuration
+
+```typescript
+const client = new OracleEBSClient({
+  baseUrl: 'http://localhost:3000/api/v1',
+  token: 'your-jwt-token', // Optional
+  timeout: 30000, // 30 seconds
+  retries: 3,
+  retryDelay: 1000,
+  cache: {
+    enabled: true,
+    ttl: 300, // 5 minutes
+  },
+  logging: {
+    enabled: true,
+    level: 'info',
+  },
+  onError: (error) => {
+    console.error('API Error:', error);
+  },
+});
+```
+
+## React Query Hooks
+
+All hooks are available from `@smartsides/oracle-ebs-sdk/hooks`:
+
+- `useLogin(client, options)`
+- `useUserContext(client, options)`
+- `useLeaveTypes(client, params, options)`
+- `useLeaveHistory(client, options)`
+- `useCreateLeaveRequest(client, options)`
+- `useSitSegments(client, params, options)`
+- `useNotifications(client, options)`
+- `usePayslipHeader(client, params, options)`
+- `usePersonalInfo(client, options)`
+- `useHealthCheck(client, options)`
+- And more...
+
+## Server Helpers
+
+```typescript
+import {
+  createServerClient,
+  createServerClientFromCookies,
+  createServerClientFromHeaders,
+} from '@smartsides/oracle-ebs-sdk/server';
+
+// Basic server client
+const client = createServerClient({ baseUrl, token });
+
+// From cookies
+const client = createServerClientFromCookies(cookies());
+
+// From headers
+const client = createServerClientFromHeaders(headers());
+```
+
+## License
+
+PROPRIETARY - SmartSides Development Team
+
+## Support
+
+For support, please contact the development team.