@codenotch/codenotch.react 2.0.6 → 2.0.8

package/dist/env.d.ts

@@ -0,0 +1,13 @@
+import type { ICodenotchEnv } from "./models/Codenotch";
+/**
+ * The Codenotch runtime environment, populated by `init()`.
+ * Prefer reading it through `useCodenotch().env`.
+ *
+ * Lives in its own module so that both the API (`index.ts`) and the ORM
+ * wrapper (`models/Codenotch.ts`) can read it without a circular import.
+ */
+export declare const env: ICodenotchEnv;
+export declare const MISSING_CLUSTER_URL_ERROR = "Codenotch cluster URL is not defined. Please set it in the Codenotch configuration.";
+export declare const MISSING_SERVICE_NAME_ERROR = "Codenotch service name is not defined. Please set it in the Codenotch configuration.";
+export declare const MISSING_TENANT_NAME_ERROR = "Codenotch tenant name is not defined. Please set it in the Codenotch configuration.";
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD;;;;;;GAMG;AACH,eAAO,MAAM,GAAG,EAAE,aAAkB,CAAC;AAErC,eAAO,MAAM,yBAAyB,wFAAwF,CAAC;AAC/H,eAAO,MAAM,0BAA0B,yFAAyF,CAAC;AACjI,eAAO,MAAM,yBAAyB,wFAAwF,CAAC"}

package/dist/env.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MISSING_TENANT_NAME_ERROR = exports.MISSING_SERVICE_NAME_ERROR = exports.MISSING_CLUSTER_URL_ERROR = exports.env = void 0;
+/**
+ * The Codenotch runtime environment, populated by `init()`.
+ * Prefer reading it through `useCodenotch().env`.
+ *
+ * Lives in its own module so that both the API (`index.ts`) and the ORM
+ * wrapper (`models/Codenotch.ts`) can read it without a circular import.
+ */
+exports.env = {};
+exports.MISSING_CLUSTER_URL_ERROR = "Codenotch cluster URL is not defined. Please set it in the Codenotch configuration.";
+exports.MISSING_SERVICE_NAME_ERROR = "Codenotch service name is not defined. Please set it in the Codenotch configuration.";
+exports.MISSING_TENANT_NAME_ERROR = "Codenotch tenant name is not defined. Please set it in the Codenotch configuration.";

package/dist/index.d.ts

@@ -1,12 +1,8 @@
 import { type ComponentType, type ComponentProps, type FunctionComponent, type RefAttributes } from "react";
 import { IDisposable } from "./models/Misc";
-import { ClientTables, ICodenotchApi, ICodenotchEnv, WithCodenotchProps } from "./models/Codenotch";
+import { ClientTables, ICodenotchApi, WithCodenotchProps } from "./models/Codenotch";
+import { env } from "./env";
 import CodeEditor from "./components/CodeEditor";
-/**
- * The Codenotch runtime environment, populated by {@link init}.
- * Prefer reading it through `useCodenotch().env`.
- */
-declare const env: ICodenotchEnv;
 /**
  * Initialize the Codenotch environment from the given key-value pairs.
  *

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgD,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,KAAK,iBAAiB,EAAkB,KAAK,aAAa,EAAE,MAAM,OAAO,CAAC;AAG1K,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAwB,YAAY,EAAE,aAAa,EAAoB,aAAa,EAA2B,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAErK,OAAO,UAAU,MAAM,yBAAyB,CAAC;AAEjD;;;GAGG;AACH,QAAA,MAAM,GAAG,EAAE,aAAkB,CAAC;AA6B9B;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,iBAAS,IAAI,CAAC,YAAY,EAAE,GAAG,GAAG,IAAI,CAkErC;AAySD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,iBAAS,YAAY,IAAI,aAAa,CAErC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,iBAAS,YAAY,IAAI,aAAa,CAAC;AACvC,iBAAS,YAAY,CAAC,CAAC,SAAS,YAAY,EAAE,SAAS,EAAE,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;AAY9E;;;;;;;;;;;;;;GAcG;AACH,iBAAS,iBAAiB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,WAAW,CAG5D;AAED,wFAAwF;AACxF,KAAK,qBAAqB,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,MAAM,kBAAkB,CAAC,CAAC;AAElE,8FAA8F;AAC9F,KAAK,iBAAiB,CAAC,CAAC,IAAI,CAAC,SAAS,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAElF;;;;;;;;;;GAUG;AACH,iBAAS,aAAa,CAAC,CAAC,SAAS,aAAa,CAAC,GAAG,CAAC,EAC/C,SAAS,EAAE,CAAC,GACb,iBAAiB,CAAC,qBAAqB,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAQnG;AAED,OAAO,EACH,GAAG,EACH,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,IAAI,EACJ,UAAU,EACb,CAAC;AAEF,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgD,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,KAAK,iBAAiB,EAAkB,KAAK,aAAa,EAAE,MAAM,OAAO,CAAC;AAG1K,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAwB,YAAY,EAAE,aAAa,EAA6C,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACtJ,OAAO,EAAE,GAAG,EAAoF,MAAM,OAAO,CAAC;AAE9G,OAAO,UAAU,MAAM,yBAAyB,CAAC;AA0BjD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,iBAAS,IAAI,CAAC,YAAY,EAAE,GAAG,GAAG,IAAI,CAkErC;AAySD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,iBAAS,YAAY,IAAI,aAAa,CAErC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,iBAAS,YAAY,IAAI,aAAa,CAAC;AACvC,iBAAS,YAAY,CAAC,CAAC,SAAS,YAAY,EAAE,SAAS,EAAE,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;AAY9E;;;;;;;;;;;;;;GAcG;AACH,iBAAS,iBAAiB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,WAAW,CAG5D;AAED,wFAAwF;AACxF,KAAK,qBAAqB,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,MAAM,kBAAkB,CAAC,CAAC;AAElE,8FAA8F;AAC9F,KAAK,iBAAiB,CAAC,CAAC,IAAI,CAAC,SAAS,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAElF;;;;;;;;;;GAUG;AACH,iBAAS,aAAa,CAAC,CAAC,SAAS,aAAa,CAAC,GAAG,CAAC,EAC/C,SAAS,EAAE,CAAC,GACb,iBAAiB,CAAC,qBAAqB,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAQnG;AAED,OAAO,EACH,GAAG,EACH,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,IAAI,EACJ,UAAU,EACb,CAAC;AAEF,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,2BAA2B,CAAC"}

package/dist/index.js

@@ -26,18 +26,11 @@ exports.init = init;
 const react_1 = require("react");
 const react_dom_1 = require("react-dom");
 const client_1 = require("react-dom/client");
+const env_1 = require("./env");
+Object.defineProperty(exports, "env", { enumerable: true, get: function () { return env_1.env; } });
 const uuid_1 = require("uuid");
 const CodeEditor_1 = __importDefault(require("./components/CodeEditor"));
 exports.CodeEditor = CodeEditor_1.default;
-/**
- * The Codenotch runtime environment, populated by {@link init}.
- * Prefer reading it through `useCodenotch().env`.
- */
-const env = {};
-exports.env = env;
-const MISSING_CLUSTER_URL_ERROR = "Codenotch cluster URL is not defined. Please set it in the Codenotch configuration.";
-const MISSING_SERVICE_NAME_ERROR = "Codenotch service name is not defined. Please set it in the Codenotch configuration.";
-const MISSING_TENANT_NAME_ERROR = "Codenotch tenant name is not defined. Please set it in the Codenotch configuration.";
 // ---------------------------------------------------------------------------
 // Change tracking. `env` is a plain mutable object; every mutation done through
 // the public API (init, setTheme, setLanguage) goes through notify(), which
@@ -102,17 +95,17 @@ function init(envVariables) {
                     return;
                 }
                 else {
-                    env[key] = envVariables[key];
+                    env_1.env[key] = envVariables[key];
                     if (['appManifest', 'projectManifest'].includes(key)) {
                         // Must be Json
                         try {
-                            env[key] = JSON.parse(envVariables[key]);
+                            env_1.env[key] = JSON.parse(envVariables[key]);
                         }
                         catch (error) {
                             console.warn(`Codenotch environment variable ${key} is not a valid JSON string. Using raw value.`);
                         }
                     }
-                    console.log(`Codenotch environment variable ${key} set to ${env[key]}`);
+                    console.log(`Codenotch environment variable ${key} set to ${env_1.env[key]}`);
                 }
             }
             catch (error) {
@@ -126,21 +119,21 @@ function init(envVariables) {
         if (urlParams["_theme"]) {
             let theme = urlParams["_theme"].toLowerCase();
             if (theme === "light" || theme === "dark") {
-                env.theme = theme;
+                env_1.env.theme = theme;
             }
         }
         else if (window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches) {
-            env.theme = 'dark';
+            env_1.env.theme = 'dark';
         }
         else {
-            env.theme = 'light';
+            env_1.env.theme = 'light';
         }
         // Apply the resolved theme to <html> like setTheme does. Without this, getTheme()
         // and the DOM disagree until the first setTheme call, which can then be a visual
         // no-op (early return when env.theme already equals the requested theme).
-        if (env.theme) {
-            document.documentElement.classList.remove(env.theme === 'dark' ? 'light' : 'dark');
-            document.documentElement.classList.add(env.theme);
+        if (env_1.env.theme) {
+            document.documentElement.classList.remove(env_1.env.theme === 'dark' ? 'light' : 'dark');
+            document.documentElement.classList.add(env_1.env.theme);
         }
     }
     catch {
@@ -154,18 +147,18 @@ function init(envVariables) {
  */
 function createApi() {
     const api = {
-        env: env,
+        env: env_1.env,
         tables: {},
         uuid: () => (0, uuid_1.v4)(),
         getProjectFileUrl: (relativePath) => {
-            if (env.clusterUrl === undefined)
-                throw new Error(MISSING_CLUSTER_URL_ERROR);
-            if (env.serviceName === undefined)
-                throw new Error(MISSING_SERVICE_NAME_ERROR);
+            if (env_1.env.clusterUrl === undefined)
+                throw new Error(env_1.MISSING_CLUSTER_URL_ERROR);
+            if (env_1.env.serviceName === undefined)
+                throw new Error(env_1.MISSING_SERVICE_NAME_ERROR);
             relativePath = relativePath.replace(/\\/g, "/");
             if (relativePath.startsWith("/"))
                 relativePath = relativePath.substring(1);
-            let url = `${env.clusterUrl}/${env.serviceName}/project/file?name=""&path=${encodeURIComponent(relativePath)}`;
+            let url = `${env_1.env.clusterUrl}/${env_1.env.serviceName}/project/file?name=""&path=${encodeURIComponent(relativePath)}`;
             return url;
         },
         getProjectFile: async (relativePath) => {
@@ -178,10 +171,10 @@ function createApi() {
             return content;
         },
         requestCnql: async (cnql, verbose) => {
-            if (env.clusterUrl === undefined)
-                throw new Error(MISSING_CLUSTER_URL_ERROR);
-            if (env.serviceName === undefined)
-                throw new Error(MISSING_SERVICE_NAME_ERROR);
+            if (env_1.env.clusterUrl === undefined)
+                throw new Error(env_1.MISSING_CLUSTER_URL_ERROR);
+            if (env_1.env.serviceName === undefined)
+                throw new Error(env_1.MISSING_SERVICE_NAME_ERROR);
             const request = {
                 method: 'POST',
                 mode: 'cors',
@@ -189,14 +182,14 @@ function createApi() {
                 headers: { 'Content-Type': 'application/json' },
                 body: `"${cnql.replace(/\"/g, '\\\"')}"`
             };
-            if (`${env.accessToken ?? ''}`.trim() !== "") {
-                if (env.tenantName === undefined)
-                    throw new Error(MISSING_TENANT_NAME_ERROR);
+            if (`${env_1.env.accessToken ?? ''}`.trim() !== "") {
+                if (env_1.env.tenantName === undefined)
+                    throw new Error(env_1.MISSING_TENANT_NAME_ERROR);
                 request.headers = {
-                    ...request.headers, [`${env.tenantName}AccessToken`]: env.accessToken
+                    ...request.headers, [`${env_1.env.tenantName}AccessToken`]: env_1.env.accessToken
                 };
             }
-            const response = await fetch(`${env.clusterUrl}/${env.serviceName}/cnql${verbose ? "?v=true" : ""}`, request);
+            const response = await fetch(`${env_1.env.clusterUrl}/${env_1.env.serviceName}/cnql${verbose ? "?v=true" : ""}`, request);
             if (!response.ok) {
                 const error = await response.text();
                 throw new Error(error);
@@ -207,10 +200,10 @@ function createApi() {
             return api.startProcessFromId(p.id, inputs);
         },
         startProcessFromId: async (processId, inputs) => {
-            if (env.clusterUrl === undefined)
-                throw new Error(MISSING_CLUSTER_URL_ERROR);
-            if (env.serviceName === undefined)
-                throw new Error(MISSING_SERVICE_NAME_ERROR);
+            if (env_1.env.clusterUrl === undefined)
+                throw new Error(env_1.MISSING_CLUSTER_URL_ERROR);
+            if (env_1.env.serviceName === undefined)
+                throw new Error(env_1.MISSING_SERVICE_NAME_ERROR);
             // Exemple url: http://127.0.0.1:5005/test1/processes/helloWorldProcess/instances
             // Format: {env.clusterUrl}/{env.serviceName}/processes/{process}/instances
             /*
@@ -221,7 +214,7 @@ function createApi() {
                 }
             */
             // Starts the process
-            const response = await fetch(`${env.clusterUrl}/${env.serviceName}/processes/${processId}/instances`, {
+            const response = await fetch(`${env_1.env.clusterUrl}/${env_1.env.serviceName}/processes/${processId}/instances`, {
                 method: 'POST',
                 body: JSON.stringify({
                     "id": (0, uuid_1.v4)(),
@@ -265,7 +258,7 @@ function createApi() {
                             "errors": []
                         }
                     */
-                    const instanceResp = await fetch(`${env.clusterUrl}/instances/${instanceData.instanceId}`, {
+                    const instanceResp = await fetch(`${env_1.env.clusterUrl}/instances/${instanceData.instanceId}`, {
                         method: 'GET',
                         headers: {
                             'Codenotch-Instance-Token': instanceData.instanceToken
@@ -390,37 +383,37 @@ function createApi() {
             return result;
         },
         setTheme: (theme) => {
-            if (env.theme === theme)
+            if (env_1.env.theme === theme)
                 return;
-            if (env.theme)
-                document.documentElement.classList.remove(env.theme);
-            env.theme = theme;
+            if (env_1.env.theme)
+                document.documentElement.classList.remove(env_1.env.theme);
+            env_1.env.theme = theme;
             document.documentElement.classList.add(theme);
             notify();
         },
         setLanguage: (lang) => {
-            if (env.language === lang)
+            if (env_1.env.language === lang)
                 return;
-            env.language = lang;
+            env_1.env.language = lang;
             notify();
         },
         getLanguages: () => {
-            return env.projectManifest?.languages ?? [];
+            return env_1.env.projectManifest?.languages ?? [];
         },
         getLanguage: () => {
-            return env.language;
+            return env_1.env.language;
         },
         getTheme: () => {
-            return env.theme;
+            return env_1.env.theme;
         },
         getProjectManifest: () => {
-            if (env.projectManifest === undefined) {
+            if (env_1.env.projectManifest === undefined) {
                 throw new Error("Project manifest is not defined in Codenotch environment. Please set it in the Codenotch configuration.");
             }
-            return env.projectManifest;
+            return env_1.env.projectManifest;
         },
         getAppManifest: () => {
-            return env.appManifest;
+            return env_1.env.appManifest;
         }
     };
     return api;

package/dist/models/Codenotch.d.ts

@@ -1,6 +1,6 @@
 import type { ReactNode } from "react";
 import { IAppManifest, ICodenotchProjectManifest } from "@codenotch/codenotch.core";
-import { EntityMetadata, Query, Row, Predicate, Scope } from "@codenotch/orm";
+import { EntityMetadata, Predicate, Scope } from "@codenotch/orm";
 /**
  * Runtime environment of a Codenotch application.
  *
@@ -45,18 +45,29 @@ export interface IProcessResult<T = any> {
     errorMessage: string;
 }
 export declare class ClientTableQueryable<T extends EntityMetadata> {
-    private readonly _query;
-    constructor(entity: T, serviceName: string);
-    /** Wrap an existing query; used internally by the builder methods. */
-    constructor(query: Query<T, Row<T>>);
+    private readonly _entity;
+    private readonly _filters;
+    /**
+     * @param entity The entity metadata, as returned by `defineEntity()`.
+     * @param filters Internal: predicates accumulated by {@link filter}. Leave empty.
+     */
+    constructor(entity: T, filters?: ReadonlyArray<(scope: Scope<T>) => Predicate>);
     /**
      * Add a predicate (AND-combined with the previous ones). Returns a new
      * queryable and leaves this one untouched, so a shared `tables.xxx`
      * instance can be reused for independent queries.
      */
     filter(predicate: (scope: Scope<T>) => Predicate): ClientTableQueryable<T>;
+    /**
+     * Build the query against the current environment (`env.serviceName`).
+     * Done lazily, at run time rather than in the constructor, because the
+     * generated tables module is evaluated at import time, before `init()`
+     * has populated the environment.
+     */
+    private toQuery;
     run(): Promise<T[]>;
     first(): Promise<T | undefined>;
+    private fetchResults;
 }
 /**
  * The project's tables, keyed by name — augmented via declaration merging by the

package/dist/models/Codenotch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Codenotch.d.ts","sourceRoot":"","sources":["../../src/models/Codenotch.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Codenotch.d.ts","sourceRoot":"","sources":["../../src/models/Codenotch.ts"],"names":[],"mappings":"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"}

package/dist/models/Codenotch.js

@@ -2,13 +2,17 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ClientTableQueryable = void 0;
 const orm_1 = require("@codenotch/orm");
+const env_1 = require("../env");
 /// ======================================================================================================================
 /// consomme @codenotch/orm
 class ClientTableQueryable {
-    constructor(entityOrQuery, serviceName) {
-        this._query = serviceName === undefined
-            ? entityOrQuery
-            : (0, orm_1.createReadContext)({ source: serviceName, now: () => orm_1.Instant.fromDate(new Date()) }).query(entityOrQuery);
+    /**
+     * @param entity The entity metadata, as returned by `defineEntity()`.
+     * @param filters Internal: predicates accumulated by {@link filter}. Leave empty.
+     */
+    constructor(entity, filters = []) {
+        this._entity = entity;
+        this._filters = filters;
     }
     /**
      * Add a predicate (AND-combined with the previous ones). Returns a new
@@ -16,19 +20,59 @@ class ClientTableQueryable {
      * instance can be reused for independent queries.
      */
     filter(predicate) {
-        return new ClientTableQueryable(this._query.filter(predicate));
+        return new ClientTableQueryable(this._entity, [...this._filters, predicate]);
+    }
+    /**
+     * Build the query against the current environment (`env.serviceName`).
+     * Done lazily, at run time rather than in the constructor, because the
+     * generated tables module is evaluated at import time, before `init()`
+     * has populated the environment.
+     */
+    toQuery() {
+        if (env_1.env.serviceName === undefined)
+            throw new Error(env_1.MISSING_SERVICE_NAME_ERROR);
+        const context = (0, orm_1.createReadContext)({ source: env_1.env.serviceName, now: () => orm_1.Instant.fromDate(new Date()) });
+        const initial = context.query(this._entity);
+        return this._filters.reduce((query, predicate) => query.filter(predicate), initial);
     }
     async run() {
-        const cnql = this._query.toXml();
+        const cnql = this.toQuery().toXml();
         // TODO 
         console.log('this._query.toXml():', cnql);
+        const obj = await this.fetchResults(cnql);
+        console.log('this.fetchResults(cnql):', obj);
         return [];
     }
     async first() {
-        const cnql = this._query.toXml();
-        // TODO 
-        console.log('this._query.toXml():', cnql);
-        return undefined;
+        // TODO: force pagesize to 1
+        const results = await this.run();
+        return results[0];
+    }
+    async fetchResults(cnql) {
+        if (env_1.env.clusterUrl === undefined)
+            throw new Error(env_1.MISSING_CLUSTER_URL_ERROR);
+        if (env_1.env.serviceName === undefined)
+            throw new Error(env_1.MISSING_SERVICE_NAME_ERROR);
+        const request = {
+            method: 'POST',
+            mode: 'cors',
+            credentials: 'same-origin',
+            headers: { 'Content-Type': 'application/json' },
+            body: `"${cnql.replace(/\"/g, '\\\"')}"`
+        };
+        if (`${env_1.env.accessToken ?? ''}`.trim() !== "") {
+            if (env_1.env.tenantName === undefined)
+                throw new Error(env_1.MISSING_TENANT_NAME_ERROR);
+            request.headers = {
+                ...request.headers, [`${env_1.env.tenantName}AccessToken`]: env_1.env.accessToken
+            };
+        }
+        const response = await fetch(`${env_1.env.clusterUrl}/${env_1.env.serviceName}/cnql?v=true`, request);
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(error);
+        }
+        return await response.json();
     }
 }
 exports.ClientTableQueryable = ClientTableQueryable;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@codenotch/codenotch.react",
-    "version": "2.0.6",
+    "version": "2.0.8",
     "description": "React bindings for Codenotch applications: start BPMN processes, run cnql queries, listen to real-time signals, manage theme and language.",
     "keywords": [
         "codenotch",
@@ -25,8 +25,8 @@
         "src/**/*"
     ],
     "dependencies": {
-        "@codenotch/codenotch.core": "1.0.23",
-        "@codenotch/orm": "0.1.1",
+        "@codenotch/codenotch.core": "^1.0.23",
+        "@codenotch/orm": "^0.1.2",
         "uuid": "^8.2.0"
     },
     "devDependencies": {

package/src/env.ts

@@ -0,0 +1,14 @@
+import type { ICodenotchEnv } from "./models/Codenotch";
+
+/**
+ * The Codenotch runtime environment, populated by `init()`.
+ * Prefer reading it through `useCodenotch().env`.
+ *
+ * Lives in its own module so that both the API (`index.ts`) and the ORM
+ * wrapper (`models/Codenotch.ts`) can read it without a circular import.
+ */
+export const env: ICodenotchEnv = {};
+
+export const MISSING_CLUSTER_URL_ERROR = "Codenotch cluster URL is not defined. Please set it in the Codenotch configuration.";
+export const MISSING_SERVICE_NAME_ERROR = "Codenotch service name is not defined. Please set it in the Codenotch configuration.";
+export const MISSING_TENANT_NAME_ERROR = "Codenotch tenant name is not defined. Please set it in the Codenotch configuration.";

package/src/index.ts

@@ -2,19 +2,11 @@ import { createElement, useMemo, useSyncExternalStore, type ComponentType, type
 import { flushSync } from "react-dom";
 import { createRoot, Root } from "react-dom/client";
 import { IDisposable } from "./models/Misc";
-import { ClientTableQueryable, ClientTables, ICodenotchApi, ICodenotchDialog, ICodenotchEnv, IProcessResult, Process, WithCodenotchProps } from "./models/Codenotch";
+import { ClientTableQueryable, ClientTables, ICodenotchApi, ICodenotchDialog, IProcessResult, Process, WithCodenotchProps } from "./models/Codenotch";
+import { env, MISSING_CLUSTER_URL_ERROR, MISSING_SERVICE_NAME_ERROR, MISSING_TENANT_NAME_ERROR } from "./env";
 import { v4 } from "uuid";
 import CodeEditor from "./components/CodeEditor";
 
-/**
- * The Codenotch runtime environment, populated by {@link init}.
- * Prefer reading it through `useCodenotch().env`.
- */
-const env: ICodenotchEnv = {};
-
-const MISSING_CLUSTER_URL_ERROR = "Codenotch cluster URL is not defined. Please set it in the Codenotch configuration.";
-const MISSING_SERVICE_NAME_ERROR = "Codenotch service name is not defined. Please set it in the Codenotch configuration.";
-const MISSING_TENANT_NAME_ERROR = "Codenotch tenant name is not defined. Please set it in the Codenotch configuration.";
 
 // ---------------------------------------------------------------------------
 // Change tracking. `env` is a plain mutable object; every mutation done through

package/src/models/Codenotch.ts

@@ -1,6 +1,7 @@
 import type { ReactNode } from "react";
 import { IAppManifest, ICodenotchProjectManifest } from "@codenotch/codenotch.core";
-import { EntityMetadata, Query, Row, Predicate, Scope, defineEntity, p, createReadContext, Instant} from "@codenotch/orm";
+import { EntityMetadata, Query, Row, Predicate, Scope, defineEntity, p, createReadContext, Instant } from "@codenotch/orm";
+import { env, MISSING_CLUSTER_URL_ERROR, MISSING_SERVICE_NAME_ERROR, MISSING_TENANT_NAME_ERROR } from "../env";
 
 /**
  * Runtime environment of a Codenotch application.
@@ -55,15 +56,20 @@ export interface IProcessResult<T = any> {
 
 export class ClientTableQueryable<T extends EntityMetadata> {
 
-    private readonly _query: Query<T, Row<T>>;
+    private readonly _entity: T;
+    // Typed with `any` on purpose: a function-typed property is contravariant in
+    // its parameter, so keeping `Scope<T>` here would make ClientTableQueryable<Contact>
+    // unassignable to ClientTableQueryable<EntityMetadata>, i.e. to ClientTables.
+    // The public `filter()` signature stays fully typed.
+    private readonly _filters: ReadonlyArray<(scope: any) => Predicate>;
 
-    constructor(entity: T, serviceName: string);
-    /** Wrap an existing query; used internally by the builder methods. */
-    constructor(query: Query<T, Row<T>>);
-    constructor(entityOrQuery: T | Query<T, Row<T>>, serviceName?: string) {
-        this._query = serviceName === undefined
-            ? entityOrQuery as Query<T, Row<T>>
-            : createReadContext({ source: serviceName, now: () => Instant.fromDate(new Date()) }).query(entityOrQuery as T);
+    /**
+     * @param entity The entity metadata, as returned by `defineEntity()`.
+     * @param filters Internal: predicates accumulated by {@link filter}. Leave empty.
+     */
+    constructor(entity: T, filters: ReadonlyArray<(scope: Scope<T>) => Predicate> = []) {
+        this._entity = entity;
+        this._filters = filters;
     }
 
     /**
@@ -72,21 +78,64 @@ export class ClientTableQueryable<T extends EntityMetadata> {
      * instance can be reused for independent queries.
      */
     filter(predicate: (scope: Scope<T>) => Predicate): ClientTableQueryable<T> {
-        return new ClientTableQueryable<T>(this._query.filter(predicate));
+        return new ClientTableQueryable<T>(this._entity, [...this._filters, predicate]);
     }
 
-    async run(): Promise<T[]>{
-        const cnql = this._query.toXml();
+    /**
+     * Build the query against the current environment (`env.serviceName`).
+     * Done lazily, at run time rather than in the constructor, because the
+     * generated tables module is evaluated at import time, before `init()`
+     * has populated the environment.
+     */
+    private toQuery(): Query<T, Row<T>> {
+        if (env.serviceName === undefined) throw new Error(MISSING_SERVICE_NAME_ERROR);
+        const context = createReadContext({ source: env.serviceName, now: () => Instant.fromDate(new Date()) });
+        const initial: Query<T, Row<T>> = context.query(this._entity);
+        return this._filters.reduce((query, predicate) => query.filter(predicate), initial);
+    }
+
+    async run(): Promise<T[]> {
+        const cnql = this.toQuery().toXml();
         // TODO 
         console.log('this._query.toXml():', cnql);
+
+        const obj = await this.fetchResults(cnql);
+
+        console.log('this.fetchResults(cnql):', obj);
+
         return [];
     }
 
     async first(): Promise<T | undefined> {
-        const cnql = this._query.toXml();
-        // TODO 
-        console.log('this._query.toXml():', cnql);
-        return undefined;
+        // TODO: force pagesize to 1
+        
+        const results = await this.run();
+
+        return results[0];
+    }
+
+    private async fetchResults(cnql: string) {
+        if (env.clusterUrl === undefined) throw new Error(MISSING_CLUSTER_URL_ERROR);
+        if (env.serviceName === undefined) throw new Error(MISSING_SERVICE_NAME_ERROR);
+        const request: RequestInit = {
+            method: 'POST',
+            mode: 'cors',
+            credentials: 'same-origin',
+            headers: { 'Content-Type': 'application/json' },
+            body: `"${cnql.replace(/\"/g, '\\\"')}"`
+        };
+        if (`${env.accessToken ?? ''}`.trim() !== "") {
+            if (env.tenantName === undefined) throw new Error(MISSING_TENANT_NAME_ERROR);
+            request.headers = {
+                ...request.headers, [`${env.tenantName}AccessToken`]: env.accessToken!
+            };
+        }
+        const response = await fetch(`${env.clusterUrl}/${env.serviceName}/cnql?v=true`, request);
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(error);
+        }
+        return await response.json();
     }
 }