blendsdk 5.33.0

package/README.md

@@ -0,0 +1,125 @@
+# blendsdk
+
+[![npm version](https://img.shields.io/npm/v/blendsdk.svg)](https://www.npmjs.com/package/blendsdk)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![Node.js >= 22.0.0](https://img.shields.io/badge/node-%3E%3D22.0.0-brightgreen.svg)](https://nodejs.org/)
+
+Enterprise-grade TypeScript SDK for web applications, database operations, caching, pub/sub, email, i18n, and code generation.
+
+## Installation
+
+```bash
+npm install blendsdk
+```
+
+## Available Modules
+
+| Module | Import | Description | Peer Deps Required |
+| --- | --- | --- | --- |
+| stdlib | `blendsdk/stdlib` | Type guards, utilities, helpers | — |
+| cmdline | `blendsdk/cmdline` | CLI argument parser | — |
+| expression | `blendsdk/expression` | Immutable SQL WHERE clause builder | — |
+| dbcore | `blendsdk/dbcore` | Database abstractions, CRUD statement builders | — |
+| postgresql | `blendsdk/postgresql` | PostgreSQL client + connection pooling | `pg`, `yesql` |
+| webafx | `blendsdk/webafx` | Express 5 web framework with DI, plugins, routing | `express`, `cors`, `helmet`, `cookie-parser` |
+| webafx-cache | `blendsdk/webafx-cache` | Caching + pub/sub (Redis and in-memory backends) | `ioredis` |
+| webafx-mailer | `blendsdk/webafx-mailer` | Email sending (SMTP and in-memory backends) | `nodemailer` |
+| webafx-auth | `blendsdk/webafx-auth` | Token validation plugin (JWT/OIDC) | `jose` |
+| i18n | `blendsdk/i18n` | Internationalization core (Translator, catalogs) | — |
+| i18n-node | `blendsdk/i18n-node` | i18n Node.js sources (JSON files, content files) | — |
+| webafx-i18n | `blendsdk/webafx-i18n` | i18n webafx plugin (locale resolution) | — |
+| codegen | `blendsdk/codegen` | Code generators (TypeScript, Zod, OpenAPI, SQL) | `pg`, `postgres-array` |
+
+## Quick Start
+
+### Web API with Express 5
+
+```typescript
+import { Application, RouteBuilder } from "blendsdk/webafx";
+
+const app = new Application({ port: 3000 });
+
+app.addRoute(
+  RouteBuilder.get("/hello", (req, res) => {
+    res.json({ message: "Hello from BlendSDK!" });
+  })
+);
+
+await app.start();
+```
+
+### SQL Query Building
+
+```typescript
+import { query } from "blendsdk/expression";
+import { SelectStatement } from "blendsdk/dbcore";
+
+// Build a type-safe WHERE clause
+const filter = query()
+  .field("status")
+  .eq("active")
+  .and()
+  .field("age")
+  .gte(18);
+
+// Use it in a SELECT statement
+const stmt = new SelectStatement("users")
+  .columns("id", "name", "email")
+  .where(filter);
+
+const { sql, parameters } = stmt.compile();
+// sql: SELECT id, name, email FROM users WHERE status = $1 AND age >= $2
+// parameters: ["active", 18]
+```
+
+### Utilities
+
+```typescript
+import { isNullOrUndefined, isString } from "blendsdk/stdlib";
+
+const value: unknown = getUserInput();
+
+if (!isNullOrUndefined(value) && isString(value)) {
+  console.log("Got a string:", value);
+}
+```
+
+## Peer Dependencies
+
+Install only the peer dependencies for the modules you use:
+
+```bash
+# Web framework (webafx)
+npm install express cors helmet cookie-parser
+
+# PostgreSQL database (postgresql, codegen)
+npm install pg yesql
+
+# Redis caching + pub/sub (webafx-cache)
+npm install ioredis
+
+# Email sending (webafx-mailer)
+npm install nodemailer
+
+# Authentication — JWT/OIDC (webafx-auth)
+npm install jose
+
+# Code generation (codegen)
+npm install pg postgres-array
+```
+
+## Requirements
+
+- **Node.js** >= 22.0.0
+- **TypeScript** >= 5.6.0 (peer dependency)
+- **ESM only** — this package uses `"type": "module"`
+
+## Links
+
+- [GitHub Repository](https://github.com/blendsdk/blendsdk)
+- [Contributing Guide](https://github.com/blendsdk/blendsdk/blob/main/CONTRIBUTING.md)
+- [License (MIT)](https://github.com/blendsdk/blendsdk/blob/main/LICENSE)
+
+## Author
+
+[TrueSoftware B.V.](https://truesoftware.nl)

package/dist/cmdline/cmdline.d.ts

@@ -0,0 +1,144 @@
+import { ICommand, ICommandLineParser, ICommandOption, IToken } from './types.js';
+/**
+ * @export
+ * @class CommandLineParser
+ */
+export declare class CommandLineParser {
+    /**
+     * @protected
+     * @type {ICommandLineParser}
+     * @memberof CommandLineParser
+     */
+    protected config: ICommandLineParser;
+    /**
+     * @protected
+     * @type {string}
+     * @memberof CommandLineParser
+     */
+    protected interpreter: string;
+    /**
+     * @protected
+     * @type {string}
+     * @memberof CommandLineParser
+     */
+    protected script: string;
+    /**
+     * @protected
+     * @type {string}
+     * @memberof CommandLineParser
+     */
+    protected scriptName: string;
+    /**
+     * @protected
+     * @type {ICommand[]}
+     * @memberof CommandLineParser
+     */
+    protected commands: ICommand[];
+    /**
+     * @protected
+     * @type {IDictionaryOf<IDictionaryOf<any>>}
+     * @memberof CommandLineParser
+     */
+    protected optionValues: Record<string, Record<string, any>>;
+    /**
+     * References the current running command
+     *
+     * @protected
+     * @memberof CommandLineParser
+     */
+    protected currentCommand: ICommand | undefined;
+    /**
+     * Creates an instance of CommandLineParser.
+     * @param {ICommandLineParser} [config]
+     * @memberof CommandLineParser
+     */
+    constructor(config?: ICommandLineParser);
+    /**
+     * @protected
+     * @param {string[][]} table
+     * @memberof CommandLineParser
+     */
+    protected print(table: string[][]): void;
+    /**
+     * Handles quoted arguments and special characters
+     * @protected
+     * @param {string} arg
+     * @return {string}
+     * @memberof CommandLineParser
+     */
+    protected processQuotedArgument(arg: string): string;
+    /**
+     * Validates argument format and handles malformed arguments
+     * @protected
+     * @param {string} arg
+     * @memberof CommandLineParser
+     */
+    protected validateArgument(arg: string): void;
+    /**
+     * @protected
+     * @return {IToken[]}
+     * @memberof CommandLineParser
+     */
+    protected parseTokens(): IToken[];
+    /**
+     * @protected
+     * @memberof CommandLineParser
+     */
+    protected prepare(): void;
+    /**
+     * @protected
+     * @param {string} command
+     * @param {ICommandOption} option
+     * @param {any} value
+     * @memberof CommandLineParser
+     */
+    protected setOptionValue(command: string, option: ICommandOption, value: any): void;
+    /**
+     * @protected
+     * @param {IToken[]} options
+     * @return {object}
+     * @memberof CommandLineParser
+     */
+    protected validate(options: IToken[]): {
+        errors: string[];
+        command?: ICommand;
+    };
+    /**
+     * @protected
+     * @param {ICommand | undefined} command
+     * @param {string[]} errors
+     * @param {boolean} isHelp
+     * @memberof CommandLineParser
+     */
+    protected help(command: ICommand | undefined, errors: string[], isHelp: boolean): void;
+    /**
+     * Execute the command line parser
+     * @param {any} [context]
+     * @return {Promise<any>}
+     * @memberof CommandLineParser
+     */
+    execute(context?: any): Promise<any>;
+    /**
+     * Validates command configuration for circular dependencies and conflicts
+     * @protected
+     * @param {ICommand} command
+     * @memberof CommandLineParser
+     */
+    protected validateCommandConfiguration(command: ICommand): void;
+    /**
+     * Validates options configuration for conflicts and format
+     * @protected
+     * @param {ICommandOption[]} options
+     * @param {string} commandName
+     * @memberof CommandLineParser
+     */
+    protected validateOptionsConfiguration(options: ICommandOption[], commandName: string): void;
+    /**
+     * Add a command to the parser
+     * @param {ICommand} config
+     * @return {CommandLineParser}
+     * @memberof CommandLineParser
+     */
+    addCommand(config: ICommand): CommandLineParser;
+}
+//# sourceMappingURL=cmdline.d.ts.map

package/dist/cmdline/cmdline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmdline.d.ts","sourceRoot":"","sources":["../src/cmdline.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAQlF;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACrC;;;;OAIG;IACH,SAAS,CAAC,WAAW,EAAE,MAAM,CAAC;IAC9B;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC;IAC7B;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC;IAC/B;;;;OAIG;IACH,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IAE5D;;;;;OAKG;IACH,SAAS,CAAC,cAAc,EAAE,QAAQ,GAAG,SAAS,CAAC;IAE/C;;;;OAIG;gBACgB,MAAM,CAAC,EAAE,kBAAkB;IAW9C;;;;OAIG;IACH,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI;IA6BxC;;;;;;OAMG;IACH,SAAS,CAAC,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAUpD;;;;;OAKG;IACH,SAAS,CAAC,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAoB7C;;;;OAIG;IACH,SAAS,CAAC,WAAW,IAAI,MAAM,EAAE;IAsLjC;;;OAGG;IACH,SAAS,CAAC,OAAO,IAAI,IAAI;IAOzB;;;;;;OAMG;IACH,SAAS,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAenF;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG;QAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE,QAAQ,CAAA;KAAE;IAkJ/E;;;;;;OAMG;IACH,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IA2DtF;;;;;OAKG;IACU,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IA6CjD;;;;;OAKG;IACH,SAAS,CAAC,4BAA4B,CAAC,OAAO,EAAE,QAAQ,GAAG,IAAI;IAuC/D;;;;;;OAMG;IACH,SAAS,CAAC,4BAA4B,CAAC,OAAO,EAAE,cAAc,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAkG5F;;;;;OAKG;IACI,UAAU,CAAC,MAAM,EAAE,QAAQ,GAAG,iBAAiB;CA0BvD"}