client sdk documentation added

Author: SOG-web

apps/docs/app.config.ts

@@ -52,6 +52,14 @@ export default defineAppConfig({
               icon: 'lucide:globe',
               description: 'Explore ForgeBase API and it functionality',
             },
+            {
+              title: 'Client Packages',
+              to: '/client-packages',
+              target: '_self',
+              icon: 'lucide:package-open',
+              description:
+                'Explore ForgeBase client packages for web and mobile applications',
+            },
           ],
         },
       ],

apps/docs/content/2.api/2.getting-started.md

@@ -4,8 +4,6 @@ description: Learn how to set up and use the ForgeBase API package
 icon: 'lucide:play'
 ---
 
-# Getting Started with ForgeBase API
-
 This guide will help you get started with the ForgeBase API package, showing you how to set it up and integrate it with your application.
 
 ## Installation
@@ -26,7 +24,7 @@ If you plan to use storage features, install the storage package as well:
 
 The first step in using ForgeBase API is to set up a database connection:
 
-```typescript
+```typescript [ts]
 import knex from 'knex';
 
 // Create a Knex instance for your database
@@ -47,7 +45,7 @@ Below are examples of integrating ForgeBase API with various frameworks. For mor
 
 Here's how to integrate ForgeBase API with an Express application:
 
-```typescript
+```typescript [ts]
 import express from 'express';
 import cors from 'cors';
 import { createExpressHandler } from '@the-forgebase/api/core/express';
@@ -109,7 +107,7 @@ app.listen(PORT, () => {
 
 Here's how to integrate ForgeBase API with a Hono application:
 
-```typescript
+```typescript [ts]
 import { Hono } from 'hono';
 import { cors } from 'hono/cors';
 import { createIttyHandler } from '@the-forgebase/api/core/web';
@@ -178,7 +176,7 @@ export default {
 
 ForgeBase API provides dedicated modules for NestJS integration:
 
-```typescript
+```typescript [ts]
 import { Module } from '@nestjs/common';
 import { ForgeApiModule } from '@the-forgebase/api/core/nest';
 
@@ -204,7 +202,7 @@ export class AppModule {}
 
 For more advanced scenarios, you can use the `ForgeApiWithChildModule`:
 
-```typescript
+```typescript [ts]
 import { Module } from '@nestjs/common';
 import { ForgeApiWithChildModule } from '@the-forgebase/api/core/nest';
 
@@ -252,7 +250,7 @@ export class FeatureModule {}
 
 ForgeBase API can be easily integrated with Next.js API routes:
 
-```typescript
+```typescript [ts]
 // app/api/[[...route]]/route.ts
 import { NextRequest, NextResponse } from 'next/server';
 import { createIttyHandler } from '@the-forgebase/api/core/web';
@@ -323,7 +321,7 @@ Once you've set up the ForgeBase API, you can start using it to interact with yo
 
 ### Accessing the Database Service
 
-```typescript
+```typescript [ts]
 // Get the database service from your handler
 const db = expressHandler.getDatabaseService(); // or webHandler.getDatabaseService();
 

apps/docs/content/2.api/3.rest-api-reference.md

@@ -4,8 +4,6 @@ description: Comprehensive reference for the ForgeBase API REST endpoints
 icon: 'lucide:book-open'
 ---
 
-# REST API Reference
-
 ForgeBase API automatically creates RESTful endpoints for your database. This page provides a comprehensive reference for all available endpoints.
 
 ## Base URL
@@ -18,31 +16,31 @@ These endpoints allow you to manage your database schema.
 
 ### Get Database Schema
 
-```http
+```http [http]
 GET /api/db/schema
 ```
 
 Returns the complete database schema, including all tables, columns, and relationships.
 
 ### Get Tables
 
-```http
+```http [http]
 GET /api/db/schema/tables
 ```
 
 Returns a list of all tables in the database.
 
 ### Get Table Schema
 
-```http
+```http [http]
 GET /api/db/schema/tables/:tableName
 ```
 
 Returns the schema for a specific table, including all columns and relationships.
 
 ### Create Table
 
-```http
+```http [http]
 POST /api/db/schema
 Content-Type: application/json
 
@@ -60,7 +58,7 @@ Creates a new table with the specified columns.
 
 ### Add Column
 
-```http
+```http [http]
 POST /api/db/schema/column
 Content-Type: application/json
 
@@ -76,7 +74,7 @@ Adds one or more columns to an existing table.
 
 ### Drop Column
 
-```http
+```http [http]
 DELETE /api/db/schema/column
 Content-Type: application/json
 
@@ -90,7 +88,7 @@ Removes a column from an existing table.
 
 ### Add Foreign Key
 
-```http
+```http [http]
 POST /api/db/schema/foreign_key
 Content-Type: application/json
 
@@ -110,7 +108,7 @@ Adds a foreign key constraint to a table.
 
 ### Drop Foreign Key
 
-```http
+```http [http]
 DELETE /api/db/schema/foreign_key
 Content-Type: application/json
 
@@ -124,7 +122,7 @@ Removes a foreign key constraint from a table.
 
 ### Delete Table
 
-```http
+```http [http]
 DELETE /api/db/schema/tables/:tableName
 ```
 
@@ -136,7 +134,7 @@ These endpoints allow you to perform CRUD operations on your data.
 
 ### Create Record
 
-```http
+```http [http]
 POST /api/db/create/:tableName
 Content-Type: application/json
 
@@ -152,7 +150,7 @@ Creates a new record in the specified table.
 
 ### Query Records
 
-```http
+```http [http]
 POST /api/db/query/:tableName
 Content-Type: application/json
 
@@ -171,15 +169,15 @@ Queries records from the specified table with filtering, pagination, and sorting
 
 ### Get Record by ID
 
-```http
+```http [http]
 GET /api/db/get/:tableName/:id
 ```
 
 Retrieves a specific record by its ID.
 
 ### Update Record
 
-```http
+```http [http]
 PUT /api/db/update/:tableName/:id
 Content-Type: application/json
 
@@ -195,7 +193,7 @@ Updates a specific record by its ID.
 
 ### Advanced Update
 
-```http
+```http [http]
 POST /api/db/update/:tableName
 Content-Type: application/json
 
@@ -213,15 +211,15 @@ Updates multiple records that match the filter criteria.
 
 ### Delete Record
 
-```http
+```http [http]
 DELETE /api/db/del/:tableName/:id
 ```
 
 Deletes a specific record by its ID.
 
 ### Advanced Delete
 
-```http
+```http [http]
 POST /api/db/del/:tableName
 Content-Type: application/json
 
@@ -240,15 +238,15 @@ These endpoints allow you to manage row-level security permissions.
 
 ### Get Table Permissions
 
-```http
+```http [http]
 GET /api/db/permissions/:tableName
 ```
 
 Returns the permissions for a specific table.
 
 ### Set Table Permissions
 
-```http
+```http [http]
 POST /api/db/permissions/:tableName
 Content-Type: application/json
 
@@ -261,7 +259,7 @@ Content-Type: application/json
       { "allow": "auth" }
     ],
     "UPDATE": [
-      { "allow": "auth", 
+      { "allow": "auth",
         "fieldCheck": {
           "field": "user_id",
           "operator": "===",
@@ -281,7 +279,7 @@ Sets the permissions for a specific table.
 
 ### Delete Table Permissions
 
-```http
+```http [http]
 DELETE /api/db/permissions/:tableName
 ```
 
@@ -295,31 +293,31 @@ Many endpoints support query parameters for filtering, pagination, and sorting:
 
 You can filter records using the `filter` parameter:
 
-```http
+```http [http]
 GET /api/db/query/users?filter={"name":"John"}
 ```
 
 ### Pagination
 
 You can paginate results using the `limit` and `offset` parameters:
 
-```http
+```http [http]
 GET /api/db/query/users?limit=10&offset=0
 ```
 
 ### Sorting
 
 You can sort results using the `orderBy` parameter:
 
-```http
+```http [http]
 GET /api/db/query/users?orderBy=[{"column":"name","order":"asc"}]
 ```
 
 ### Column Selection
 
 You can select specific columns using the `select` parameter:
 
-```http
+```http [http]
 GET /api/db/query/users?select=["id","name","email"]
 ```
 
@@ -347,7 +345,7 @@ All endpoints return standard HTTP status codes:
 
 Error responses include a JSON body with an error message:
 
-```json
+```json [json]
 {
   "error": "Bad Request",
   "message": "Invalid data format"

apps/docs/content/2.api/4.framework-integration/2.express.md

@@ -8,7 +8,7 @@ Express is one of the most popular Node.js web frameworks, and ForgeBase API pro
 
 ## Basic Integration
 
-```typescript
+```typescript [ts]
 import express from 'express';
 import cors from 'cors';
 import { createExpressHandler } from '@the-forgebase/api/core/express';
@@ -75,7 +75,7 @@ app.listen(PORT, () => {
 
 To integrate authentication with Express, you can use the ForgeBase Auth package:
 
-```typescript
+```typescript [ts]
 import express from 'express';
 import { createExpressHandler } from '@the-forgebase/api/core/express';
 import { createExpressAuthClient, initializeExpressAuth } from '@the-forgebase/auth/adapters/express';
@@ -136,7 +136,7 @@ app.listen(3000);
 
 You can access the database service directly for custom operations:
 
-```typescript
+```typescript [ts]
 // Get the database service
 const db = expressHandler.getDatabaseService();
 

apps/docs/content/2.api/4.framework-integration/3.nest.md

@@ -8,7 +8,7 @@ NestJS is a progressive Node.js framework, and ForgeBase API provides dedicated
 
 ## Basic Integration
 
-```typescript
+```typescript [ts]
 import { Module } from '@nestjs/common';
 import { ForgeApiModule } from '@the-forgebase/api/core/nest';
 
@@ -36,7 +36,7 @@ export class AppModule {}
 
 For more advanced scenarios, you can use the `ForgeApiWithChildModule`:
 
-```typescript
+```typescript [ts]
 import { Module } from '@nestjs/common';
 import { ForgeApiWithChildModule } from '@the-forgebase/api/core/nest';
 
@@ -84,7 +84,7 @@ export class FeatureModule {}
 
 To integrate authentication with NestJS, you can use the ForgeBase Auth package:
 
-```typescript
+```typescript [ts]
 import { Module } from '@nestjs/common';
 import { ForgeApiModule } from '@the-forgebase/api/core/nest';
 import { NestAuthModule } from '@the-forgebase/auth/adapters/nest';
@@ -124,7 +124,7 @@ export class AppModule {}
 
 You can inject and use the ForgeBase services in your NestJS controllers and services:
 
-```typescript
+```typescript [ts]
 import { Controller, Get, Inject } from '@nestjs/common';
 import { DatabaseService } from '@the-forgebase/api/core/nest';