@simtlix/simfinity-js-client 1.1.0 → 3.19.1

package/README.md

@@ -1,6 +1,21 @@
+[![Simfinity.js — Define once. Build beyond. GraphQL, MongoDB, PostgreSQL, and optional MCP.](https://raw.githubusercontent.com/simtlix/simfinity.js/master/.github/assets/readme-cover.png)](https://simtlix.github.io/simfinity.js/)
+
 # @simtlix/simfinity-js-client
 
-Introspection-driven GraphQL client for [simfinity-js](https://github.com/simtlix/simfinity.js) APIs. It discovers your schema at runtime via introspection and exposes a chainable query builder, CRUD helpers, aggregate queries, state-machine transitions, schema metadata access, mutation input transformation, and more — no code generation required.
+[![npm version](https://img.shields.io/npm/v/@simtlix/simfinity-js-client.svg)](https://www.npmjs.com/package/@simtlix/simfinity-js-client)
+[![Node.js](https://img.shields.io/node/v/@simtlix/simfinity-js-client.svg)](https://nodejs.org/)
+[![License](https://img.shields.io/npm/l/@simtlix/simfinity-js-client.svg)](https://github.com/simtlix/simfinity.js/blob/master/LICENSE)
+[![Documentation](https://img.shields.io/badge/docs-simtlix.github.io-2563eb.svg)](https://simtlix.github.io/simfinity.js/)
+
+Introspection-driven GraphQL client for [Simfinity.js](https://simtlix.github.io/simfinity.js/) APIs. It discovers your schema at runtime via introspection and exposes a chainable query builder, CRUD helpers, aggregate queries, state-machine transitions, schema metadata access, mutation input transformation, and more — no code generation required.
+
+> Since 3.19.0, the client is maintained in the Simfinity monorepo and follows its aligned release version. Existing valid 1.1 JavaScript calls remain supported.
+
+**[Documentation](https://simtlix.github.io/simfinity.js/)** ·
+**[JavaScript client guide](https://simtlix.github.io/simfinity.js/guide/client.html)** ·
+**[Client descriptor](https://simtlix.github.io/simfinity.js/reference/client-descriptor.html)** ·
+**[Example app](https://simtlix.github.io/simfinity.js/resources/barber.html)** ·
+**[Releases](https://github.com/simtlix/simfinity.js/releases)**
 
 ## Installation
 
@@ -41,7 +56,7 @@ Creates a new client instance pointing at the given GraphQL endpoint.
 
 ### `client.init()`
 
-Runs an introspection query against the endpoint and builds internal registries of types, queries, and mutations — including Simfinity-specific field extensions (relation metadata, state machine flags, read-only markers). **Must be called before any other method.**
+By default, runs an extended introspection query against the endpoint and builds internal registries of types, queries, and mutations — including Simfinity-specific field extensions (relation metadata, state machine flags, read-only markers). **Must be called before any other method.**
 
 ### Schema Inspection
 
@@ -71,7 +86,7 @@ const results = await client.find('serie')
 
 #### `.where(field, operator, value [, value2])`
 
-Filter by a scalar field. Supported operators depend on the server schema (e.g. `EQ`, `NE`, `GT`, `LT`, `GTE`, `LTE`, `BETWEEN`, `LIKE`, `NIN`).
+Filter by a scalar field. Supported operators depend on the server schema (e.g. `EQ`, `NE`, `GT`, `LT`, `GTE`, `LTE`, `BTW`, `LIKE`, `NIN`).
 
 #### `.where(field, terms)`
 
@@ -480,7 +495,7 @@ client.getAvailableTransitions('season');
 
 ## Examples
 
-See [`examples/demo.js`](examples/demo.js) for a comprehensive walkthrough covering all features: schema discovery, filtering, joins, pagination, sorting, CRUD, state machine transitions, aggregates, raw queries, schema metadata, selection set building, entity resolution, input transformation, collection deltas, parent queries, FK search, and response extensions.
+See [`examples/demo.js`](https://github.com/simtlix/simfinity.js/blob/master/packages/client/examples/demo.js) for a comprehensive walkthrough covering all features: schema discovery, filtering, joins, pagination, sorting, CRUD, state machine transitions, aggregates, raw queries, schema metadata, selection set building, entity resolution, input transformation, collection deltas, parent queries, FK search, and response extensions.
 
 ```bash
 GRAPHQL_ENDPOINT=http://localhost:3000/graphql npm run demo
@@ -488,4 +503,20 @@ GRAPHQL_ENDPOINT=http://localhost:3000/graphql npm run demo
 
 ## License
 
-[Apache-2.0](LICENSE)
+[Apache-2.0](https://github.com/simtlix/simfinity.js/blob/master/LICENSE)
+
+## Source provenance
+
+Imported from simtlix/simfinity-js-client commit `32d9c5bf7264cd3ecddcd3441bffea3b21566cb0` (1.1.0), under its Apache-2.0 license.
+
+## Monorepo additions
+
+See the [JavaScript client guide](https://simtlix.github.io/simfinity.js/guide/client.html) for the complete current API and both-engine setup. The client remains dependency-free and browser compatible.
+
+- Constructor options add mutually exclusive `descriptor` and `descriptorEndpoint`, injected `fetch`, `introspection: 'extended' | 'standard'`, and asynchronous `prepareHeaders`. Descriptor mode never introspects; use it when the server disables introspection. `getDescriptor()` returns the loaded descriptor or null.
+- `query(name, args?, fields?)` executes exact query roots, including scalar and abstract outputs. `findView(name, params?)` returns a normal list builder, while `getViews(typeName?)` lists descriptor-classified views. Canonical lists are not replaced by views.
+- List and aggregate builders accept `.where(field, filterObject)` and `.filter(group)` for `valuePath`, `ANY`/`ALL`/`NONE` and `$parent`. Operators come from the schema, including text, emptiness, `CONTAINS_ALL` and `IIN`; the server still gates engine support. `collectionArgs(path, args)` applies variables to selected nested collections, separately from legacy parent filtering. Aliased paths use response names.
+- Transformed updates/actions preserve required managed versions. `delete(type, id, fields?, { version })` supplies the protected delete precondition. `transformInput` adds `preserveEmpty`, `includeCollections` and concrete `inputType` opt-ins. Collection delta transformation keeps `{ id, version }` for protected deletions and IDs for unprotected deletions.
+- `transaction(operations, fields?, { name }?)` sends one generated transaction mutation, preserving reference tokens and explicit versions. Descriptor mode discovers its root; introspection mode requires the exact configured name. Errors preserve all `graphQLErrors` extensions, including transaction positions. Writes are never retried by this client.
+
+Version 3.19.0 starts the client's aligned monorepo release policy, preserving the package name and existing valid 1.1 JavaScript calls. Releases use this repository's Release Simfinity workflow with npm Trusted Publishing and verified archives in both registries.

package/package.json

@@ -1,11 +1,14 @@
 {
   "name": "@simtlix/simfinity-js-client",
-  "version": "1.1.0",
+  "version": "3.19.1",
   "description": "Introspection-driven GraphQL client for simfinity-js APIs",
   "type": "module",
-  "main": "src/SimfinityClient.js",
+  "main": "./src/SimfinityClient.js",
   "exports": {
-    ".": "./src/SimfinityClient.js"
+    ".": {
+      "types": "./types/index.d.ts",
+      "default": "./src/SimfinityClient.js"
+    }
   },
   "scripts": {
     "demo": "node examples/demo.js"
@@ -19,11 +22,20 @@
   ],
   "author": "Multiscreen Technology Group - SimTLiX SRL",
   "license": "Apache-2.0",
+  "homepage": "https://simtlix.github.io/simfinity.js/guide/client.html",
   "repository": {
     "type": "git",
-    "url": "https://github.com/simtlix/simfinity-js-client"
+    "url": "https://github.com/simtlix/simfinity.js",
+    "directory": "packages/client"
   },
   "engines": {
-    "node": ">=18.0.0"
-  }
+    "node": ">=18.18.0"
+  },
+  "files": [
+    "src",
+    "types",
+    "README.md",
+    "LICENSE"
+  ],
+  "types": "./types/index.d.ts"
 }