@codenotch/codenotch.react 2.0.5 → 2.0.7

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { type ComponentType, type ComponentProps, type FunctionComponent, type RefAttributes } from "react";
 import { IDisposable } from "./models/Misc";
-import { ICodenotchApi, ICodenotchEnv, WithCodenotchProps } from "./models/Codenotch";
+import { ClientTables, ICodenotchApi, ICodenotchEnv, WithCodenotchProps } from "./models/Codenotch";
 import CodeEditor from "./components/CodeEditor";
 /**
  * The Codenotch runtime environment, populated by {@link init}.
@@ -69,8 +69,15 @@ declare function getCodenotch(): ICodenotchApi;
  * component or a custom hook). Outside of components — handlers defined in
  * plain modules, services, class components — use {@link getCodenotch} or
  * {@link withCodenotch} instead.
+ *
+ * @param dbContext The project's tables (typically the object exported by the
+ * generated db-schema module), exposed as `tables` on the returned API. Its
+ * type is inferred, so `cn.tables.<name>` autocompletes. Pass a module-level
+ * reference, not an object built during render, otherwise the returned API
+ * changes on every render.
  */
 declare function useCodenotch(): ICodenotchApi;
+declare function useCodenotch<T extends ClientTables>(dbContext: T): ICodenotchApi<T>;
 /**
  * Register a listener called each time the Codenotch environment changes
  * (`setLanguage`, `setTheme`, `init`). Escape hatch for code that cannot use

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuC,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,KAAK,iBAAiB,EAAkB,KAAK,aAAa,EAAE,MAAM,OAAO,CAAC;AAGjK,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAoB,aAAa,EAA2B,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAEjI,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;AAwSD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,iBAAS,YAAY,IAAI,aAAa,CAErC;AAED;;;;;;;;;;;;;GAaG;AACH,iBAAS,YAAY,IAAI,aAAa,CAErC;AAED;;;;;;;;;;;;;;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,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"}

package/dist/index.js

@@ -155,6 +155,7 @@ function init(envVariables) {
 function createApi() {
     const api = {
         env: env,
+        tables: {},
         uuid: () => (0, uuid_1.v4)(),
         getProjectFileUrl: (relativePath) => {
             if (env.clusterUrl === undefined)
@@ -449,22 +450,12 @@ currentApi = createApi();
 function getCodenotch() {
     return currentApi;
 }
-/**
- * React hook returning the Codenotch client API.
- *
- * The reference is stable across renders and only changes when the environment
- * changes (`setLanguage`, `setTheme`, `init`), in which case every component
- * using the hook re-renders output follows the current
- * language automatically, and the object is safe to use in `useMemo` /
- * `useEffect` dependency arrays.
- *
- * Regular hook rules apply (call it unconditionally at the top of a function
- * component or a custom hook). Outside of components — handlers defined in
- * plain modules, services, class components — use {@link getCodenotch} or
- * {@link withCodenotch} instead.
- */
-function useCodenotch() {
-    return (0, react_1.useSyncExternalStore)(subscribe, getCodenotch, getCodenotch);
+function useCodenotch(dbContext) {
+    const api = (0, react_1.useSyncExternalStore)(subscribe, getCodenotch, getCodenotch);
+    // The shared API object is a module-level singleton: expose the caller's
+    // tables on a derived copy rather than mutating it. The copy is memoized so
+    // the reference stays stable as long as `api` and `dbContext` do.
+    return (0, react_1.useMemo)(() => (dbContext ? { ...api, tables: dbContext } : api), [api, dbContext]);
 }
 /**
  * Register a listener called each time the Codenotch environment changes

package/dist/models/Codenotch.d.ts

@@ -1,5 +1,6 @@
 import type { ReactNode } from "react";
 import { IAppManifest, ICodenotchProjectManifest } from "@codenotch/codenotch.core";
+import { EntityMetadata, Query, Row, Predicate, Scope } from "@codenotch/orm";
 /**
  * Runtime environment of a Codenotch application.
  *
@@ -43,6 +44,27 @@ export interface IProcessResult<T = any> {
     /** Error details when {@link isError} is `true`. */
     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>>);
+    /**
+     * 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>;
+    run(): Promise<T[]>;
+    first(): Promise<T | undefined>;
+}
+/**
+ * The project's tables, keyed by name — augmented via declaration merging by the
+ * generated db-schema.d.ts so every table and row type autocompletes.
+ */
+export interface ClientTables {
+    [name: string]: ClientTableQueryable<EntityMetadata>;
+}
 type Json = string | number | boolean | null | Json[] | {
     [key: string]: Json;
 };
@@ -71,11 +93,17 @@ export interface Process<In = unknown, Out = unknown, E extends EventMap = {}> {
  * server-side BPMN processes, runs CNQL queries,
  * listens to real-time signals and manages theme/language.
  */
-export interface ICodenotchApi {
+export interface ICodenotchApi<TTables extends ClientTables = ClientTables> {
     startProcessFromId<TInput, TOutput>(processId: string, inputs: TInput): Promise<IProcessResult<TOutput>>;
     startProcess<In, Out>(p: Process<In, Out, any>, inputs: In): Promise<IProcessResult<Out>>;
     /** Runtime environment (cluster, service, language, theme dictionaries, manifests…). Populated by `init()`. */
     readonly env: ICodenotchEnv;
+    /**
+     * The project's tables, as passed to `useCodenotch(tables)`. The type
+     * parameter is inferred from that argument so every table name and row
+     * type autocompletes; without an argument it falls back to {@link ClientTables}.
+     */
+    readonly tables: TTables;
     /**
      * Execute a CNQL query (XML, SELECT-only) against the project's SQL tables and return the parsed JSON result.
      *

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":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAA8C,MAAM,gBAAgB,CAAC;AAE1H;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC1B,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iGAAiG;IACjG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oHAAoH;IACpH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iGAAiG;IACjG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yGAAyG;IACzG,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2GAA2G;IAC3G,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAEzB,gGAAgG;IAChG,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,8EAA8E;IAC9E,eAAe,CAAC,EAAE,yBAAyB,CAAC;IAE5C,8DAA8D;IAC9D,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,GAAG;IAEnC,kDAAkD;IAClD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iEAAiE;IACjE,MAAM,EAAE,CAAC,CAAC;IACV,oFAAoF;IACpF,OAAO,EAAE,OAAO,CAAC;IACjB,oDAAoD;IACpD,YAAY,EAAE,MAAM,CAAC;CACxB;AAKD,qBAAa,oBAAoB,CAAC,CAAC,SAAS,cAAc;IAEtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;gBAE9B,MAAM,EAAE,CAAC,EAAE,WAAW,EAAE,MAAM;IAC1C,sEAAsE;gBAC1D,KAAK,EAAE,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IAOnC;;;;OAIG;IACH,MAAM,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,GAAG,oBAAoB,CAAC,CAAC,CAAC;IAIpE,GAAG,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC;IAOnB,KAAK,IAAI,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;CAMxC;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IACzB,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,CAAC,cAAc,CAAC,CAAC;CACxD;AAQD,KAAK,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,IAAI,EAAE,GAAG;IACpD,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAAC;AACF,KAAK,YAAY,GAAG,IAAI,GAAG;IACvB,MAAM,IAAI,IAAI,CAAC;CAClB,GAAG,SAAS,GAAG,YAAY,EAAE,GAAG;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC;CAC/B,CAAC;AACF,KAAK,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAC7C,MAAM,WAAW,OAAO,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,GAAG,OAAO,EAAE,CAAC,SAAS,QAAQ,GAAG,EAAE;IACzE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,CAAC,EAAE;QACf,KAAK,EAAE,EAAE,CAAC;QACV,MAAM,EAAE,GAAG,CAAC;QACZ,MAAM,EAAE,CAAC,CAAC;KACb,CAAC;CACL;AAID;;;;;;;;;;GAUG;AACH,MAAM,WAAW,aAAa,CAAC,OAAO,SAAS,YAAY,GAAG,YAAY;IAEtE,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IAEzG,YAAY,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;IAE1F,+GAA+G;IAC/G,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;IAE5B;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IAExE;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,gBAAgB,CAAC;IAE3D;;;OAGG;IACH,QAAQ,CAAC,cAAc,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAE/E;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,MAAM,CAAC;IAE7D,uGAAuG;IACvG,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,KAAK,IAAI,CAAC;IACrD,qCAAqC;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;IACtD,wEAAwE;IACxE,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,qCAAqC;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAC/C,2DAA2D;IAC3D,QAAQ,CAAC,YAAY,EAAE,MAAM,MAAM,EAAE,CAAC;IACtC,4GAA4G;IAC5G,QAAQ,CAAC,YAAY,EAAE,MAAM;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IACvD,iCAAiC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,MAAM,CAAC;IAC5B,qFAAqF;IACrF,QAAQ,CAAC,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;IAC7D,mDAAmD;IACnD,QAAQ,CAAC,cAAc,EAAE,MAAM,YAAY,GAAG,SAAS,CAAC;CAC3D;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IAC/B,4FAA4F;IAC5F,EAAE,EAAE,aAAa,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,mDAAmD;IACnD,EAAE,EAAE,MAAM,CAAC;IACX,mDAAmD;IACnD,KAAK,EAAE,MAAM,IAAI,CAAC;CACrB"}

package/dist/models/Codenotch.js

@@ -1,2 +1,34 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClientTableQueryable = void 0;
+const orm_1 = require("@codenotch/orm");
+/// ======================================================================================================================
+/// 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);
+    }
+    /**
+     * 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) {
+        return new ClientTableQueryable(this._query.filter(predicate));
+    }
+    async run() {
+        const cnql = this._query.toXml();
+        // TODO 
+        console.log('this._query.toXml():', cnql);
+        return [];
+    }
+    async first() {
+        const cnql = this._query.toXml();
+        // TODO 
+        console.log('this._query.toXml():', cnql);
+        return undefined;
+    }
+}
+exports.ClientTableQueryable = ClientTableQueryable;

package/dist/models/Misc.d.ts

@@ -1,23 +1,3 @@
-import { IProcessResult } from "./Codenotch";
-/**
- * Internal callbacks used while a BPMN process instance is running.
- */
-export interface IProcessCallbacks {
-    /** Called once when the process instance completes (successfully or not). */
-    onOver: (processResult: IProcessResult) => void;
-    /** Called for each intermediate callback emitted by the process. */
-    onCallback: (callback: any) => void;
-}
-/**
- * A real-time signal emitted by a BPMN process,
- * received through `useCodenotch().listenSignal()`.
- */
-export interface ICodenotchSignal {
-    /** Id of the signal, as declared in the BPMN process. */
-    signalId: string;
-    /** Payload attached to the signal by the process. */
-    data: any;
-}
 /**
  * A subscription that can be released.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"Misc.d.ts","sourceRoot":"","sources":["../../src/models/Misc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAE9B,6EAA6E;IAC7E,MAAM,EAAE,CAAC,aAAa,EAAE,cAAc,KAAK,IAAI,CAAC;IAChD,oEAAoE;IACpE,UAAU,EAAC,CAAE,QAAQ,EAAE,GAAG,KAAK,IAAI,CAAA;CACtC;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAE7B,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,IAAI,EAAE,GAAG,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,kEAAkE;IAClE,OAAO,EAAE,MAAM,IAAI,CAAC;CACvB"}
+{"version":3,"file":"Misc.d.ts","sourceRoot":"","sources":["../../src/models/Misc.ts"],"names":[],"mappings":"AACA;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,kEAAkE;IAClE,OAAO,EAAE,MAAM,IAAI,CAAC;CACvB"}

package/package.json

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

package/src/index.ts

@@ -1,8 +1,8 @@
-import { createElement, useSyncExternalStore, type ComponentType, type ComponentProps, type FunctionComponent, type ReactNode, type RefAttributes } from "react";
+import { createElement, useMemo, useSyncExternalStore, type ComponentType, type ComponentProps, type FunctionComponent, type ReactNode, type RefAttributes } from "react";
 import { flushSync } from "react-dom";
 import { createRoot, Root } from "react-dom/client";
 import { IDisposable } from "./models/Misc";
-import { ICodenotchApi, ICodenotchDialog, ICodenotchEnv, IProcessResult, Process, WithCodenotchProps } from "./models/Codenotch";
+import { ClientTableQueryable, ClientTables, ICodenotchApi, ICodenotchDialog, ICodenotchEnv, IProcessResult, Process, WithCodenotchProps } from "./models/Codenotch";
 import { v4 } from "uuid";
 import CodeEditor from "./components/CodeEditor";
 
@@ -141,6 +141,7 @@ function init(envVariables: any): void {
 function createApi(): ICodenotchApi {
     const api: ICodenotchApi = {
         env: env,
+        tables: {},
         uuid: () => v4(),
         getProjectFileUrl: (relativePath: string): string => {
             if (env.clusterUrl === undefined) throw new Error(MISSING_CLUSTER_URL_ERROR);
@@ -465,9 +466,24 @@ function getCodenotch(): ICodenotchApi {
  * component or a custom hook). Outside of components — handlers defined in
  * plain modules, services, class components — use {@link getCodenotch} or
  * {@link withCodenotch} instead.
+ *
+ * @param dbContext The project's tables (typically the object exported by the
+ * generated db-schema module), exposed as `tables` on the returned API. Its
+ * type is inferred, so `cn.tables.<name>` autocompletes. Pass a module-level
+ * reference, not an object built during render, otherwise the returned API
+ * changes on every render.
  */
-function useCodenotch(): ICodenotchApi {
-    return useSyncExternalStore(subscribe, getCodenotch, getCodenotch);
+function useCodenotch(): ICodenotchApi;
+function useCodenotch<T extends ClientTables>(dbContext: T): ICodenotchApi<T>;
+function useCodenotch(dbContext?: ClientTables): ICodenotchApi {
+    const api = useSyncExternalStore(subscribe, getCodenotch, getCodenotch);
+    // The shared API object is a module-level singleton: expose the caller's
+    // tables on a derived copy rather than mutating it. The copy is memoized so
+    // the reference stays stable as long as `api` and `dbContext` do.
+    return useMemo(
+        () => (dbContext ? { ...api, tables: dbContext } : api),
+        [api, dbContext]
+    );
 }
 
 /**

package/src/models/Codenotch.ts

@@ -1,6 +1,6 @@
 import type { ReactNode } from "react";
 import { IAppManifest, ICodenotchProjectManifest } from "@codenotch/codenotch.core";
-import { ICodenotchSignal, IDisposable } from "./Misc";
+import { EntityMetadata, Query, Row, Predicate, Scope, defineEntity, p, createReadContext, Instant} from "@codenotch/orm";
 
 /**
  * Runtime environment of a Codenotch application.
@@ -50,8 +50,60 @@ export interface IProcessResult<T = any> {
     errorMessage: string;
 }
 
+/// ======================================================================================================================
+/// consomme @codenotch/orm
 
-/// @CODENOTCH/PROCESS
+export class ClientTableQueryable<T extends EntityMetadata> {
+
+    private readonly _query: Query<T, Row<T>>;
+
+    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);
+    }
+
+    /**
+     * 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> {
+        return new ClientTableQueryable<T>(this._query.filter(predicate));
+    }
+
+    async run(): Promise<T[]>{
+        const cnql = this._query.toXml();
+        // TODO 
+        console.log('this._query.toXml():', cnql);
+        return [];
+    }
+
+    async first(): Promise<T | undefined> {
+        const cnql = this._query.toXml();
+        // TODO 
+        console.log('this._query.toXml():', cnql);
+        return undefined;
+    }
+}
+
+/**
+ * The project's tables, keyed by name — augmented via declaration merging by the
+ * generated db-schema.d.ts so every table and row type autocompletes.
+ */
+export interface ClientTables {
+    [name: string]: ClientTableQueryable<EntityMetadata>;
+}
+/// ======================================================================================================================
+
+
+/// ======================================================================================================================
+/// Duplicate of the `Process` interface in @codenotch/process, to avoid a hard dependency on that package in this module. 
+/// It is used only for typing the `startProcess()` method of {@link ICodenotchApi}.
+/// @codenotch/process
 type Json = string | number | boolean | null | Json[] | {
     [key: string]: Json;
 };
@@ -69,7 +121,7 @@ export interface Process<In = unknown, Out = unknown, E extends EventMap = {}> {
         events: E;
     };
 }
-/// @CODENOTCH/PROCESS
+/// ======================================================================================================================
 
 
 /**
@@ -83,7 +135,7 @@ export interface Process<In = unknown, Out = unknown, E extends EventMap = {}> {
  * server-side BPMN processes, runs CNQL queries,
  * listens to real-time signals and manages theme/language.
  */
-export interface ICodenotchApi {
+export interface ICodenotchApi<TTables extends ClientTables = ClientTables> {
 
     startProcessFromId<TInput, TOutput>(processId: string, inputs: TInput): Promise<IProcessResult<TOutput>>;
 
@@ -92,6 +144,12 @@ export interface ICodenotchApi {
     /** Runtime environment (cluster, service, language, theme dictionaries, manifests…). Populated by `init()`. */
     readonly env: ICodenotchEnv;
 
+    /**
+     * The project's tables, as passed to `useCodenotch(tables)`. The type
+     * parameter is inferred from that argument so every table name and row
+     * type autocompletes; without an argument it falls back to {@link ClientTables}.
+     */
+    readonly tables: TTables;
     /**
      * Execute a CNQL query (XML, SELECT-only) against the project's SQL tables and return the parsed JSON result.
      *

package/src/models/Misc.ts

@@ -1,27 +1,3 @@
-import { IProcessResult } from "./Codenotch";
-
-/**
- * Internal callbacks used while a BPMN process instance is running.
- */
-export interface IProcessCallbacks
-{
-    /** Called once when the process instance completes (successfully or not). */
-    onOver: (processResult: IProcessResult) => void,
-    /** Called for each intermediate callback emitted by the process. */
-    onCallback:( callback: any) => void
-}
-
-/**
- * A real-time signal emitted by a BPMN process,
- * received through `useCodenotch().listenSignal()`.
- */
-export interface ICodenotchSignal
-{
-    /** Id of the signal, as declared in the BPMN process. */
-    signalId: string;
-    /** Payload attached to the signal by the process. */
-    data: any;
-}
 
 /**
  * A subscription that can be released.