order3000 0.2.0 → 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Kolaveri Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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

@@ -1,9 +1,262 @@
-# order3000-nodejs
+# Order3000 Node.js SDK
 
-node.js sdk to interact with order3000.
+A TypeScript-first Node.js SDK for integrating with the Order3000 restaurant management platform. This SDK provides a simple, type-safe interface for managing orders, reservations, and other restaurant operations through the Order3000 API.
 
-## New release
+## Overview
 
-If you want to release a new version for this package simply create a new changeset and describe the changes that have been included in the new release.
+Order3000 is a comprehensive restaurant management platform that handles orders, reservations, customer management, and more. This SDK allows external applications and websites to integrate seamlessly with Order3000 through a clean, promise-based API.
 
-It's a manual process. This project has no dependencies, so it's not possible that the update of another project will trigger a new release here.
+### Key Features
+
+- 🔐 **OAuth2 Authentication** - Secure client credentials flow with automatic token management
+- 🏢 **Multi-Tenant Support** - Built for multi-restaurant/tenant operations
+- 📝 **TypeScript Support** - Full TypeScript support with auto-generated types from OpenAPI spec
+- 🔄 **Auto Token Refresh** - Automatic token renewal with 5-minute buffer before expiration
+- 🎯 **Type-Safe API** - OpenAPI-generated types ensure type safety across all operations
+- ⚡ **Modern Architecture** - Built with ES modules and CommonJS dual support
+
+## Installation
+
+```bash
+npm install order3000
+# or
+yarn add order3000
+# or
+pnpm add order3000
+```
+
+## Quick Start
+
+```typescript
+import { Order3000Client } from 'order3000'
+
+// Initialize the client
+const client = new Order3000Client({
+  clientId: 'your-client-id',
+  clientSecret: 'your-client-secret',
+  tenantId: 'your-tenant-id', // Optional - will use default from token if not provided
+  baseUrl: 'https://api.order3000.com', // Optional - defaults to production
+})
+
+// Place an order
+const order = await client.orders.place({
+  tenantId: 'restaurant-123',
+  basketId: 'basket-456',
+  status: 'PENDING',
+  paymentMethod: 'CARD',
+  taxAmount: '2.50',
+  totalAmount: '25.00',
+  currency: 'USD',
+  orderedBy: 'customer@example.com',
+})
+
+console.log('Order placed:', order.id)
+```
+
+## Architecture
+
+### Authentication Flow
+
+The SDK uses OAuth2 client credentials flow for authentication:
+
+1. **Initial Authentication**: On first use, the SDK requests an access token using your client credentials
+2. **Token Storage**: The access token is stored in memory with its expiration time
+3. **Automatic Refresh**: Tokens are automatically refreshed 5 minutes before expiration
+4. **Tenant Resolution**: If no tenant ID is provided, the SDK extracts the default tenant from the JWT token
+
+### Project Structure
+
+```
+order3000-nodejs/
+├── src/
+│   ├── client.ts           # Main client class and initialization
+│   ├── token-manager.ts    # OAuth2 token management and refresh logic
+│   ├── resources/
+│   │   ├── index.ts        # Base resource class for API calls
+│   │   └── orders.ts       # Orders resource implementation
+│   └── types/
+│       ├── index.ts        # Type exports
+│       └── generated.d.ts  # Auto-generated types from OpenAPI spec
+├── scripts/
+│   ├── dev.sh             # Development script with Vault integration
+│   └── vaultcar.sh        # HashiCorp Vault integration for secrets
+└── package.json
+```
+
+## Configuration
+
+### Client Options
+
+```typescript
+interface Order3000ClientConfig {
+  clientId: string // OAuth2 client ID (required)
+  clientSecret: string // OAuth2 client secret (required)
+  tenantId?: string // Specific tenant ID (optional)
+  baseUrl?: string // Base URL for API requests (default: https://order3000.com/api)
+  tokenUrl?: string // OAuth2 token endpoint (default: ${baseUrl}/auth/token)
+}
+```
+
+### Environment Variables
+
+For development, you can use environment variables:
+
+```bash
+ORDER3000_CLIENT_ID=your-client-id
+ORDER3000_CLIENT_SECRET=your-client-secret
+ORDER3000_BASE_URL=https://api.order3000.com
+```
+
+## API Documentation
+
+For complete API documentation including all available endpoints, request/response schemas, and interactive examples, visit:
+
+- **Development**: http://localhost:3000/developers/reference
+- **Staging**: https://order3000.kolaveri.co/developers/reference
+- **Production**: https://order3000.com/developers/reference
+
+The API documentation is powered by Scalar and provides a comprehensive view of all available endpoints, schemas, and integration examples.
+
+## SDK Development Workflow
+
+### Adding New API Endpoints
+
+When new endpoints are added or modified in the Order3000 platform, follow this workflow to update the SDK:
+
+1. **Define API Contracts**: Create or update TypeScript contracts that define the API structure
+
+   - Add/modify contracts in `/apps/order3000/src/app/api/openapi/contracts/`
+   - Use `@ts-rest/core` to define type-safe contracts
+   - Export contracts from `/apps/order3000/src/app/api/openapi/contract.ts`
+   - Generate OpenAPI spec to preview changes: `npx nx run order3000:generate-openapi`
+   - View updated docs at http://localhost:3000/developers/reference
+
+2. **Implement API Endpoints**: Create the actual endpoint logic in the Order3000 application
+
+   - Implement handlers in `/apps/order3000/src/app/api/` following the contract definitions
+   - Ensure endpoints match the contracts exactly
+
+3. **Update SDK Resources**: Integrate the new endpoints into the SDK
+
+   - Create or update resource classes in `/apps/order3000-nodejs/src/resources/`
+   - Follow the existing pattern extending from `BaseResource`
+   - Export new resources from the main `Order3000Client` class
+   - Note: Type generation (`npm run build:types`) is handled automatically by CI/CD
+
+4. **Create Changeset**: Document the changes
+
+   ```bash
+   pnpm changeset
+   ```
+
+   - Select `order3000` package
+   - Choose version bump type (patch/minor/major)
+   - Describe the new endpoints or changes added
+
+5. **CI/CD Pipeline**: The automated pipeline handles the rest
+   - Generates types from OpenAPI spec automatically
+   - Builds the SDK package with `pkgroll`
+   - Runs tests and type checking
+   - Publishes to npm registry as `order3000` package
+   - Updates version numbers based on changeset
+
+### Local Development
+
+```bash
+# Generate types from OpenAPI spec
+npm run build:types
+
+# Build the package locally
+npm run build
+
+# Test SDK in development mode
+npm run dev
+```
+
+### Development with Vault
+
+The SDK includes HashiCorp Vault integration for secure credential management:
+
+```bash
+# Run with Vault integration
+npm run dev
+```
+
+Credentials are fetched from:
+
+- `secret/kolaveri/thamarai/ORDER3000_CLIENT_ID`
+- `secret/kolaveri/thamarai/ORDER3000_CLIENT_SECRET`
+- `secret/kolaveri/thamarai/ORDER3000_BASE_URL`
+
+## Security Considerations
+
+1. **Never commit credentials** - Always use environment variables or secret management systems
+2. **Token Security** - Access tokens are stored in memory only, never persisted to disk
+3. **HTTPS Only** - All API calls are made over HTTPS
+4. **Automatic Token Rotation** - Tokens are refreshed automatically before expiration
+
+## Error Handling
+
+```typescript
+try {
+  const order = await client.orders.place({
+    // ... order details
+  })
+} catch (error) {
+  if (error.response?.statusCode === 401) {
+    console.error('Authentication failed - check credentials')
+  } else if (error.response?.statusCode === 400) {
+    console.error('Invalid order data:', error.response.body)
+  } else {
+    console.error('Unexpected error:', error)
+  }
+}
+```
+
+## Platform Integration
+
+### Multi-Tenant Architecture
+
+Order3000 supports multi-tenant operations where each restaurant or location is a separate tenant:
+
+- **Automatic Tenant Resolution**: If no tenant ID is provided, the SDK uses the default tenant from the authentication token
+- **Explicit Tenant Selection**: You can specify a tenant ID in the client configuration or per-request
+- **Tenant Isolation**: All operations are scoped to the specified tenant
+
+### Related Components
+
+The Order3000 platform includes:
+
+- **Reservations System**: Complete table reservation management with flexible contact preferences
+- **Customer Management**: Customer profiles with order history and preferences
+- **Order Management**: Full order lifecycle from placement to fulfillment
+- **Payment Integration**: Support for multiple payment methods
+
+## Roadmap
+
+Planned features for future releases:
+
+- [ ] Reservations API support
+- [ ] Customer management endpoints
+- [ ] Webhook support for real-time updates
+- [ ] Batch operations
+- [ ] Analytics and reporting APIs
+- [ ] Menu management
+- [ ] Table management
+
+## Contributing
+
+This SDK is part of the Kolaveri monorepo. Development follows the monorepo conventions:
+
+1. Use CVA for styling in library packages
+2. Follow TypeScript strict mode
+3. Run linting before commits: `npx nx lint order3000-nodejs`
+4. Generate types from OpenAPI spec when API changes
+
+## License
+
+Part of the Kolaveri platform - see root repository for license information.
+
+## Support
+
+For issues, questions, or feature requests related to this SDK, please contact the Order3000 development team or open an issue in the main repository.

package/dist/client.cjs

@@ -104,16 +104,39 @@ class OrdersResource extends BaseResource {
   }
 }
 
+class ReservationsResource extends BaseResource {
+  constructor(tokenManager, baseUrl) {
+    super(tokenManager, baseUrl, "/reservations");
+  }
+  /**
+   * Make a new reservation
+   * @param reservation - The reservation details
+   * @returns The created reservation with confirmation code
+   */
+  async make(reservation) {
+    return this.request("POST", "", reservation);
+  }
+  /**
+   * Get a reservation by ID
+   * @param reservationId - The reservation ID
+   * @returns The reservation details
+   */
+  async get(reservationId) {
+    return this.request("GET", `/${reservationId}`);
+  }
+}
+
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 class Order3000Client {
   constructor(config) {
     __publicField(this, "orders");
-    __publicField(this, "apiEndpoint");
+    __publicField(this, "reservations");
+    __publicField(this, "baseUrl");
     __publicField(this, "tokenManager");
-    this.apiEndpoint = config.apiEndpoint || "https://order3000.com/api";
-    const tokenUrl = config.tokenUrl || `${this.apiEndpoint}/auth/token`;
+    this.baseUrl = config.baseUrl || "https://order3000.com/api";
+    const tokenUrl = config.tokenUrl || `${this.baseUrl}/auth/token`;
     this.tokenManager = new TokenManager(
       config.clientId,
       config.clientSecret,
@@ -121,7 +144,11 @@ class Order3000Client {
       config.tenantId
     );
     console.log("refreshToken 12");
-    this.orders = new OrdersResource(this.tokenManager, this.apiEndpoint);
+    this.orders = new OrdersResource(this.tokenManager, this.baseUrl);
+    this.reservations = new ReservationsResource(
+      this.tokenManager,
+      this.baseUrl
+    );
     console.log("refreshToken 13");
     this.initialize();
     console.log("refreshToken 14");

package/dist/client.d.cts

@@ -68,6 +68,252 @@ interface components {
             updatedAt: string | null;
             updatedBy: string | null;
         };
+        /**
+         * MakeReservationRequest
+         * @description Request payload for making a new reservation
+         */
+        MakeReservationRequest: {
+            /** @description Date of the reservation in YYYY-MM-DD format */
+            reservationDate: string;
+            /** @description Time of the reservation in HH:MM:SS format */
+            reservationTime: string;
+            /** @description Number of guests in the party. Must be between 1 and 20. */
+            partySize: number;
+            /** @description Reservation duration in minutes. Defaults to 120 minutes if not specified. Range: 30-300 minutes. */
+            duration: number | null;
+            /**
+             * Format: uuid
+             * @description UUID of existing customer profile if available
+             */
+            customerId: string | null;
+            /** @description Full name of the customer making the reservation */
+            customerName: string;
+            /**
+             * Format: email
+             * @description Email address for reservation confirmations and updates
+             */
+            customerEmail?: string | null;
+            /** @description Phone number for reservation confirmations and updates. Include country code for international numbers. */
+            customerPhone?: string | null;
+            /**
+             * @description Preferred method for reservation reminders and updates
+             * @enum {string}
+             */
+            contactPreference: "email" | "phone" | "sms" | "none";
+            /**
+             * @description Origin of the reservation request
+             * @enum {string}
+             */
+            source: "website" | "phone" | "walk_in";
+            /** @description Any dietary restrictions, allergies, or special occasions (max 500 characters) */
+            specialRequests: string | null;
+            /** @description Preferred seating area or table type (e.g., "window seat", "quiet area", "patio") */
+            tablePreference: string | null;
+        };
+        /**
+         * MakeReservationResponse
+         * @description Successfully created reservation
+         */
+        MakeReservationResponse: {
+            /**
+             * Format: uuid
+             * @description Unique identifier for the reservation
+             */
+            id: string;
+            /**
+             * Format: uuid
+             * @description Restaurant/tenant identifier
+             */
+            tenantId: string;
+            /** @description Date of the reservation in YYYY-MM-DD format */
+            reservationDate: string;
+            /** @description Time of the reservation in HH:MM:SS format */
+            reservationTime: string;
+            /** @description Number of guests in the party */
+            partySize: number;
+            /** @description Reservation duration in minutes */
+            duration: number | null;
+            /**
+             * Format: uuid
+             * @description Link to customer profile if exists
+             */
+            customerId: string | null;
+            /** @description Full name of the customer */
+            customerName: string;
+            /** @description Customer email address */
+            customerEmail: string | null;
+            /** @description Customer phone number */
+            customerPhone: string | null;
+            /**
+             * @description Preferred contact method
+             * @enum {string}
+             */
+            contactPreference: "email" | "phone" | "sms" | "none";
+            /**
+             * @description Current status of the reservation
+             * @enum {string}
+             */
+            status: "pending" | "confirmed" | "arrived" | "seated" | "completed" | "cancelled" | "no_show";
+            /** @description 6-character confirmation code for the reservation */
+            confirmationCode: string | null;
+            /**
+             * Format: date-time
+             * @description When the reservation was confirmed
+             */
+            confirmedAt: string | null;
+            /**
+             * Format: date-time
+             * @description When the guest arrived
+             */
+            arrivedAt: string | null;
+            /**
+             * Format: date-time
+             * @description When the guest was seated
+             */
+            seatedAt: string | null;
+            /**
+             * Format: date-time
+             * @description When the dining was completed
+             */
+            completedAt: string | null;
+            /**
+             * Format: date-time
+             * @description When the reservation was cancelled
+             */
+            cancelledAt: string | null;
+            /**
+             * @description Who initiated the cancellation
+             * @enum {string|null}
+             */
+            cancellationReason: "customer_request" | "restaurant_request" | null;
+            /** @description Additional cancellation details */
+            cancellationNote: string | null;
+            /**
+             * @description Origin of the reservation
+             * @enum {string}
+             */
+            source: "website" | "phone" | "walk_in";
+            /** @description Any special requirements or notes */
+            specialRequests: string | null;
+            /** @description Preferred seating location */
+            tablePreference: string | null;
+            /** @description User ID who created the reservation */
+            createdBy: string;
+            /** @description User ID who last updated the reservation */
+            updatedBy: string;
+            /**
+             * Format: date-time
+             * @description Reservation creation timestamp
+             */
+            createdAt: string | null;
+            /**
+             * Format: date-time
+             * @description Last update timestamp
+             */
+            updatedAt: string | null;
+        };
+        /**
+         * ReservationDetails
+         * @description Reservation details
+         */
+        ReservationDetails: {
+            /**
+             * Format: uuid
+             * @description Unique identifier for the reservation
+             */
+            id: string;
+            /**
+             * Format: uuid
+             * @description Restaurant/tenant identifier
+             */
+            tenantId: string;
+            /** @description Date of the reservation in YYYY-MM-DD format */
+            reservationDate: string;
+            /** @description Time of the reservation in HH:MM:SS format */
+            reservationTime: string;
+            /** @description Number of guests in the party */
+            partySize: number;
+            /** @description Reservation duration in minutes */
+            duration: number | null;
+            /**
+             * Format: uuid
+             * @description Link to customer profile if exists
+             */
+            customerId: string | null;
+            /** @description Full name of the customer */
+            customerName: string;
+            /** @description Customer email address */
+            customerEmail: string | null;
+            /** @description Customer phone number */
+            customerPhone: string | null;
+            /**
+             * @description Preferred contact method
+             * @enum {string}
+             */
+            contactPreference: "email" | "phone" | "sms" | "none";
+            /**
+             * @description Current status of the reservation
+             * @enum {string}
+             */
+            status: "pending" | "confirmed" | "arrived" | "seated" | "completed" | "cancelled" | "no_show";
+            /** @description 6-character confirmation code for the reservation */
+            confirmationCode: string | null;
+            /**
+             * Format: date-time
+             * @description When the reservation was confirmed
+             */
+            confirmedAt: string | null;
+            /**
+             * Format: date-time
+             * @description When the guest arrived
+             */
+            arrivedAt: string | null;
+            /**
+             * Format: date-time
+             * @description When the guest was seated
+             */
+            seatedAt: string | null;
+            /**
+             * Format: date-time
+             * @description When the dining was completed
+             */
+            completedAt: string | null;
+            /**
+             * Format: date-time
+             * @description When the reservation was cancelled
+             */
+            cancelledAt: string | null;
+            /**
+             * @description Who initiated the cancellation
+             * @enum {string|null}
+             */
+            cancellationReason: "customer_request" | "restaurant_request" | null;
+            /** @description Additional cancellation details */
+            cancellationNote: string | null;
+            /**
+             * @description Origin of the reservation
+             * @enum {string}
+             */
+            source: "website" | "phone" | "walk_in";
+            /** @description Any special requirements or notes */
+            specialRequests: string | null;
+            /** @description Preferred seating location */
+            tablePreference: string | null;
+            /** @description User ID who created the reservation */
+            createdBy: string;
+            /** @description User ID who last updated the reservation */
+            updatedBy: string;
+            /**
+             * Format: date-time
+             * @description Reservation creation timestamp
+             */
+            createdAt: string | null;
+            /**
+             * Format: date-time
+             * @description Last update timestamp
+             */
+            updatedAt: string | null;
+        };
     };
     responses: never;
     parameters: never;
@@ -79,6 +325,8 @@ interface components {
 type schemas = components['schemas'];
 type PlaceOrderRequest = schemas['PlaceOrderRequest'];
 type PlaceOrderResponse = schemas['PlaceOrderResponse'];
+type MakeReservationRequest = schemas['MakeReservationRequest'];
+type MakeReservationResponse = schemas['MakeReservationResponse'];
 
 declare class OrdersResource extends BaseResource {
     constructor(tokenManager: TokenManager, baseUrl: string);
@@ -86,24 +334,41 @@ declare class OrdersResource extends BaseResource {
     get(orderId: string): Promise<PlaceOrderRequest>;
 }
 
+declare class ReservationsResource extends BaseResource {
+    constructor(tokenManager: TokenManager, baseUrl: string);
+    /**
+     * Make a new reservation
+     * @param reservation - The reservation details
+     * @returns The created reservation with confirmation code
+     */
+    make(reservation: MakeReservationRequest): Promise<MakeReservationResponse>;
+    /**
+     * Get a reservation by ID
+     * @param reservationId - The reservation ID
+     * @returns The reservation details
+     */
+    get(reservationId: string): Promise<MakeReservationResponse>;
+}
+
 interface Order3000ClientConfig {
     clientId: string;
     clientSecret: string;
     tenantId?: string;
     /**
-     * Base URL for API services
+     * Base URL for API requests
      * @default "https://order3000.com/api"
      */
-    apiEndpoint?: string;
+    baseUrl?: string;
     /**
      * OAuth 2.0 token endpoint
-     * @default "${apiEndpoint}/auth/token"
+     * @default "${baseUrl}/auth/token"
      */
     tokenUrl?: string;
 }
 declare class Order3000Client {
     orders: OrdersResource;
-    private readonly apiEndpoint;
+    reservations: ReservationsResource;
+    private readonly baseUrl;
     private readonly tokenManager;
     constructor(config: Order3000ClientConfig);
     private initialize;

package/dist/client.d.mts

@@ -68,6 +68,252 @@ interface components {
             updatedAt: string | null;
             updatedBy: string | null;
         };
+        /**
+         * MakeReservationRequest
+         * @description Request payload for making a new reservation
+         */
+        MakeReservationRequest: {
+            /** @description Date of the reservation in YYYY-MM-DD format */
+            reservationDate: string;
+            /** @description Time of the reservation in HH:MM:SS format */
+            reservationTime: string;
+            /** @description Number of guests in the party. Must be between 1 and 20. */
+            partySize: number;
+            /** @description Reservation duration in minutes. Defaults to 120 minutes if not specified. Range: 30-300 minutes. */
+            duration: number | null;
+            /**
+             * Format: uuid
+             * @description UUID of existing customer profile if available
+             */
+            customerId: string | null;
+            /** @description Full name of the customer making the reservation */
+            customerName: string;
+            /**
+             * Format: email
+             * @description Email address for reservation confirmations and updates
+             */
+            customerEmail?: string | null;
+            /** @description Phone number for reservation confirmations and updates. Include country code for international numbers. */
+            customerPhone?: string | null;
+            /**
+             * @description Preferred method for reservation reminders and updates
+             * @enum {string}
+             */
+            contactPreference: "email" | "phone" | "sms" | "none";
+            /**
+             * @description Origin of the reservation request
+             * @enum {string}
+             */
+            source: "website" | "phone" | "walk_in";
+            /** @description Any dietary restrictions, allergies, or special occasions (max 500 characters) */
+            specialRequests: string | null;
+            /** @description Preferred seating area or table type (e.g., "window seat", "quiet area", "patio") */
+            tablePreference: string | null;
+        };
+        /**
+         * MakeReservationResponse
+         * @description Successfully created reservation
+         */
+        MakeReservationResponse: {
+            /**
+             * Format: uuid
+             * @description Unique identifier for the reservation
+             */
+            id: string;
+            /**
+             * Format: uuid
+             * @description Restaurant/tenant identifier
+             */
+            tenantId: string;
+            /** @description Date of the reservation in YYYY-MM-DD format */
+            reservationDate: string;
+            /** @description Time of the reservation in HH:MM:SS format */
+            reservationTime: string;
+            /** @description Number of guests in the party */
+            partySize: number;
+            /** @description Reservation duration in minutes */
+            duration: number | null;
+            /**
+             * Format: uuid
+             * @description Link to customer profile if exists
+             */
+            customerId: string | null;
+            /** @description Full name of the customer */
+            customerName: string;
+            /** @description Customer email address */
+            customerEmail: string | null;
+            /** @description Customer phone number */
+            customerPhone: string | null;
+            /**
+             * @description Preferred contact method
+             * @enum {string}
+             */
+            contactPreference: "email" | "phone" | "sms" | "none";
+            /**
+             * @description Current status of the reservation
+             * @enum {string}
+             */
+            status: "pending" | "confirmed" | "arrived" | "seated" | "completed" | "cancelled" | "no_show";
+            /** @description 6-character confirmation code for the reservation */
+            confirmationCode: string | null;
+            /**
+             * Format: date-time
+             * @description When the reservation was confirmed
+             */
+            confirmedAt: string | null;
+            /**
+             * Format: date-time
+             * @description When the guest arrived
+             */
+            arrivedAt: string | null;
+            /**
+             * Format: date-time
+             * @description When the guest was seated
+             */
+            seatedAt: string | null;
+            /**
+             * Format: date-time
+             * @description When the dining was completed
+             */
+            completedAt: string | null;
+            /**
+             * Format: date-time
+             * @description When the reservation was cancelled
+             */
+            cancelledAt: string | null;
+            /**
+             * @description Who initiated the cancellation
+             * @enum {string|null}
+             */
+            cancellationReason: "customer_request" | "restaurant_request" | null;
+            /** @description Additional cancellation details */
+            cancellationNote: string | null;
+            /**
+             * @description Origin of the reservation
+             * @enum {string}
+             */
+            source: "website" | "phone" | "walk_in";
+            /** @description Any special requirements or notes */
+            specialRequests: string | null;
+            /** @description Preferred seating location */
+            tablePreference: string | null;
+            /** @description User ID who created the reservation */
+            createdBy: string;
+            /** @description User ID who last updated the reservation */
+            updatedBy: string;
+            /**
+             * Format: date-time
+             * @description Reservation creation timestamp
+             */
+            createdAt: string | null;
+            /**
+             * Format: date-time
+             * @description Last update timestamp
+             */
+            updatedAt: string | null;
+        };
+        /**
+         * ReservationDetails
+         * @description Reservation details
+         */
+        ReservationDetails: {
+            /**
+             * Format: uuid
+             * @description Unique identifier for the reservation
+             */
+            id: string;
+            /**
+             * Format: uuid
+             * @description Restaurant/tenant identifier
+             */
+            tenantId: string;
+            /** @description Date of the reservation in YYYY-MM-DD format */
+            reservationDate: string;
+            /** @description Time of the reservation in HH:MM:SS format */
+            reservationTime: string;
+            /** @description Number of guests in the party */
+            partySize: number;
+            /** @description Reservation duration in minutes */
+            duration: number | null;
+            /**
+             * Format: uuid
+             * @description Link to customer profile if exists
+             */
+            customerId: string | null;
+            /** @description Full name of the customer */
+            customerName: string;
+            /** @description Customer email address */
+            customerEmail: string | null;
+            /** @description Customer phone number */
+            customerPhone: string | null;
+            /**
+             * @description Preferred contact method
+             * @enum {string}
+             */
+            contactPreference: "email" | "phone" | "sms" | "none";
+            /**
+             * @description Current status of the reservation
+             * @enum {string}
+             */
+            status: "pending" | "confirmed" | "arrived" | "seated" | "completed" | "cancelled" | "no_show";
+            /** @description 6-character confirmation code for the reservation */
+            confirmationCode: string | null;
+            /**
+             * Format: date-time
+             * @description When the reservation was confirmed
+             */
+            confirmedAt: string | null;
+            /**
+             * Format: date-time
+             * @description When the guest arrived
+             */
+            arrivedAt: string | null;
+            /**
+             * Format: date-time
+             * @description When the guest was seated
+             */
+            seatedAt: string | null;
+            /**
+             * Format: date-time
+             * @description When the dining was completed
+             */
+            completedAt: string | null;
+            /**
+             * Format: date-time
+             * @description When the reservation was cancelled
+             */
+            cancelledAt: string | null;
+            /**
+             * @description Who initiated the cancellation
+             * @enum {string|null}
+             */
+            cancellationReason: "customer_request" | "restaurant_request" | null;
+            /** @description Additional cancellation details */
+            cancellationNote: string | null;
+            /**
+             * @description Origin of the reservation
+             * @enum {string}
+             */
+            source: "website" | "phone" | "walk_in";
+            /** @description Any special requirements or notes */
+            specialRequests: string | null;
+            /** @description Preferred seating location */
+            tablePreference: string | null;
+            /** @description User ID who created the reservation */
+            createdBy: string;
+            /** @description User ID who last updated the reservation */
+            updatedBy: string;
+            /**
+             * Format: date-time
+             * @description Reservation creation timestamp
+             */
+            createdAt: string | null;
+            /**
+             * Format: date-time
+             * @description Last update timestamp
+             */
+            updatedAt: string | null;
+        };
     };
     responses: never;
     parameters: never;
@@ -79,6 +325,8 @@ interface components {
 type schemas = components['schemas'];
 type PlaceOrderRequest = schemas['PlaceOrderRequest'];
 type PlaceOrderResponse = schemas['PlaceOrderResponse'];
+type MakeReservationRequest = schemas['MakeReservationRequest'];
+type MakeReservationResponse = schemas['MakeReservationResponse'];
 
 declare class OrdersResource extends BaseResource {
     constructor(tokenManager: TokenManager, baseUrl: string);
@@ -86,24 +334,41 @@ declare class OrdersResource extends BaseResource {
     get(orderId: string): Promise<PlaceOrderRequest>;
 }
 
+declare class ReservationsResource extends BaseResource {
+    constructor(tokenManager: TokenManager, baseUrl: string);
+    /**
+     * Make a new reservation
+     * @param reservation - The reservation details
+     * @returns The created reservation with confirmation code
+     */
+    make(reservation: MakeReservationRequest): Promise<MakeReservationResponse>;
+    /**
+     * Get a reservation by ID
+     * @param reservationId - The reservation ID
+     * @returns The reservation details
+     */
+    get(reservationId: string): Promise<MakeReservationResponse>;
+}
+
 interface Order3000ClientConfig {
     clientId: string;
     clientSecret: string;
     tenantId?: string;
     /**
-     * Base URL for API services
+     * Base URL for API requests
      * @default "https://order3000.com/api"
      */
-    apiEndpoint?: string;
+    baseUrl?: string;
     /**
      * OAuth 2.0 token endpoint
-     * @default "${apiEndpoint}/auth/token"
+     * @default "${baseUrl}/auth/token"
      */
     tokenUrl?: string;
 }
 declare class Order3000Client {
     orders: OrdersResource;
-    private readonly apiEndpoint;
+    reservations: ReservationsResource;
+    private readonly baseUrl;
     private readonly tokenManager;
     constructor(config: Order3000ClientConfig);
     private initialize;

package/dist/client.mjs

@@ -102,16 +102,39 @@ class OrdersResource extends BaseResource {
   }
 }
 
+class ReservationsResource extends BaseResource {
+  constructor(tokenManager, baseUrl) {
+    super(tokenManager, baseUrl, "/reservations");
+  }
+  /**
+   * Make a new reservation
+   * @param reservation - The reservation details
+   * @returns The created reservation with confirmation code
+   */
+  async make(reservation) {
+    return this.request("POST", "", reservation);
+  }
+  /**
+   * Get a reservation by ID
+   * @param reservationId - The reservation ID
+   * @returns The reservation details
+   */
+  async get(reservationId) {
+    return this.request("GET", `/${reservationId}`);
+  }
+}
+
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 class Order3000Client {
   constructor(config) {
     __publicField(this, "orders");
-    __publicField(this, "apiEndpoint");
+    __publicField(this, "reservations");
+    __publicField(this, "baseUrl");
     __publicField(this, "tokenManager");
-    this.apiEndpoint = config.apiEndpoint || "https://order3000.com/api";
-    const tokenUrl = config.tokenUrl || `${this.apiEndpoint}/auth/token`;
+    this.baseUrl = config.baseUrl || "https://order3000.com/api";
+    const tokenUrl = config.tokenUrl || `${this.baseUrl}/auth/token`;
     this.tokenManager = new TokenManager(
       config.clientId,
       config.clientSecret,
@@ -119,7 +142,11 @@ class Order3000Client {
       config.tenantId
     );
     console.log("refreshToken 12");
-    this.orders = new OrdersResource(this.tokenManager, this.apiEndpoint);
+    this.orders = new OrdersResource(this.tokenManager, this.baseUrl);
+    this.reservations = new ReservationsResource(
+      this.tokenManager,
+      this.baseUrl
+    );
     console.log("refreshToken 13");
     this.initialize();
     console.log("refreshToken 14");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "order3000",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "order3000 node.js sdk",
   "main": "./dist/client.cjs",
   "module": "./dist/client.mjs",
@@ -17,9 +17,11 @@
   },
   "dependencies": {
     "@supabase/supabase-js": "^2.49.8",
+    "@types/react-type-animation": "^2.0.0",
     "got": "^14.4.6",
     "i18next": "^25.0.0",
-    "i18next-fs-backend": "^2.6.0"
+    "i18next-fs-backend": "^2.6.0",
+    "react-type-animation": "^3.2.0"
   },
   "devDependencies": {
     "@types/node": "^22.13.9",
@@ -37,7 +39,7 @@
   "prettier": "@kolaveri/prettier-config",
   "scripts": {
     "dev": "scripts/dev.sh tsx src/dev.ts",
-    "build:types": "openapi-typescript ../../apps/order3000/public/openapi.json -o src/types/generated.d.ts",
+    "build:types": "openapi-typescript ../order3000/public/openapi.json -o src/types/generated.d.ts",
     "build": "npm run build:types && pkgroll"
   }
 }