open-index/open-npm huggingface dataset:
npm package: @forgebase/cli
Description: CLI tool for ForgeBase
Author: SOG-web
Latest version: 0.0.6

# @forgebase/cli

Command Line Interface for ForgeBase.

## Installation

```bash
npm install -g @forgebase/cli
# or use with npx/pnpx
npx @forgebase/cli <command>
```

## Commands

### `database`

Generate TypeScript schema definitions from your running ForgeBase instance.

**Usage:**

```bash
npx @forgebase/cli database --url <schema-endpoint-url> --output <output-file-path>
```

**Options:**

- `--url <url>`: The URL to the ForgeBase schema endpoint (e.g., `http://localhost:3000/schema`).
- `--output <path>`: The path to save the generated TypeScript schema file (e.g., `src/lib/db/schema.ts`).

**Example:**

```bash
# Generate schema.ts from local API
npx @forgebase/cli database --url http://localhost:3000/schema --output src/lib/db/schema.ts
```

### Using the Generated Schema

Once generated, you can use the schema with the `@forgebase/sdk` client for full type safety:

```typescript
import { DatabaseSDK } from '@forgebase/sdk/client';
import type { Schema } from './lib/db/schema';

const db = new DatabaseSDK<Schema>({
  baseUrl: 'http://localhost:3000',
  // ... config
});

// Fully typed!
const users = await db.table('users').select('email').query();
```
npm package: @forgecart/example-npm
Description: A simple example npm package for forgecart
Latest version: 1.0.0

# @forgecart/example-npm

A simple example npm package from the forgecart organization with utility functions.

## Installation

```bash
npm install @forgecart/example-npm
```

## Usage

```javascript
const { greet, add, multiply, reverseString, isPalindrome } = require('@forgecart/example-npm');

// Greet someone
console.log(greet('Developer')); // "Hello, Developer! Welcome to forgecart."

// Math operations
console.log(add(5, 3)); // 8
console.log(multiply(4, 7)); // 28

// String operations
console.log(reverseString('hello')); // "olleh"
console.log(isPalindrome('racecar')); // true
```

## API

### `greet(name)`
Returns a personalized greeting message.
- `name` (string, optional): The name to greet. Defaults to 'World'.

### `add(a, b)`
Returns the sum of two numbers.
- `a` (number): First number
- `b` (number): Second number

### `multiply(a, b)`
Returns the product of two numbers.
- `a` (number): First number
- `b` (number): Second number

### `reverseString(str)`
Returns the reversed version of a string.
- `str` (string): The string to reverse

### `isPalindrome(str)`
Checks if a string is a palindrome (reads the same forwards and backwards).
- `str` (string): The string to check
- Returns: boolean

## License

MIT
npm package: @forgecodebr/idealsoft-sdk
Description: SDK TypeScript para integração com o módulo Integrações do Shop Control (IdealSoft)
Latest version: 0.1.0

# @forgecode/idealsoft-sdk

SDK TypeScript para o módulo Integrações do Shop Control (IdealSoft).

## Recursos
- Autenticação (token)
- Assinatura HMAC (Signature header)
- Wrapper genérico para chamadas
- Endpoints: produtos, clientes, vendas, estoques (exemplos)

## Instalação
```bash
npm install node-fetch @forgecode/idealsoft-sdk
```

## Uso básico
```ts
import { IdealSoftClient, authenticate, endpoints } from "@forgecode/idealsoft-sdk";

async function main(){
  const client = new IdealSoftClient({
    baseUrl: "https://api.idealsoft.com.br",
    codFilial: "001",
    secretKey: process.env.IDEALSOFT_SECRET || "",
  });

  await authenticate(client, { usuario: "teste", senha: "teste" });

  const produtos = await endpoints.listProducts(client);
  console.log(produtos.dados);
}

main();
```

## Extensão
A biblioteca foi projetada para ser simples de estender — adicione novos arquivos de endpoints dentro de `src/endpoints` seguindo o padrão existente.

---

// OBS:
// - Ajuste os caminhos dos endpoints conforme a sua instalação da IdealSoft — alguns clientes personalizam rotas.
// - Recomenda-se usar o ambiente de homologação fornecido pela IdealSoft para testar antes de ir para produção.

// FIM
npm package: @forgedb/mcp-server
Description: ForgeDB MCP Server — AI agents interact with ForgeDB backend
Latest version: 0.1.0

# @forgedb/mcp-server

ForgeDB MCP Server -- AI agents interact directly with your ForgeDB backend.

## Tools

| Tool | Description |
|------|-------------|
| `forgedb_query` | Execute SQL queries (SELECT, INSERT, UPDATE, DELETE, DDL) |
| `forgedb_list_tables` | List tables with columns, types, and relationships |
| `forgedb_create_table` | Create tables with auto id/timestamps/RLS |
| `forgedb_create_policy` | Create Row Level Security policies |
| `forgedb_insert_data` | Insert/seed data into tables |

## Resources

| Resource | URI | Description |
|----------|-----|-------------|
| Schema | `forgedb://schema/public` | Live project schema (tables + columns) |

## Prompts

| Prompt | Description |
|--------|-------------|
| `forgedb_sdk_init` | Generate SDK initialization code |

## Setup

```bash
# Install
cd mcp && npm install && npm run build

# Configure environment
export FORGEDB_URL=http://localhost:4100
export FORGEDB_TOKEN=your-auth-token
export FORGEDB_PROJECT_ID=your-project-id

# Run
node dist/index.js
```

## MCP Client Configuration

### Claude Desktop / Cursor / BlueForge

Add to your MCP config:

```json
{
  "mcpServers": {
    "forgedb": {
      "command": "node",
      "args": ["/path/to/forgedb/mcp/dist/index.js"],
      "env": {
        "FORGEDB_URL": "http://localhost:4100",
        "FORGEDB_TOKEN": "your-token",
        "FORGEDB_PROJECT_ID": "your-project-id"
      }
    }
  }
}
```

## Usage Examples

### Create a blog schema

```
AI Agent: Please create tables for a blog with posts and comments.

[forgedb_create_table] posts: title(TEXT), content(TEXT), status(TEXT), user_id
[forgedb_create_table] comments: body(TEXT), post_id(UUID), user_id
[forgedb_create_policy] "Anyone can read posts" SELECT on posts USING(true)
[forgedb_create_policy] "Users own their posts" INSERT on posts WITH CHECK(auth.uid()=user_id)
[forgedb_insert_data] Sample posts with test content
```

### Query data

```
AI Agent: Show me all published posts

[forgedb_query] SELECT * FROM posts WHERE status = 'published' ORDER BY created_at DESC LIMIT 10
```
npm package: @forgedesk/api
Description: Typed JavaScript API bindings for Forge applications
Latest version: 2.0.1

# @forgedesk/api

Typed JavaScript bindings for the Forge runtime.

## Requirements

- Forge runtime embedded in a Python 3.14+ free-threaded app

## Install

```bash
npm install @forgedesk/api
```

## Usage

```js
import forge, { invoke, isForgeAvailable } from "@forgedesk/api";

if (isForgeAvailable()) {
  const version = await forge.app.version();
  const state = await forge.window.state();
  const result = await invoke("greet", { name: "Forge" });
  console.log(version, state, result);
}
```

This package expects the Forge runtime to inject `window.__forge__`.
npm package: @forgedesk/cli
Description: Node wrapper for the Forge Python CLI
Latest version: 2.0.1

# @forgedesk/cli

Node wrapper for the Forge Python CLI.

## Requirements

- Python 3.14+ free-threaded runtime (`forge-framework`)
- Node.js 18+

## Install

```bash
npm install -D @forgedesk/cli
```

## Usage

```bash
npx forge create my-app --template react
npx forge dev
npx forge build
npx forge package --result-format json
npx forge sign --result-format json
```

If the Python Forge package is missing, the wrapper attempts to install `forge-framework` with `pip` unless `FORGE_SKIP_AUTO_INSTALL=1` is set.
The wrapper is intended to run against the same free-threaded Forge runtime used by the main framework.
npm package: @forgedesk/create-forge-app
Description: Scaffold Forge applications from npm
Latest version: 2.0.1

# @forgedesk/create-forge-app

Scaffold Forge applications from npm.

## Requirements

- Python 3.14+ free-threaded runtime (`forge-framework`)
- Node.js 18+

## Usage

```bash
npx @forgedesk/create-forge-app@latest my-app -- --template react
```

If your npm client is configured to a mirror that has not synced the latest release yet, use the npm registry explicitly:

```bash
npx --registry=https://registry.npmjs.org @forgedesk/create-forge-app@latest my-app -- --template react
```

The bootstrapper delegates to the Forge Python CLI and installs `forge-framework` with `pip` when needed.
This keeps the npm starter flow aligned with the no-GIL Forge runtime.
npm package: @forgedesk/vite-plugin
Description: Vite integration for Forge frontend projects
Latest version: 2.0.1

# @forgedesk/vite-plugin

Vite integration for Forge frontends.

## Requirements

- Forge runtime embedded in a Python 3.14+ free-threaded app
- Vite 5+

## Install

```bash
npm install -D vite @forgedesk/vite-plugin
```

## Usage

```js
import { defineConfig } from "vite";
import { forgeVitePlugin } from "@forgedesk/vite-plugin";

export default defineConfig({
  plugins: [forgeVitePlugin()],
});
```

The plugin injects `forge.js` into `index.html` and exposes `__FORGE_DEV_SERVER_URL__` at build time.
npm package: @forgedev-br/biome-config
Description: Biome configuration used by ForgeDev BR
Latest version: 1.2.0

# Code Formatting and Linting Configuration used by ForgeDev BR

## What"s included?

- [Biome](https://biomejs.dev/) for code formatting and linting;

## Setup

Install dependencies:

```bash
npm add --save-dev @biomejs/biome @forgedev-br/biome-config
```

Configure your project:

```bash
npx @biomejs/biome init
```

Extend the configuration within `biome.json` file:

```json
{
  "$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
  "extends": ["@forgedev-br/biome-config/biome"]
}
```

Add a script to package.json:

```json
"scripts": {
  "lint": "npx @biomejs/biome check src"
}
```

> **Note:** You can also run `npx @biomejs/biome check --write` to automatically fix the code.