@zero-server/cli 0.9.7 → 0.9.9

package/README.md

@@ -1,8 +1,8 @@
 # @zero-server/cli
 
-> Programmatic access to the `zh` / `zs` CLI.
+> Programmatic access to the `zs` CLI.
 
-Programmatic entry points for the bundled CLI (`zh` / `zs`): scaffolding, migrations, seeding, rollback, status. Useful when embedding the CLI inside your own tooling.
+Programmatic entry points for the bundled CLI (`zs`): scaffolding, migrations, seeding, rollback, status. Useful when embedding the CLI inside your own tooling.
 
 ## Install
 

package/lib/cli.js

@@ -18,13 +18,13 @@
  *   };
  *
  *   // Run via npx (no global install needed):
- *   // npx zh migrate
- *   // npx zh migrate:rollback
- *   // npx zh migrate:status
- *   // npx zh seed
- *   // npx zh make:model User
- *   // npx zh make:migration create_posts
- *   // npx zh make:seeder Users
+ *   // npx zs migrate
+ *   // npx zs migrate:rollback
+ *   // npx zs migrate:status
+ *   // npx zs seed
+ *   // npx zs make:model User
+ *   // npx zs make:migration create_posts
+ *   // npx zs make:seeder Users
  *
  *   // Or programmatically:
  *   const { runCLI } = require('@zero-server/sdk');
@@ -154,7 +154,7 @@ class CLI
         // webrtc CLI module so the top-level dispatcher stays small.
         if (typeof this.command === 'string' && this.command.startsWith('webrtc:'))
         {
-            const { runWebRTCCommand } = require('./webrtc/cli');
+            const { runWebRTCCommand } = require('@zero-server/webrtc');
             await runWebRTCCommand(this.command.slice('webrtc:'.length), this.flags);
             return;
         }
@@ -215,7 +215,7 @@ class CLI
             throw new Error(
                 'No configuration file found.\n' +
                 'Create a zero.config.js with database and migration settings.\n' +
-                'See "zh help" for examples.'
+                'See "zs help" for examples.'
             );
         }
 
@@ -431,7 +431,7 @@ class CLI
         if (status.executed.includes(lastMigration.name))
         {
             console.error(red(`Cannot remove "${lastMigration.name}" - it has already been applied.`));
-            console.error(dim('Run "zh migrate:rollback" first, then try again.'));
+            console.error(dim('Run "zs migrate:rollback" first, then try again.'));
             process.exitCode = 1;
             await db.close();
             return;
@@ -519,7 +519,7 @@ class CLI
         const name = this.args.find(a => !a.startsWith('-'));
         if (!name)
         {
-            console.error(red('Usage: zh make:model <Name>'));
+            console.error(red('Usage: zs make:model <Name>'));
             process.exitCode = 1;
             return;
         }
@@ -575,7 +575,7 @@ module.exports = ${className};
         const name = this.args.find(a => !a.startsWith('-'));
         if (!name)
         {
-            console.error(red('Usage: zh make:migration <name>'));
+            console.error(red('Usage: zs make:migration <name>'));
             process.exitCode = 1;
             return;
         }
@@ -701,7 +701,7 @@ module.exports = {
         const name = this.args.find(a => !a.startsWith('-'));
         if (!name)
         {
-            console.error(red('Usage: zh make:seeder <name>'));
+            console.error(red('Usage: zs make:seeder <name>'));
             process.exitCode = 1;
             return;
         }
@@ -751,9 +751,9 @@ module.exports = ${className};
     _help()
     {
         console.log(`
-${bold('zh CLI')} - zero-server ORM tooling
+${bold('zs CLI')} - zero-server ORM tooling
 
-${bold('Usage:')}  npx zh <command> [options]
+${bold('Usage:')}  npx zs <command> [options]
 
 ${bold('Commands:')}
 
@@ -803,19 +803,19 @@ ${bold('Config file:')} ${dim('zero.config.js (or .zero-server.js / legacy .zero
 
 ${bold('Auto-generated migrations:')}
 
-  ${dim('$')} npx zh make:migration create_users  ${dim('# detects new User model → generates CREATE TABLE')}
-  ${dim('$')} npx zh make:migration add_email     ${dim('# detects new email column → generates ADD COLUMN')}
-  ${dim('$')} npx zh make:migration --empty init   ${dim('# blank migration (manual mode)')}
-  ${dim('$')} npx zh migrate                      ${dim('# apply pending migrations')}
-  ${dim('$')} npx zh migrate:remove               ${dim('# undo last make:migration')}
+  ${dim('$')} npx zs make:migration create_users  ${dim('# detects new User model → generates CREATE TABLE')}
+  ${dim('$')} npx zs make:migration add_email     ${dim('# detects new email column → generates ADD COLUMN')}
+  ${dim('$')} npx zs make:migration --empty init   ${dim('# blank migration (manual mode)')}
+  ${dim('$')} npx zs migrate                      ${dim('# apply pending migrations')}
+  ${dim('$')} npx zs migrate:remove               ${dim('# undo last make:migration')}
 
 ${bold('Examples:')}
 
-  ${dim('$')} npx zh make:model User             ${dim('# creates models/User.js')}
-  ${dim('$')} npx zh make:migration create_users  ${dim('# auto-generates from models')}
-  ${dim('$')} npx zh migrate                     ${dim('# runs all pending migrations')}
-  ${dim('$')} npx zh migrate --config=db.config.js
-  ${dim('$')} npx zh seed                        ${dim('# runs all seeders')}
+  ${dim('$')} npx zs make:model User             ${dim('# creates models/User.js')}
+  ${dim('$')} npx zs make:migration create_users  ${dim('# auto-generates from models')}
+  ${dim('$')} npx zs migrate                     ${dim('# runs all pending migrations')}
+  ${dim('$')} npx zs migrate --config=db.config.js
+  ${dim('$')} npx zs seed                        ${dim('# runs all seeders')}
 `);
     }
 
@@ -825,7 +825,7 @@ ${bold('Examples:')}
     _version()
     {
         const pkg = require('../package.json');
-        console.log(`zh v${pkg.version} (zero-server)`);
+        console.log(`zs v${pkg.version} (zero-server)`);
     }
 }
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zero-server/cli",
-  "version": "0.9.7",
-  "description": "Programmatic access to the `zh` / `zs` CLI.",
+  "version": "0.9.9",
+  "description": "Programmatic access to the `zs` CLI.",
   "keywords": [
     "zero-server",
     "zero-server",
@@ -45,10 +45,11 @@
   },
   "sideEffects": false,
   "dependencies": {
-    "@zero-server/orm": "0.9.7"
+    "@zero-server/orm": "0.9.9",
+    "@zero-server/webrtc": "0.9.9"
   },
   "peerDependencies": {
-    "@zero-server/sdk": ">=0.9.7"
+    "@zero-server/sdk": ">=0.9.9"
   },
   "peerDependenciesMeta": {
     "@zero-server/sdk": {

package/types/body.d.ts

@@ -1,14 +1,82 @@
-// Re-exports for @zero-server/body - body parser types
-export {
-    BodyParserOptions,
-    JsonParserOptions,
-    UrlencodedParserOptions,
-    TextParserOptions,
-    MultipartOptions,
-    MultipartFile,
-    json,
-    urlencoded,
-    text,
-    raw,
-    multipart,
-} from './middleware';
+// TypeScript declarations for the bundled body parsers
+// (`json`, `urlencoded`, `text`, `raw`, `multipart`).
+//
+// These live in `lib/body/*` at runtime and are surfaced both via the
+// top-level SDK and the standalone `@zero-server/body` scope.  They are
+// declared here (not in `./middleware`) so the body-parser package has
+// a self-contained declaration file.
+
+import { MiddlewareFunction } from './middleware';
+import { Request } from './request';
+import { Response } from './response';
+
+export interface BodyParserOptions {
+    /** Max body size (e.g. '10kb', '1mb'). Default: '1mb'. */
+    limit?: string | number;
+    /** Content-Type(s) to match. Accepts a string, an array of strings, or a predicate function. */
+    type?: string | string[] | ((ct: string) => boolean);
+    /** Reject non-HTTPS requests with 403. */
+    requireSecure?: boolean;
+    /**
+     * Verification callback invoked with the raw buffer before parsing.
+     * Throw an error to reject the request with 403.
+     * Useful for webhook signature verification (e.g. Stripe, GitHub).
+     */
+    verify?: (req: Request, res: Response, buf: Buffer, encoding: string) => void;
+    /** Decompress gzip/deflate/br request bodies. Default: true. When false, compressed bodies return 415. */
+    inflate?: boolean;
+}
+
+export interface JsonParserOptions extends BodyParserOptions {
+    /** JSON.parse reviver function. */
+    reviver?: (key: string, value: any) => any;
+    /** Reject non-object/array roots. Default: true. */
+    strict?: boolean;
+}
+
+export interface UrlencodedParserOptions extends BodyParserOptions {
+    /** Enable nested bracket parsing. Default: false. */
+    extended?: boolean;
+    /** Max number of parameters. Default: 1000. Prevents parameter flooding DoS. */
+    parameterLimit?: number;
+    /** Max nesting depth for bracket syntax. Default: 32. Prevents deep-nesting DoS. */
+    depth?: number;
+}
+
+export interface TextParserOptions extends BodyParserOptions {
+    /** Fallback character encoding when Content-Type has no charset. Default: 'utf8'. */
+    encoding?: BufferEncoding;
+}
+
+export interface MultipartOptions {
+    /** Upload directory (default: OS temp). */
+    dir?: string;
+    /** Maximum size per file in bytes. */
+    maxFileSize?: number;
+    /** Reject non-HTTPS requests with 403. */
+    requireSecure?: boolean;
+    /** Maximum number of non-file fields. Default: 1000. */
+    maxFields?: number;
+    /** Maximum number of uploaded files. Default: 10. */
+    maxFiles?: number;
+    /** Maximum size of a single field value in bytes. Default: 1 MB. */
+    maxFieldSize?: number;
+    /** Whitelist of allowed MIME types for uploaded files (e.g. ['image/png', 'image/jpeg']). */
+    allowedMimeTypes?: string[];
+    /** Maximum combined size of all uploaded files in bytes. */
+    maxTotalSize?: number;
+}
+
+export interface MultipartFile {
+    originalFilename: string;
+    storedName: string;
+    path: string;
+    contentType: string;
+    size: number;
+}
+
+export function json(options?: JsonParserOptions): MiddlewareFunction;
+export function urlencoded(options?: UrlencodedParserOptions): MiddlewareFunction;
+export function text(options?: TextParserOptions): MiddlewareFunction;
+export function raw(options?: BodyParserOptions): MiddlewareFunction;
+export function multipart(options?: MultipartOptions): MiddlewareFunction;

package/types/cli.d.ts

@@ -1,2 +1,40 @@
-// Re-exports for @zero-server/cli - CLI runner types
-export { CLI, runCLI } from './orm';
+// TypeScript declarations for the bundled CLI runner (`zs` / `zh`).
+//
+// The CLI lives in `lib/cli.js` and is published both as the `zs` /
+// `zh` bin scripts and as a programmatic API on the SDK.  It dispatches
+// ORM subcommands (`migrate`, `seed`, `make:*`) to `@zero-server/orm`
+// and `webrtc:*` subcommands to `@zero-server/webrtc`, but the runner
+// itself is scope-neutral - hence its own declaration file.
+
+/**
+ * CLI runner for the bundled `zs` command.
+ *
+ * Parses `process.argv`-style input, resolves a config file
+ * (`zero.config.js` / `.zero-server.js` / `.zero-http.js`), and
+ * dispatches to the matching subcommand handler.
+ */
+export class CLI {
+    constructor(argv?: string[]);
+
+    /** The first positional argument (subcommand name). Defaults to `"help"`. */
+    readonly command: string;
+
+    /** Remaining positional arguments after the subcommand. */
+    readonly args: string[];
+
+    /** Parsed `--flag=value` and `-f value` pairs. */
+    readonly flags: Map<string, string>;
+
+    /** Execute the parsed command.  Sets `process.exitCode` on failure. */
+    run(): Promise<void>;
+}
+
+/**
+ * One-shot helper: `new CLI(argv).run()`.
+ *
+ * @example
+ *   const { runCLI } = require('@zero-server/sdk');
+ *   await runCLI(['migrate']);
+ *   await runCLI(['make:model', 'User', '--dir=src/models']);
+ */
+export function runCLI(argv?: string[]): Promise<void>;

package/types/index.d.ts

@@ -97,8 +97,8 @@ export {
     StoredProcedure, StoredProcedureOptions, ProcedureParam,
     StoredFunction, StoredFunctionOptions,
     TriggerManager, TriggerDefinition,
-    CLI, runCLI,
 } from './orm';
+export { CLI, runCLI } from './cli';
 // Re-export validate from orm as schemaValidate to avoid collision with middleware validate
 export { validate as schemaValidate } from './orm';
 export {
@@ -161,7 +161,8 @@ import { Database, Model, Query } from './orm';
 import { TYPES, validateFKAction, validateCheck } from './orm';
 import { Migrator, QueryCache, Seeder, SeederRunner, Factory, Fake, defineMigration } from './orm';
 import { QueryProfiler, ReplicaManager } from './orm';
-import { TenantManager, AuditLog, PluginManager, StoredProcedure, StoredFunction, TriggerManager, CLI, runCLI } from './orm';
+import { TenantManager, AuditLog, PluginManager, StoredProcedure, StoredFunction, TriggerManager } from './orm';
+import { CLI, runCLI } from './cli';
 import { LifecycleManager, LIFECYCLE_STATE } from './lifecycle';
 import { ClusterManager, cluster as clusterize } from './cluster';
 import {

package/types/middleware.d.ts

@@ -21,77 +21,23 @@ export interface CorsOptions {
 export function cors(options?: CorsOptions): MiddlewareFunction;
 
 // --- Body Parsers ------------------------------------------------
-
-export interface BodyParserOptions {
-    /** Max body size (e.g. '10kb', '1mb'). Default: '1mb'. */
-    limit?: string | number;
-    /** Content-Type(s) to match. Accepts a string, an array of strings, or a predicate function. */
-    type?: string | string[] | ((ct: string) => boolean);
-    /** Reject non-HTTPS requests with 403. */
-    requireSecure?: boolean;
-    /**
-     * Verification callback invoked with the raw buffer before parsing.
-     * Throw an error to reject the request with 403.
-     * Useful for webhook signature verification (e.g. Stripe, GitHub).
-     */
-    verify?: (req: import('./request').Request, res: import('./response').Response, buf: Buffer, encoding: string) => void;
-    /** Decompress gzip/deflate/br request bodies. Default: true. When false, compressed bodies return 415. */
-    inflate?: boolean;
-}
-
-export interface JsonParserOptions extends BodyParserOptions {
-    /** JSON.parse reviver function. */
-    reviver?: (key: string, value: any) => any;
-    /** Reject non-object/array roots. Default: true. */
-    strict?: boolean;
-}
-
-export interface UrlencodedParserOptions extends BodyParserOptions {
-    /** Enable nested bracket parsing. Default: false. */
-    extended?: boolean;
-    /** Max number of parameters. Default: 1000. Prevents parameter flooding DoS. */
-    parameterLimit?: number;
-    /** Max nesting depth for bracket syntax. Default: 32. Prevents deep-nesting DoS. */
-    depth?: number;
-}
-
-export interface TextParserOptions extends BodyParserOptions {
-    /** Fallback character encoding when Content-Type has no charset. Default: 'utf8'. */
-    encoding?: BufferEncoding;
-}
-
-export interface MultipartOptions {
-    /** Upload directory (default: OS temp). */
-    dir?: string;
-    /** Maximum size per file in bytes. */
-    maxFileSize?: number;
-    /** Reject non-HTTPS requests with 403. */
-    requireSecure?: boolean;
-    /** Maximum number of non-file fields. Default: 1000. */
-    maxFields?: number;
-    /** Maximum number of uploaded files. Default: 10. */
-    maxFiles?: number;
-    /** Maximum size of a single field value in bytes. Default: 1 MB. */
-    maxFieldSize?: number;
-    /** Whitelist of allowed MIME types for uploaded files (e.g. ['image/png', 'image/jpeg']). */
-    allowedMimeTypes?: string[];
-    /** Maximum combined size of all uploaded files in bytes. */
-    maxTotalSize?: number;
-}
-
-export interface MultipartFile {
-    originalFilename: string;
-    storedName: string;
-    path: string;
-    contentType: string;
-    size: number;
-}
-
-export function json(options?: JsonParserOptions): MiddlewareFunction;
-export function urlencoded(options?: UrlencodedParserOptions): MiddlewareFunction;
-export function text(options?: TextParserOptions): MiddlewareFunction;
-export function raw(options?: BodyParserOptions): MiddlewareFunction;
-export function multipart(options?: MultipartOptions): MiddlewareFunction;
+// Declarations live in `./body` so the standalone `@zero-server/body`
+// package has its own self-contained type file.  Re-exported here so
+// callers using the aggregate middleware surface continue to work.
+
+export {
+    BodyParserOptions,
+    JsonParserOptions,
+    UrlencodedParserOptions,
+    TextParserOptions,
+    MultipartOptions,
+    MultipartFile,
+    json,
+    urlencoded,
+    text,
+    raw,
+    multipart,
+} from './body';
 
 // --- Rate Limiting -----------------------------------------------
 

package/types/orm.d.ts

@@ -1875,13 +1875,4 @@ export class TriggerManager {
     get(name: string): TriggerDefinition | undefined;
 }
 
-// --- CLI (Phase 4) --------------------------------------------------
-
-export class CLI {
-    constructor(argv?: string[]);
-    /** Run the CLI command. */
-    run(): Promise<void>;
-}
-
-/** Create and run the CLI. */
-export function runCLI(argv?: string[]): Promise<void>;
+// CLI declarations live in `./cli` (re-exported from `./index`).