namirasoft-site 1.4.44 → 1.4.46

package/SKILL.md

@@ -0,0 +1,184 @@
+---
+name: namirasoft-site
+description: Use the namirasoft-site package when modeling a Namirasoft product as a typed metadata graph (database -> tables -> rows) with shared HTTP versioning. Trigger when the project's package.json depends on "namirasoft-site", when subclassing NSBaseServer / NSBaseMetaDatabase / NSBaseMetaTable, when wiring an axios-based product client that must send the ns-site-version header, when generating route URLs (list/new/view/edit) for a product table, or when parsing a Namirasoft package/API/console name with NSNameParser. Skip for pure UI work — that lives in namirasoft-site-react.
+---
+
+# namirasoft-site
+
+The framework-agnostic "site" layer for Namirasoft products. It extends `namirasoft-core`'s `BaseServer` / `BaseMetaDatabase` / `BaseMetaTable` with product-aware metadata, link generation, and a shared `ns-site-version` request header convention. There is no UI here — `namirasoft-site-react` is the React companion.
+
+## When this skill applies
+
+Trigger when the project's `package.json` lists `namirasoft-site` as a dependency, or when the user imports anything from `"namirasoft-site"`. Typical signals:
+
+- defining a new product's database/table metadata (`class FooDatabase extends NSBaseMetaDatabase<FooServer>`)
+- writing an axios client that must propagate or read the `ns-site-version` header
+- generating product-relative URLs (`/foo/list`, `/foo/{id}/view`, `/foo/{id}/edit`)
+- introspecting a Namirasoft package/repo name to derive class names, short names, or CLI command names
+
+Skip for plain backend services that don't model a product, and for UI rendering (use `namirasoft-site-react`).
+
+## Cardinal rules
+
+1. **Reuse the base classes — don't reimplement.** Every product server extends `NSBaseServer`, every product database extends `NSBaseMetaDatabase<YourServer>`, every product table extends `NSBaseMetaTable<YourServer, Row>`. Don't hand-roll axios clients or metadata containers; subclass these so version-header wiring, link generation, and CFT (category/field/tag) sibling-table detection come for free.
+2. **Always import from the package root**: `import { NSBaseServer, NSHeader } from "namirasoft-site";` — never deep-import from `dist/...`.
+3. **Override `NSBaseMetaDatabase.getServerBaseURL`** (the static method) at app bootstrap before any server is instantiated. The default throws. The React companion sets this from `REACT_APP_BASE_URL_<X>` env vars; non-React consumers must provide their own resolver.
+4. **The version header is `ns-site-version` for both request and response.** Use `NSHeader.req.VERSION()` / `NSHeader.res.VERSION()` instead of hard-coding the string. `NSBaseServer` already attaches it via `addOnBeforeRequest` / `addOnAfterRequest` in its constructor — don't re-register the same hooks in subclasses.
+5. **Pass the product to the database constructor.** `NSBaseMetaDatabase` requires `{ id, name, headline, description, logo, link }`; `link` is the URL prefix that `NSBaseMetaTable_Frontend.getBaseLink()` joins against.
+6. **Use `NamingConvention.lower_case_dash` for CFT lookups.** `isCFTTable()` / `hasFieldTables()` already do; if you call the static helpers (`getCFTTables`, `HasCFTTable`, `IsCFTTable`) directly, pass a `NamingConvention` from `namirasoft-core` — the helpers normalize on your behalf.
+7. **Treat `NSBaseMetaTable_Backend<Row>` slots as optional.** Each verb has both an underscore-prefixed (raw) and bare (wrapped) slot: `_get`/`get`, `_list`/`list`, `_create`/`create`, `_update`/`update`, `_delete`/`delete`. Wire only the verbs the API actually supports; consumers must null-check before calling.
+
+## API surface
+
+All exports come from the package root.
+
+### Servers
+
+- **`NSBaseServer`** (abstract, extends `BaseServer` from `namirasoft-core`) — axios-based product client.
+  - `constructor(base_url: string, version: string)` — registers before/after-request hooks that set the request `ns-site-version` header to `version` and capture the response's version into `this.backend.version`.
+  - `backend: { version: string }` — last-seen backend version, populated after each response.
+  - Static helpers: `onBeforeRequest_SetVersion(version, config)`, `onAfterRequest_GetVersion(res)` — usable standalone if you need the same wiring outside an `NSBaseServer` subclass.
+
+### Metadata
+
+- **`NSBaseMetaDatabase<Server extends NSBaseServer>`** (abstract, extends `BaseMetaDatabase`) — container for a product's tables.
+  - `static getServerBaseURL(product_name: string): string` — override this once at module load to map a product name to its base URL. Default throws.
+  - `product: { id, name, headline, description, logo, link }` — set via constructor.
+  - `tables: { [name: string]: NSBaseMetaTable<Server, any> }` — populate in your subclass.
+  - `abstract getServer(): Server` — returns the singleton server for this database.
+  - `getByShortName(short)` / `getByShortNameOrNull(short)` — look up a table by `uuid.short`.
+
+- **`NSBaseMetaTable<Server, Row>`** (abstract, extends `BaseMetaTable`) — one product table.
+  - `constructor(database, name, text, uuid: BaseUUID)` — auto-creates `front_end` and `back_end`.
+  - `front_end: NSBaseMetaTable_Frontend`, `back_end: NSBaseMetaTable_Backend<Row>`.
+  - `isCFTTable()` / `hasFieldTables()` — detect category/field/tag siblings (`<name>_category`, `<name>_field`, `<name>_tag`).
+  - Static helpers: `getTableAndCFTs`, `getTableAndCFTsIfExists`, `getCFTTables`, `getCFTTablesIfExists`, `HasCFTTable`, `IsCFTTable`.
+
+- **`NSBaseMetaTable_Frontend`** — link builder bound to a table.
+  - `getBaseLink()` -> `<product.link>/<table-in-slash-case>`
+  - `getListLink()` -> `<base>/list`
+  - `getNewLink()`  -> `<base>/new`
+  - `getViewLink(id)` -> `<base>/<id>/view`
+  - `getUpdateLink(id)` -> `<base>/<id>/edit`
+
+- **`NSBaseMetaTable_Backend<Row>`** — optional CRUD adapter slots: `_get`/`get`, `_list`/`list`, `_create`/`create`, `_update`/`update`, `_delete`/`delete`. The `_*` variants are the raw API call; the bare ones are the wrapped/cached version. Both signatures match `namirasoft-core`'s `FilterItem` / `SortItem`.
+
+### Headers
+
+- **`NSHeader`** — namespace with three static fields:
+  - `NSHeader.req: NSReqHeader` — `req.VERSION()` returns `"ns-site-version"`.
+  - `NSHeader.res: NSResHeader` — `res.VERSION()` returns `"ns-site-version"`.
+  - `NSHeader.cookies: NSCookiesHeader` — currently empty, reserved.
+- **`NSReqHeader`**, **`NSResHeader`**, **`NSCookiesHeader`** — exported individually if you need to extend.
+
+### Name parsing
+
+- **`NSNameParser(name_full, title_full)`** — classifies a Namirasoft repo/package name and extracts canonical short/long forms.
+  - Booleans: `isAPI`, `isConsole`, `isLibrary`, `isNPM`, `isPHP`, `isAccountAPI`.
+  - Per-kind structures (`api`, `console`, `library`) of type `NSNameParserStructure` with `name_namirasoft`, `name_short`, `title_namirasoft`, `title_short`, `class_namirasoft`, `class_short`.
+  - `command.name` — derived CLI command (`namirasoft-` -> `ns-`).
+  - Detection regexes: API matches `^namirasoft(-\w*)*-api(-\w*)*-v\d+$`, Console matches `^namirasoft-(\w+-)+console$`, Library is the residual `^namirasoft-\w+`. NPM/PHP are inferred from `title_full` ending in `NPM Package` / `PHP Package`.
+
+## Canonical examples
+
+### Subclassing `NSBaseServer`
+
+```ts
+import { NSBaseServer } from "namirasoft-site";
+
+export class FooServer extends NSBaseServer {
+    constructor(base_url: string, version: string) {
+        super(base_url, version);
+        // version header + backend.version capture are wired by the parent
+    }
+
+    public listFoos = () => this.axios.get("/foo");
+}
+```
+
+Don't re-register `addOnBeforeRequest` / `addOnAfterRequest` for versioning — `NSBaseServer`'s constructor already does it. Read the latest backend version from `this.backend.version` after any request.
+
+### Defining a product database + table
+
+```ts
+import { NSBaseMetaDatabase, NSBaseMetaTable } from "namirasoft-site";
+import { BaseUUID } from "namirasoft-core";
+import { FooServer } from "./FooServer";
+
+class FooTable extends NSBaseMetaTable<FooServer, { id: string; name: string }> {
+    constructor(db: FooDatabase) {
+        super(db, "foo", "Foo", new BaseUUID(/* ... */));
+        this.back_end._list = async (filters, page, size, sorts) => {
+            const res = await db.getServer().listFoos();
+            return { rows: res.data, count: res.data.length };
+        };
+        this.back_end.list = this.back_end._list;
+    }
+}
+
+export class FooDatabase extends NSBaseMetaDatabase<FooServer> {
+    private server: FooServer;
+    constructor() {
+        super({
+            id: "foo",
+            name: "foo",
+            headline: "Foo headline",
+            description: "Foo description",
+            logo: "/logo.png",
+            link: "/foo",
+        });
+        this.server = new FooServer(
+            NSBaseMetaDatabase.getServerBaseURL("namirasoft-foo"),
+            "1.0.0",
+        );
+        this.tables["foo"] = new FooTable(this);
+    }
+    getServer() { return this.server; }
+}
+```
+
+Once instantiated, `database.tables["foo"].front_end.getViewLink("123")` yields `"/foo/foo/123/view"`.
+
+### Registering the base-URL resolver
+
+```ts
+import { NSBaseMetaDatabase } from "namirasoft-site";
+
+NSBaseMetaDatabase.getServerBaseURL = (product_name: string) => {
+    const key = product_name.replace(/^namirasoft-/, "").replace(/-/g, "_").toUpperCase();
+    const url = process.env[`BASE_URL_${key}`];
+    if (!url) throw new Error(`Missing BASE_URL_${key} for ${product_name}`);
+    return url;
+};
+```
+
+Do this once at app bootstrap, before any `NSBaseMetaDatabase` subclass is constructed.
+
+### Parsing a package name
+
+```ts
+import { NSNameParser } from "namirasoft-site";
+
+const p = new NSNameParser("namirasoft-account-api-v3", "Namirasoft Account API V3");
+p.isAPI;                  // true
+p.isAccountAPI;           // true
+p.api.name_short;         // "account"
+p.api.class_namirasoft;   // "NamirasoftAccount"
+p.command.name;           // "ns-account"
+```
+
+## Common mistakes to avoid
+
+- Hand-rolling an axios client with a hard-coded `"ns-site-version"` string instead of subclassing `NSBaseServer` and using `NSHeader.req.VERSION()`.
+- Leaving `NSBaseMetaDatabase.getServerBaseURL` at its default — instantiating any database will throw with `"NSBaseMetaDatabase.getServerBaseURL was not overriden"`.
+- Calling `back_end.get?.(id)` without null-checking — every CRUD slot is optional.
+- Using `className`-style slash-cased table names directly in URLs; `NSBaseMetaTable_Frontend` already converts `lower_case_underscore` -> `lower_case_slash` via `NamingConvention`.
+- Re-adding `addOnBeforeRequest` / `addOnAfterRequest` for versioning in an `NSBaseServer` subclass — duplicates the header write.
+- Importing `BaseServer`, `BaseMetaTable`, `BaseUUID`, `NamingConvention`, `FilterItem`, `SortItem` from `"namirasoft-site"` — they live in `namirasoft-core`. This package only re-exports its own `NS*` extensions.
+- Treating `NSCookiesHeader` as having members — it is currently an empty placeholder.
+
+## Peer expectations
+
+- **Runtime deps**: `namirasoft-core` (^1.4.108), `axios` (^1.13.x). Both are required peers in practice — `BaseServer`, `BaseMetaTable`, `BaseUUID`, `NamingConvention`, `FilterItem`, `SortItem` all come from `namirasoft-core`.
+- **No framework binding**: this package is framework-agnostic (Node or browser). Consumers needing React UI should pair it with `namirasoft-site-react`, which depends on this package.
+- **No env vars are read directly** — `getServerBaseURL` is a static hook the host app must implement. The React companion wires it to `REACT_APP_BASE_URL_<X>`; backend hosts typically wire it to `process.env.BASE_URL_<X>`.

package/package.json

@@ -8,7 +8,7 @@
     "framework": "npm",
     "application": "package",
     "private": false,
-    "version": "1.4.44",
+    "version": "1.4.46",
     "author": "Amir Abolhasani",
     "license": "MIT",
     "main": "./dist/index.js",
@@ -17,7 +17,7 @@
         "build": ""
     },
     "dependencies": {
-        "axios": "^1.13.2",
-        "namirasoft-core": "^1.4.108"
+        "axios": "^1.18.1",
+        "namirasoft-core": "^1.4.120"
     }
 }

package/src/NSBaseMetaDatabase.ts

@@ -1,69 +1,69 @@
-import { BaseMetaDatabase } from "namirasoft-core";
-import { NSBaseMetaTable } from "./NSBaseMetaTable";
-import { NSBaseServer } from "./NSBaseServer";
-
-export abstract class NSBaseMetaDatabase<Server extends NSBaseServer> extends BaseMetaDatabase
-{
-    public static getServerBaseURL(product_name: string): string
-    {
-        throw new Error(`NSBaseMetaDatabase.getServerBaseURL was not overriden. Requested: ${product_name}`);
-    }
-    override tables: { [name: string]: NSBaseMetaTable<Server, any>; } = {};
-    public product: {
-        id: string;
-        name: string;
-        headline: string;
-        description: string;
-        logo: string;
-        link: string;
-    };
-    public abstract getServer(): Server;
-    constructor(product: {
-        id: string;
-        name: string;
-        headline: string;
-        description: string;
-        logo: string;
-        link: string;
-    })
-    {
-        super();
-        this.product = product;
-    }
-    getByShortNameOrNull(short_name: string):
-        {
-            product: {
-                id: string;
-                name: string;
-                headline: string;
-                description: string;
-                logo: string;
-                link: string;
-            };
-            table: NSBaseMetaTable<NSBaseServer, any>;
-        } | null
-    {
-        for (let table in this.tables)
-            if (this.tables[table].uuid.short === short_name)
-                return { product: this.product, table: this.tables[table] };
-        return null;
-    }
-    getByShortName(short_name: string):
-        {
-            product: {
-                id: string;
-                name: string;
-                headline: string;
-                description: string;
-                logo: string;
-                link: string;
-            };
-            table: NSBaseMetaTable<NSBaseServer, any>;
-        }
-    {
-        let ans = this.getByShortNameOrNull(short_name);
-        if (ans)
-            return ans;
-        throw new Error(`Result could not be found for short name: ${short_name}`);
-    }
+import { BaseMetaDatabase } from "namirasoft-core";
+import { NSBaseMetaTable } from "./NSBaseMetaTable";
+import { NSBaseServer } from "./NSBaseServer";
+
+export abstract class NSBaseMetaDatabase<Server extends NSBaseServer> extends BaseMetaDatabase
+{
+    public static getServerBaseURL(product_name: string): string
+    {
+        throw new Error(`NSBaseMetaDatabase.getServerBaseURL was not overriden. Requested: ${product_name}`);
+    }
+    override tables: { [name: string]: NSBaseMetaTable<Server, any>; } = {};
+    public product: {
+        id: string;
+        name: string;
+        headline: string;
+        description: string;
+        logo: string;
+        link: string;
+    };
+    public abstract getServer(): Server;
+    constructor(product: {
+        id: string;
+        name: string;
+        headline: string;
+        description: string;
+        logo: string;
+        link: string;
+    })
+    {
+        super();
+        this.product = product;
+    }
+    getByShortNameOrNull(short_name: string):
+        {
+            product: {
+                id: string;
+                name: string;
+                headline: string;
+                description: string;
+                logo: string;
+                link: string;
+            };
+            table: NSBaseMetaTable<NSBaseServer, any>;
+        } | null
+    {
+        for (let table in this.tables)
+            if (this.tables[table].uuid.short === short_name)
+                return { product: this.product, table: this.tables[table] };
+        return null;
+    }
+    getByShortName(short_name: string):
+        {
+            product: {
+                id: string;
+                name: string;
+                headline: string;
+                description: string;
+                logo: string;
+                link: string;
+            };
+            table: NSBaseMetaTable<NSBaseServer, any>;
+        }
+    {
+        let ans = this.getByShortNameOrNull(short_name);
+        if (ans)
+            return ans;
+        throw new Error(`Result could not be found for short name: ${short_name}`);
+    }
 };

package/src/NSBaseMetaTable.ts

@@ -1,75 +1,75 @@
-import { BaseMetaTable, BaseUUID, NamingConvention } from "namirasoft-core";
-import { NSBaseMetaTable_Frontend } from "./NSBaseMetaTable_Frontend";
-import { NSBaseMetaDatabase } from "./NSBaseMetaDatabase";
-import { NSBaseMetaTable_Backend } from "./NSBaseMetaTable_Backend";
-import { NSBaseServer } from "./NSBaseServer";
-
-export abstract class NSBaseMetaTable<Server extends NSBaseServer, Row> extends BaseMetaTable
-{
-    private static cft_tables = ["category", "field", "tag"];
-    static getTableAndCFTsIfExists(naming: NamingConvention, tables: string[], name: string): string[]
-    {
-        name = NamingConvention.auto.convert(name, naming);
-        tables = tables.map(t => NamingConvention.auto.convert(t, naming));
-        return NSBaseMetaTable.getTableAndCFTs(naming, name).filter(t => tables.includes(t));
-    }
-    static getTableAndCFTs(naming: NamingConvention, name: string): string[]
-    {
-        name = NamingConvention.auto.convert(name, naming);
-        return [name, ...NSBaseMetaTable.getCFTTables(naming, name)];
-    }
-    static getCFTTablesIfExists(naming: NamingConvention, tables: string[], name: string): string[]
-    {
-        name = NamingConvention.auto.convert(name, naming);
-        tables = tables.map(t => NamingConvention.auto.convert(t, naming));
-        return NSBaseMetaTable.getCFTTables(naming, name).filter(t => tables.includes(t));
-    }
-    static getCFTTables(naming: NamingConvention, name: string): string[]
-    {
-        name = NamingConvention.auto.convert(name, naming);
-        let tables = NSBaseMetaTable.cft_tables.map(cft => name + "_" + cft);
-        return tables.map(t => NamingConvention.auto.convert(t, naming));
-    }
-    static HasCFTTable(naming: NamingConvention, tables: string[], name: string): boolean
-    {
-        name = NamingConvention.auto.convert(name, naming);
-        tables = tables.map(t => NamingConvention.auto.convert(t, naming))
-        return NSBaseMetaTable.getCFTTables(naming, name).some(t => tables.includes(t));
-    }
-    static IsCFTTable(naming: NamingConvention, name: string): boolean
-    {
-        name = NamingConvention.auto.convert(name, naming);
-        for (let i = 0; i < NSBaseMetaTable.cft_tables.length; i++)
-        {
-            let table = NSBaseMetaTable.cft_tables[i];
-            table = NamingConvention.auto.convert(table, naming);
-            if (name !== table)
-                if (name.endsWith("_" + table))
-                    return true;
-        }
-        return false;
-    }
-
-    override database: NSBaseMetaDatabase<Server>;
-    public uuid: BaseUUID;
-    public front_end: NSBaseMetaTable_Frontend;
-    public back_end: NSBaseMetaTable_Backend<Row>;
-    constructor(database: NSBaseMetaDatabase<Server>, name: string, text: string, uuid: BaseUUID)
-    {
-        super(database, name, text);
-        this.database = database;
-        this.uuid = uuid;
-        this.front_end = new NSBaseMetaTable_Frontend(this, name);
-        this.back_end = new NSBaseMetaTable_Backend<Row>();
-    }
-    isCFTTable(): boolean
-    {
-        return NSBaseMetaTable.IsCFTTable(NamingConvention.lower_case_dash, this.name);
-    }
-    hasFieldTables(): boolean
-    {
-        if (this.database)
-            return NSBaseMetaTable.HasCFTTable(NamingConvention.lower_case_dash, Object.keys(this.database.tables), this.name);
-        return false;
-    }
+import { BaseMetaTable, BaseUUID, NamingConvention } from "namirasoft-core";
+import { NSBaseMetaTable_Frontend } from "./NSBaseMetaTable_Frontend";
+import { NSBaseMetaDatabase } from "./NSBaseMetaDatabase";
+import { NSBaseMetaTable_Backend } from "./NSBaseMetaTable_Backend";
+import { NSBaseServer } from "./NSBaseServer";
+
+export abstract class NSBaseMetaTable<Server extends NSBaseServer, Row> extends BaseMetaTable
+{
+    private static cft_tables = ["category", "field", "tag"];
+    static getTableAndCFTsIfExists(naming: NamingConvention, tables: string[], name: string): string[]
+    {
+        name = NamingConvention.auto.convert(name, naming);
+        tables = tables.map(t => NamingConvention.auto.convert(t, naming));
+        return NSBaseMetaTable.getTableAndCFTs(naming, name).filter(t => tables.includes(t));
+    }
+    static getTableAndCFTs(naming: NamingConvention, name: string): string[]
+    {
+        name = NamingConvention.auto.convert(name, naming);
+        return [name, ...NSBaseMetaTable.getCFTTables(naming, name)];
+    }
+    static getCFTTablesIfExists(naming: NamingConvention, tables: string[], name: string): string[]
+    {
+        name = NamingConvention.auto.convert(name, naming);
+        tables = tables.map(t => NamingConvention.auto.convert(t, naming));
+        return NSBaseMetaTable.getCFTTables(naming, name).filter(t => tables.includes(t));
+    }
+    static getCFTTables(naming: NamingConvention, name: string): string[]
+    {
+        name = NamingConvention.auto.convert(name, naming);
+        let tables = NSBaseMetaTable.cft_tables.map(cft => name + "_" + cft);
+        return tables.map(t => NamingConvention.auto.convert(t, naming));
+    }
+    static HasCFTTable(naming: NamingConvention, tables: string[], name: string): boolean
+    {
+        name = NamingConvention.auto.convert(name, naming);
+        tables = tables.map(t => NamingConvention.auto.convert(t, naming))
+        return NSBaseMetaTable.getCFTTables(naming, name).some(t => tables.includes(t));
+    }
+    static IsCFTTable(naming: NamingConvention, name: string): boolean
+    {
+        name = NamingConvention.auto.convert(name, naming);
+        for (let i = 0; i < NSBaseMetaTable.cft_tables.length; i++)
+        {
+            let table = NSBaseMetaTable.cft_tables[i];
+            table = NamingConvention.auto.convert(table, naming);
+            if (name !== table)
+                if (name.endsWith("_" + table))
+                    return true;
+        }
+        return false;
+    }
+
+    override database: NSBaseMetaDatabase<Server>;
+    public uuid: BaseUUID;
+    public front_end: NSBaseMetaTable_Frontend;
+    public back_end: NSBaseMetaTable_Backend<Row>;
+    constructor(database: NSBaseMetaDatabase<Server>, name: string, text: string, uuid: BaseUUID)
+    {
+        super(database, name, text);
+        this.database = database;
+        this.uuid = uuid;
+        this.front_end = new NSBaseMetaTable_Frontend(this, name);
+        this.back_end = new NSBaseMetaTable_Backend<Row>();
+    }
+    isCFTTable(): boolean
+    {
+        return NSBaseMetaTable.IsCFTTable(NamingConvention.lower_case_dash, this.name);
+    }
+    hasFieldTables(): boolean
+    {
+        if (this.database)
+            return NSBaseMetaTable.HasCFTTable(NamingConvention.lower_case_dash, Object.keys(this.database.tables), this.name);
+        return false;
+    }
 };

package/src/NSBaseMetaTable_Backend.ts

@@ -1,15 +1,15 @@
-import { FilterItem, SortItem } from "namirasoft-core";
-
-export class NSBaseMetaTable_Backend<Row>
-{
-    _get?: (id: string) => Promise<Row>;
-    get?: (id: string) => Promise<Row>;
-    _list?: (filters: FilterItem[] | null, page: (number | null), size: (number | null), sorts: SortItem[]) => Promise<{ rows: Row[], count: number }>;
-    list?: (filters: FilterItem[] | null, page: (number | null), size: (number | null), sorts: SortItem[]) => Promise<{ rows: Row[], count: number }>;
-    _create?: (body: any) => Promise<any>;
-    create?: (body: any) => Promise<any>;
-    _update?: (id: string, body: any) => Promise<Row>;
-    update?: (id: string, body: any) => Promise<Row>;
-    _delete?: (id: string) => Promise<void>;
-    delete?: (id: string) => Promise<void>;
+import { FilterItem, SortItem } from "namirasoft-core";
+
+export class NSBaseMetaTable_Backend<Row>
+{
+    _get?: (id: string) => Promise<Row>;
+    get?: (id: string) => Promise<Row>;
+    _list?: (filters: FilterItem[] | null, page: (number | null), size: (number | null), sorts: SortItem[]) => Promise<{ rows: Row[], count: number }>;
+    list?: (filters: FilterItem[] | null, page: (number | null), size: (number | null), sorts: SortItem[]) => Promise<{ rows: Row[], count: number }>;
+    _create?: (body: any) => Promise<any>;
+    create?: (body: any) => Promise<any>;
+    _update?: (id: string, body: any) => Promise<Row>;
+    update?: (id: string, body: any) => Promise<Row>;
+    _delete?: (id: string) => Promise<void>;
+    delete?: (id: string) => Promise<void>;
 };

package/src/NSBaseMetaTable_Frontend.ts

@@ -1,38 +1,38 @@
-import { NamingConvention } from "namirasoft-core";
-import { NSBaseMetaTable } from "./NSBaseMetaTable";
-
-export class NSBaseMetaTable_Frontend
-{
-    private table: NSBaseMetaTable<any, any>;
-    private base: string;
-    constructor(table: NSBaseMetaTable<any, any>, name: string)
-    {
-        this.table = table;
-        this.base = NamingConvention.lower_case_underscore.convert(name, NamingConvention.lower_case_slash)
-        this.getBaseLink = this.getBaseLink.bind(this);
-        this.getListLink = this.getListLink.bind(this);
-        this.getNewLink = this.getNewLink.bind(this);
-        this.getViewLink = this.getViewLink.bind(this);
-        this.getUpdateLink = this.getUpdateLink.bind(this);
-    }
-    public getBaseLink(): string
-    {
-        return this.table.database.product.link + "/" + this.base;
-    }
-    public getListLink(): string
-    {
-        return this.getBaseLink() + "/list";
-    }
-    public getNewLink(): string
-    {
-        return this.getBaseLink() + "/new";
-    }
-    public getViewLink(id: string): string
-    {
-        return this.getBaseLink() + "/" + id + "/view";
-    }
-    public getUpdateLink(id: string): string
-    {
-        return this.getBaseLink() + "/" + id + "/edit";
-    }
+import { NamingConvention } from "namirasoft-core";
+import { NSBaseMetaTable } from "./NSBaseMetaTable";
+
+export class NSBaseMetaTable_Frontend
+{
+    private table: NSBaseMetaTable<any, any>;
+    private base: string;
+    constructor(table: NSBaseMetaTable<any, any>, name: string)
+    {
+        this.table = table;
+        this.base = NamingConvention.lower_case_underscore.convert(name, NamingConvention.lower_case_slash)
+        this.getBaseLink = this.getBaseLink.bind(this);
+        this.getListLink = this.getListLink.bind(this);
+        this.getNewLink = this.getNewLink.bind(this);
+        this.getViewLink = this.getViewLink.bind(this);
+        this.getUpdateLink = this.getUpdateLink.bind(this);
+    }
+    public getBaseLink(): string
+    {
+        return this.table.database.product.link + "/" + this.base;
+    }
+    public getListLink(): string
+    {
+        return this.getBaseLink() + "/list";
+    }
+    public getNewLink(): string
+    {
+        return this.getBaseLink() + "/new";
+    }
+    public getViewLink(id: string): string
+    {
+        return this.getBaseLink() + "/" + id + "/view";
+    }
+    public getUpdateLink(id: string): string
+    {
+        return this.getBaseLink() + "/" + id + "/edit";
+    }
 };

package/src/NSBaseServer.ts

@@ -1,47 +1,47 @@
-import { BaseServer } from "namirasoft-core";
-import { AxiosRequestConfig, AxiosResponse } from "axios";
-import { NSHeader } from "./NSHeader";
-
-export abstract class NSBaseServer extends BaseServer
-{
-    static onBeforeRequest_SetVersion<ReqData>(version: string, config?: AxiosRequestConfig<ReqData>): void
-    {
-        let header = NSHeader.req.VERSION();
-        if (config?.headers)
-            config.headers[header] = version;
-    }
-
-    static onAfterRequest_GetVersion<ReqData>(res?: AxiosResponse<ReqData>): string
-    {
-        let header = NSHeader.req.VERSION();
-        if (res?.headers)
-            return res.headers[header];
-        return "";
-    }
-
-    private version: string;
-
-    public backend: {
-        version: string
-    } = { version: "" };
-
-    constructor(base_url: string, version: string)
-    {
-        super(base_url);
-        this.version = version;
-
-        this.NSOnBeforeRequest = this.NSOnBeforeRequest.bind(this);
-        this.NSOnAfterRequest = this.NSOnAfterRequest.bind(this);
-
-        this.addOnBeforeRequest(this.NSOnBeforeRequest);
-        this.addOnAfterRequest(this.NSOnAfterRequest);
-    }
-    private NSOnBeforeRequest<ReqData = any>(_: string, config?: AxiosRequestConfig<ReqData> | undefined): void
-    {
-        NSBaseServer.onBeforeRequest_SetVersion(this.version, config);
-    }
-    private NSOnAfterRequest<ResData = any>(_: string, res: AxiosResponse<ResData, any>): void
-    {
-        this.backend.version = NSBaseServer.onAfterRequest_GetVersion(res);
-    }
+import { BaseServer } from "namirasoft-core";
+import { AxiosRequestConfig, AxiosResponse } from "axios";
+import { NSHeader } from "./NSHeader";
+
+export abstract class NSBaseServer extends BaseServer
+{
+    static onBeforeRequest_SetVersion<ReqData>(version: string, config?: AxiosRequestConfig<ReqData>): void
+    {
+        let header = NSHeader.req.VERSION();
+        if (config?.headers)
+            config.headers[header] = version;
+    }
+
+    static onAfterRequest_GetVersion<ReqData>(res?: AxiosResponse<ReqData>): string
+    {
+        let header = NSHeader.req.VERSION();
+        if (res?.headers)
+            return res.headers[header];
+        return "";
+    }
+
+    private version: string;
+
+    public backend: {
+        version: string
+    } = { version: "" };
+
+    constructor(base_url: string, version: string)
+    {
+        super(base_url);
+        this.version = version;
+
+        this.NSOnBeforeRequest = this.NSOnBeforeRequest.bind(this);
+        this.NSOnAfterRequest = this.NSOnAfterRequest.bind(this);
+
+        this.addOnBeforeRequest(this.NSOnBeforeRequest);
+        this.addOnAfterRequest(this.NSOnAfterRequest);
+    }
+    private NSOnBeforeRequest<ReqData = any>(_: string, config?: AxiosRequestConfig<ReqData> | undefined): void
+    {
+        NSBaseServer.onBeforeRequest_SetVersion(this.version, config);
+    }
+    private NSOnAfterRequest<ResData = any>(_: string, res: AxiosResponse<ResData, any>): void
+    {
+        this.backend.version = NSBaseServer.onAfterRequest_GetVersion(res);
+    }
 };

package/src/NSCookiesHeader.ts

@@ -1,3 +1,3 @@
-export class NSCookiesHeader 
-{
+export class NSCookiesHeader 
+{
 }

package/src/NSHeader.ts

@@ -1,10 +1,10 @@
-import { NSCookiesHeader } from "./NSCookiesHeader";
-import { NSReqHeader } from "./NSReqHeader";
-import { NSResHeader } from "./NSResHeader";
-
-export class NSHeader
-{
-    static cookies: NSCookiesHeader = new NSCookiesHeader();
-    static req: NSReqHeader = new NSReqHeader();
-    static res: NSResHeader = new NSResHeader();
+import { NSCookiesHeader } from "./NSCookiesHeader";
+import { NSReqHeader } from "./NSReqHeader";
+import { NSResHeader } from "./NSResHeader";
+
+export class NSHeader
+{
+    static cookies: NSCookiesHeader = new NSCookiesHeader();
+    static req: NSReqHeader = new NSReqHeader();
+    static res: NSResHeader = new NSResHeader();
 }

package/src/NSNameParser.ts

@@ -1,144 +1,144 @@
-import { NamingConvention } from "namirasoft-core";
-
-export type NSNameParserStructure =
-    {
-        // Name
-        name_namirasoft: string;
-        name_short: string;
-
-        // Title
-        title_namirasoft: string;
-        title_short: string;
-
-        // Class
-        class_namirasoft: string;
-        class_short: string;
-    };
-
-export class NSNameParser
-{
-    // Input
-    public name_full: string;
-    public title_full: string;
-
-    // Is
-    public isAPI: boolean;
-    public isConsole: boolean;
-    public isLibrary: boolean;
-    public isNPM: boolean;
-    public isPHP: boolean;
-    public isAccountAPI: boolean;
-
-    public api: NSNameParserStructure = {
-        // Name
-        name_namirasoft: "",
-        name_short: "",
-
-        // Title
-        title_namirasoft: "",
-        title_short: "",
-
-        // Class
-        class_namirasoft: "",
-        class_short: "",
-    };
-
-    public console: NSNameParserStructure = {
-        // Name
-        name_namirasoft: "",
-        name_short: "",
-
-        // Title
-        title_namirasoft: "",
-        title_short: "",
-
-        // Class
-        class_namirasoft: "",
-        class_short: "",
-    };
-
-    public library: NSNameParserStructure = {
-        // Name
-        name_namirasoft: "",
-        name_short: "",
-
-        // Title
-        title_namirasoft: "",
-        title_short: "",
-
-        // Class
-        class_namirasoft: "",
-        class_short: "",
-    };
-    public command: {
-        name: string
-    } = { name: "" };
-
-    constructor(name_full: string, title_full: string)
-    {
-        // Input
-        this.name_full = name_full;
-        this.title_full = title_full;
-
-        // Is
-        this.isAPI = /^namirasoft(-\w*)*-api(-\w*)*-v\d+$/gm.test(name_full);
-        this.isConsole = /^namirasoft-(\w+-)+console$/gm.test(name_full);
-        this.isLibrary = !this.isAPI && !this.isConsole && /^namirasoft-\w+/gm.test(name_full);
-        this.isNPM = this.isLibrary && /NPM Package$/gm.test(title_full);
-        this.isPHP = this.isLibrary && /PHP Package$/gm.test(title_full);
-        this.isAccountAPI = /^namirasoft-account-api-v\d+$/gm.test(name_full);
-
-        if (this.isAPI)
-        {
-            // Name
-            this.api.name_namirasoft = this.name_full.replace(/(-api)?-v\d+$/gm, "");
-            this.api.name_short = this.api.name_namirasoft.replace(/^namirasoft-/gm, "");
-
-            // Title
-            this.api.title_namirasoft = this.title_full.replace(/(\sAPI)?\sV\d+$/gm, "");
-            this.api.title_short = this.api.title_namirasoft.replace(/^Namirasoft\s/gm, "");
-
-            // Class
-            this.api.class_namirasoft = NamingConvention.auto.convert(this.api.title_namirasoft, NamingConvention.Pascal_Case);
-            this.api.class_short = NamingConvention.auto.convert(this.api.title_short, NamingConvention.Pascal_Case);
-
-            // Command
-            this.command.name = this.api.name_namirasoft;
-        }
-
-        if (this.isConsole)
-        {
-            // Name
-            this.console.name_namirasoft = this.name_full.replace(/-console$/gm, "");
-            this.console.name_short = this.console.name_namirasoft.replace(/^namirasoft-/gm, "");
-
-            // Title
-            this.console.title_namirasoft = this.title_full.replace(/\sConsole$/gm, "");
-            this.console.title_short = this.console.title_namirasoft.replace(/^Namirasoft\s/gm, "");
-
-            // Class
-            this.console.class_namirasoft = NamingConvention.auto.convert(this.console.title_namirasoft, NamingConvention.Pascal_Case);
-            this.console.class_short = NamingConvention.auto.convert(this.console.title_short, NamingConvention.Pascal_Case);
-        }
-
-        if (this.isLibrary)
-        {
-            // Name
-            this.library.name_namirasoft = this.name_full;
-            this.library.name_short = this.library.name_namirasoft.replace(/^namirasoft-/gm, "");
-
-            // Title
-            this.library.title_namirasoft = this.title_full.replace(/\s(NPM|PHP)\sPackage$/gm, "");
-            this.library.title_short = this.library.title_namirasoft.replace(/^Namirasoft\s/gm, "");
-
-            // Class
-            this.library.class_namirasoft = NamingConvention.auto.convert(this.library.title_namirasoft, NamingConvention.Pascal_Case);
-            this.library.class_short = NamingConvention.auto.convert(this.library.title_short, NamingConvention.Pascal_Case);
-
-            // Command
-            this.command.name = this.library.name_namirasoft;
-        }
-
-        this.command.name = this.command.name.replace("namirasoft-", "ns-");
-    }
+import { NamingConvention } from "namirasoft-core";
+
+export type NSNameParserStructure =
+    {
+        // Name
+        name_namirasoft: string;
+        name_short: string;
+
+        // Title
+        title_namirasoft: string;
+        title_short: string;
+
+        // Class
+        class_namirasoft: string;
+        class_short: string;
+    };
+
+export class NSNameParser
+{
+    // Input
+    public name_full: string;
+    public title_full: string;
+
+    // Is
+    public isAPI: boolean;
+    public isConsole: boolean;
+    public isLibrary: boolean;
+    public isNPM: boolean;
+    public isPHP: boolean;
+    public isAccountAPI: boolean;
+
+    public api: NSNameParserStructure = {
+        // Name
+        name_namirasoft: "",
+        name_short: "",
+
+        // Title
+        title_namirasoft: "",
+        title_short: "",
+
+        // Class
+        class_namirasoft: "",
+        class_short: "",
+    };
+
+    public console: NSNameParserStructure = {
+        // Name
+        name_namirasoft: "",
+        name_short: "",
+
+        // Title
+        title_namirasoft: "",
+        title_short: "",
+
+        // Class
+        class_namirasoft: "",
+        class_short: "",
+    };
+
+    public library: NSNameParserStructure = {
+        // Name
+        name_namirasoft: "",
+        name_short: "",
+
+        // Title
+        title_namirasoft: "",
+        title_short: "",
+
+        // Class
+        class_namirasoft: "",
+        class_short: "",
+    };
+    public command: {
+        name: string
+    } = { name: "" };
+
+    constructor(name_full: string, title_full: string)
+    {
+        // Input
+        this.name_full = name_full;
+        this.title_full = title_full;
+
+        // Is
+        this.isAPI = /^namirasoft(-\w*)*-api(-\w*)*-v\d+$/gm.test(name_full);
+        this.isConsole = /^namirasoft-(\w+-)+console$/gm.test(name_full);
+        this.isLibrary = !this.isAPI && !this.isConsole && /^namirasoft-\w+/gm.test(name_full);
+        this.isNPM = this.isLibrary && /NPM Package$/gm.test(title_full);
+        this.isPHP = this.isLibrary && /PHP Package$/gm.test(title_full);
+        this.isAccountAPI = /^namirasoft-account-api-v\d+$/gm.test(name_full);
+
+        if (this.isAPI)
+        {
+            // Name
+            this.api.name_namirasoft = this.name_full.replace(/(-api)?-v\d+$/gm, "");
+            this.api.name_short = this.api.name_namirasoft.replace(/^namirasoft-/gm, "");
+
+            // Title
+            this.api.title_namirasoft = this.title_full.replace(/(\sAPI)?\sV\d+$/gm, "");
+            this.api.title_short = this.api.title_namirasoft.replace(/^Namirasoft\s/gm, "");
+
+            // Class
+            this.api.class_namirasoft = NamingConvention.auto.convert(this.api.title_namirasoft, NamingConvention.Pascal_Case);
+            this.api.class_short = NamingConvention.auto.convert(this.api.title_short, NamingConvention.Pascal_Case);
+
+            // Command
+            this.command.name = this.api.name_namirasoft;
+        }
+
+        if (this.isConsole)
+        {
+            // Name
+            this.console.name_namirasoft = this.name_full.replace(/-console$/gm, "");
+            this.console.name_short = this.console.name_namirasoft.replace(/^namirasoft-/gm, "");
+
+            // Title
+            this.console.title_namirasoft = this.title_full.replace(/\sConsole$/gm, "");
+            this.console.title_short = this.console.title_namirasoft.replace(/^Namirasoft\s/gm, "");
+
+            // Class
+            this.console.class_namirasoft = NamingConvention.auto.convert(this.console.title_namirasoft, NamingConvention.Pascal_Case);
+            this.console.class_short = NamingConvention.auto.convert(this.console.title_short, NamingConvention.Pascal_Case);
+        }
+
+        if (this.isLibrary)
+        {
+            // Name
+            this.library.name_namirasoft = this.name_full;
+            this.library.name_short = this.library.name_namirasoft.replace(/^namirasoft-/gm, "");
+
+            // Title
+            this.library.title_namirasoft = this.title_full.replace(/\s(NPM|PHP)\sPackage$/gm, "");
+            this.library.title_short = this.library.title_namirasoft.replace(/^Namirasoft\s/gm, "");
+
+            // Class
+            this.library.class_namirasoft = NamingConvention.auto.convert(this.library.title_namirasoft, NamingConvention.Pascal_Case);
+            this.library.class_short = NamingConvention.auto.convert(this.library.title_short, NamingConvention.Pascal_Case);
+
+            // Command
+            this.command.name = this.library.name_namirasoft;
+        }
+
+        this.command.name = this.command.name.replace("namirasoft-", "ns-");
+    }
 };

package/src/NSReqHeader.ts

@@ -1,7 +1,7 @@
-export class NSReqHeader 
-{
-    VERSION()
-    {
-        return `ns-site-version`;
-    }
+export class NSReqHeader 
+{
+    VERSION()
+    {
+        return `ns-site-version`;
+    }
 }

package/src/NSResHeader.ts

@@ -1,7 +1,7 @@
-export class NSResHeader 
-{
-    VERSION()
-    {
-        return `ns-site-version`;
-    }
+export class NSResHeader 
+{
+    VERSION()
+    {
+        return `ns-site-version`;
+    }
 }

package/src/index.ts

@@ -1,8 +1,8 @@
-export * from "./NSBaseServer";
-export * from "./NSBaseMetaDatabase";
-export * from "./NSBaseMetaTable";
-export * from "./NSCookiesHeader";
-export * from "./NSHeader";
-export * from "./NSNameParser";
-export * from "./NSReqHeader";
+export * from "./NSBaseServer";
+export * from "./NSBaseMetaDatabase";
+export * from "./NSBaseMetaTable";
+export * from "./NSCookiesHeader";
+export * from "./NSHeader";
+export * from "./NSNameParser";
+export * from "./NSReqHeader";
 export * from "./NSResHeader";

package/tsconfig.json

@@ -8,6 +8,9 @@
             "es6",
             "dom"
         ],
+        "types": [
+            "node"
+        ],
         "allowJs": false,
         "checkJs": false,
         "strict": true,