@tanushbhootra576/saas

saas

Plug-and-play backend starter engine for SaaS apps, rapid prototypes, and modular business systems.

Installation

npm install @tanushbhootra576/saas

Quick Start

import { createSaasEngine, startServer } from '@tanushbhootra576/saas';

const engine = await createSaasEngine({
  modules: ['auth', 'ticket', 'payment', 'order']
});

await startServer(engine);

Module Usage

import { ticketModule, hotelModule } from '@tanushbhootra576/saas';

// Register only the modules you need when building your own engine.

CLI

saas create-project my-app
saas enable-module ticket
saas generate-template ticket
saas start-server

API Endpoints

The package ships with route handlers for these systems:

• /tickets, /tickets/:id, /tickets/:id/comments, /tickets/:id/attachments
• /movies/shows, /movies/bookings, /movies/bookings/:id/cancel
• /hotels/rooms, /hotels/availability, /hotels/bookings
• /cart/products, /cart/items, /cart/checkout/:userId
• /appointments/slots, /appointments/book, /appointments/:id/reschedule
• /auth/register, /auth/login, /auth/logout, /auth/me
• /payments/charge, /payments/:id/refund
• /orders, /orders/:id/status, /orders/:id/history
• /notifications, /analytics/stats, /analytics/export, /invoices/generate
• /admin/users, /admin/bookings, /admin/products

Configuration

Use .env or .saasrc.json.

{
  "modules": ["auth", "ticket", "payment", "order"],
  "database": { "driver": "memory" },
  "multiTenant": { "enabled": true, "header": "x-tenant-id" }
}

Environment Variables

• SAAS_PORT
• SAAS_HOST
• SAAS_MODULES
• SAAS_JWT_SECRET

File Structure

/modules
  /ticket
  /movie
  /hotel
  /cart
  /appointment
  /auth
  /payment
  /order
  /notification
  /analytics
  /invoice
  /admin
/core
/utils
/middlewares
/config
/database
index.js
cli.js

Testing

npm test

Publish Steps

• Update name, version, and metadata in package.json.
• Run the test suite and fix any failures.
• Verify npm pack output contains the expected files.
• Sign in with npm login.
• Publish with npm publish --access public.

Notes

• The default database is in-memory.
• MongoDB and Prisma adapters are included as pluggable interfaces.
• Express integration is optional via bindExpressRoutes.