@constructive-io/express-context 0.2.1 → 0.3.0

package/esm/index.js

@@ -40,6 +40,6 @@ export { withPgClient } from './pg-client';
 // Request ID middleware
 export { requestIdMiddleware } from './request-id';
 export { buildContext, createContextMiddleware } from './context';
-export { authSettingsLoader, corsLoader, createDefaultRegistry, createLoaderRegistry, createModuleLoader, databaseSettingsLoader, pubkeyLoader, rlsLoader, webauthnLoader, } from './loaders';
+export { agentChatLoader, authSettingsLoader, billingLoader, corsLoader, createDefaultRegistry, createLoaderRegistry, createModuleLoader, databaseSettingsLoader, inferenceLogLoader, pubkeyLoader, rlsLoader, webauthnLoader, } from './loaders';
 // Side-effect: Express type augmentation
 import './types';

package/esm/loaders/agent-chat.js

@@ -0,0 +1,36 @@
+/**
+ * Agent Chat Module Loader
+ *
+ * Resolves per-database agent chat config from metaschema_modules_public.agent_chat_module.
+ * Returns the schema and table names for threads, messages, and tasks.
+ */
+import { createModuleLoader } from './create-loader';
+// ─── SQL ────────────────────────────────────────────────────────────────────
+const AGENT_CHAT_MODULE_SQL = `
+  SELECT
+    s.schema_name,
+    acm.thread_table_name,
+    acm.message_table_name,
+    acm.task_table_name
+  FROM metaschema_modules_public.agent_chat_module acm
+  JOIN metaschema_public.schema s ON s.id = acm.schema_id
+  LIMIT 1
+`;
+// ─── Loader ─────────────────────────────────────────────────────────────────
+export const agentChatLoader = createModuleLoader({
+    name: 'agentChat',
+    ttlMs: 60_000,
+    async resolve(ctx) {
+        const { tenantPool } = ctx;
+        const result = await tenantPool.query(AGENT_CHAT_MODULE_SQL);
+        const row = result.rows[0];
+        if (!row)
+            return undefined;
+        return {
+            schemaName: row.schema_name,
+            threadTableName: row.thread_table_name,
+            messageTableName: row.message_table_name,
+            taskTableName: row.task_table_name,
+        };
+    },
+});

package/esm/loaders/billing.js

@@ -0,0 +1,37 @@
+/**
+ * Billing Module Loader
+ *
+ * Resolves per-database billing config from metaschema_modules_public.billing_module.
+ * Returns schema names and function names needed for quota checks and usage recording.
+ */
+import { createModuleLoader } from './create-loader';
+// ─── SQL ────────────────────────────────────────────────────────────────────
+const BILLING_MODULE_SQL = `
+  SELECT
+    s.schema_name AS public_schema,
+    ps.schema_name AS private_schema,
+    bm.record_usage_function
+  FROM metaschema_modules_public.billing_module bm
+  JOIN metaschema_public.schema s ON bm.schema_id = s.id
+  JOIN metaschema_public.schema ps ON bm.private_schema_id = ps.id
+  WHERE bm.database_id = $1
+  LIMIT 1
+`;
+// ─── Loader ─────────────────────────────────────────────────────────────────
+export const billingLoader = createModuleLoader({
+    name: 'billing',
+    ttlMs: 5 * 60_000,
+    async resolve(ctx) {
+        const { tenantPool, databaseId } = ctx;
+        const result = await tenantPool.query(BILLING_MODULE_SQL, [databaseId]);
+        const row = result.rows[0];
+        if (!row?.record_usage_function)
+            return undefined;
+        return {
+            publicSchema: row.public_schema,
+            privateSchema: row.private_schema,
+            recordUsageFunction: row.record_usage_function,
+            checkBillingQuotaFunction: 'check_billing_quota',
+        };
+    },
+});

package/esm/loaders/index.js

@@ -34,6 +34,9 @@ export { databaseSettingsLoader } from './database-settings';
 export { pubkeyLoader } from './pubkey';
 export { webauthnLoader } from './webauthn';
 export { authSettingsLoader } from './auth-settings';
+export { billingLoader } from './billing';
+export { inferenceLogLoader } from './inference-log';
+export { agentChatLoader } from './agent-chat';
 /**
  * Convenience: create a registry pre-loaded with all built-in loaders.
  */
@@ -44,6 +47,9 @@ import { databaseSettingsLoader } from './database-settings';
 import { pubkeyLoader } from './pubkey';
 import { webauthnLoader } from './webauthn';
 import { authSettingsLoader } from './auth-settings';
+import { billingLoader } from './billing';
+import { inferenceLogLoader } from './inference-log';
+import { agentChatLoader } from './agent-chat';
 export function createDefaultRegistry() {
     const registry = createLoaderRegistry();
     registry.register(rlsLoader);
@@ -52,5 +58,8 @@ export function createDefaultRegistry() {
     registry.register(pubkeyLoader);
     registry.register(webauthnLoader);
     registry.register(authSettingsLoader);
+    registry.register(billingLoader);
+    registry.register(inferenceLogLoader);
+    registry.register(agentChatLoader);
     return registry;
 }

package/esm/loaders/inference-log.js

@@ -0,0 +1,33 @@
+/**
+ * Inference Log Module Loader
+ *
+ * Resolves per-database inference log config from metaschema_modules_public.inference_log_module.
+ * Returns the schema and table name for logging LLM inference usage.
+ */
+import { createModuleLoader } from './create-loader';
+// ─── SQL ────────────────────────────────────────────────────────────────────
+const INFERENCE_LOG_MODULE_SQL = `
+  SELECT
+    s.schema_name AS schema,
+    ilm.inference_log_table_name AS table_name
+  FROM metaschema_modules_public.inference_log_module ilm
+  JOIN metaschema_public.schema s ON ilm.schema_id = s.id
+  WHERE ilm.database_id = $1
+  LIMIT 1
+`;
+// ─── Loader ─────────────────────────────────────────────────────────────────
+export const inferenceLogLoader = createModuleLoader({
+    name: 'inferenceLog',
+    ttlMs: 5 * 60_000,
+    async resolve(ctx) {
+        const { tenantPool, databaseId } = ctx;
+        const result = await tenantPool.query(INFERENCE_LOG_MODULE_SQL, [databaseId]);
+        const row = result.rows[0];
+        if (!row?.schema || !row?.table_name)
+            return undefined;
+        return {
+            schema: row.schema,
+            tableName: row.table_name,
+        };
+    },
+});

package/index.d.ts

@@ -34,7 +34,7 @@
  * });
  * ```
  */
-export type { ApiConfigResult, ApiError, ApiModule, ApiStructure, AuthSettings, ConstructiveAPIToken, ConstructiveContext, CorsModuleData, DatabaseSettings, GenericModuleData, PublicKeyChallengeData, PubkeyChallengeSettings, BuiltinModuleMap, RlsModule, WebauthnSettings, WithPgClient, } from './types';
+export type { AgentChatConfig, ApiConfigResult, ApiError, ApiModule, ApiStructure, AuthSettings, BillingConfig, BuiltinModuleMap, ConstructiveAPIToken, ConstructiveContext, CorsModuleData, DatabaseSettings, GenericModuleData, InferenceLogConfig, PublicKeyChallengeData, PubkeyChallengeSettings, RlsModule, WebauthnSettings, WithPgClient, } from './types';
 export type { PgSettingsInput } from './pg-settings';
 export { buildPgSettings } from './pg-settings';
 export { withPgClient } from './pg-client';
@@ -42,5 +42,5 @@ export { requestIdMiddleware } from './request-id';
 export type { ContextMiddlewareOptions } from './context';
 export { buildContext, createContextMiddleware } from './context';
 export type { CreateLoaderOptions, LoaderContext, LoaderRegistry, ModuleLoader, } from './loaders';
-export { authSettingsLoader, corsLoader, createDefaultRegistry, createLoaderRegistry, createModuleLoader, databaseSettingsLoader, pubkeyLoader, rlsLoader, webauthnLoader, } from './loaders';
+export { agentChatLoader, authSettingsLoader, billingLoader, corsLoader, createDefaultRegistry, createLoaderRegistry, createModuleLoader, databaseSettingsLoader, inferenceLogLoader, pubkeyLoader, rlsLoader, webauthnLoader, } from './loaders';
 import './types';

package/index.js

@@ -36,7 +36,7 @@
  * ```
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.webauthnLoader = exports.rlsLoader = exports.pubkeyLoader = exports.databaseSettingsLoader = exports.createModuleLoader = exports.createLoaderRegistry = exports.createDefaultRegistry = exports.corsLoader = exports.authSettingsLoader = exports.createContextMiddleware = exports.buildContext = exports.requestIdMiddleware = exports.withPgClient = exports.buildPgSettings = void 0;
+exports.webauthnLoader = exports.rlsLoader = exports.pubkeyLoader = exports.inferenceLogLoader = exports.databaseSettingsLoader = exports.createModuleLoader = exports.createLoaderRegistry = exports.createDefaultRegistry = exports.corsLoader = exports.billingLoader = exports.authSettingsLoader = exports.agentChatLoader = exports.createContextMiddleware = exports.buildContext = exports.requestIdMiddleware = exports.withPgClient = exports.buildPgSettings = void 0;
 var pg_settings_1 = require("./pg-settings");
 Object.defineProperty(exports, "buildPgSettings", { enumerable: true, get: function () { return pg_settings_1.buildPgSettings; } });
 // withPgClient helper
@@ -49,12 +49,15 @@ var context_1 = require("./context");
 Object.defineProperty(exports, "buildContext", { enumerable: true, get: function () { return context_1.buildContext; } });
 Object.defineProperty(exports, "createContextMiddleware", { enumerable: true, get: function () { return context_1.createContextMiddleware; } });
 var loaders_1 = require("./loaders");
+Object.defineProperty(exports, "agentChatLoader", { enumerable: true, get: function () { return loaders_1.agentChatLoader; } });
 Object.defineProperty(exports, "authSettingsLoader", { enumerable: true, get: function () { return loaders_1.authSettingsLoader; } });
+Object.defineProperty(exports, "billingLoader", { enumerable: true, get: function () { return loaders_1.billingLoader; } });
 Object.defineProperty(exports, "corsLoader", { enumerable: true, get: function () { return loaders_1.corsLoader; } });
 Object.defineProperty(exports, "createDefaultRegistry", { enumerable: true, get: function () { return loaders_1.createDefaultRegistry; } });
 Object.defineProperty(exports, "createLoaderRegistry", { enumerable: true, get: function () { return loaders_1.createLoaderRegistry; } });
 Object.defineProperty(exports, "createModuleLoader", { enumerable: true, get: function () { return loaders_1.createModuleLoader; } });
 Object.defineProperty(exports, "databaseSettingsLoader", { enumerable: true, get: function () { return loaders_1.databaseSettingsLoader; } });
+Object.defineProperty(exports, "inferenceLogLoader", { enumerable: true, get: function () { return loaders_1.inferenceLogLoader; } });
 Object.defineProperty(exports, "pubkeyLoader", { enumerable: true, get: function () { return loaders_1.pubkeyLoader; } });
 Object.defineProperty(exports, "rlsLoader", { enumerable: true, get: function () { return loaders_1.rlsLoader; } });
 Object.defineProperty(exports, "webauthnLoader", { enumerable: true, get: function () { return loaders_1.webauthnLoader; } });

package/loaders/agent-chat.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Agent Chat Module Loader
+ *
+ * Resolves per-database agent chat config from metaschema_modules_public.agent_chat_module.
+ * Returns the schema and table names for threads, messages, and tasks.
+ */
+import type { AgentChatConfig } from '../types';
+import type { ModuleLoader } from './types';
+export declare const agentChatLoader: ModuleLoader<AgentChatConfig>;

package/loaders/agent-chat.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * Agent Chat Module Loader
+ *
+ * Resolves per-database agent chat config from metaschema_modules_public.agent_chat_module.
+ * Returns the schema and table names for threads, messages, and tasks.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agentChatLoader = void 0;
+const create_loader_1 = require("./create-loader");
+// ─── SQL ────────────────────────────────────────────────────────────────────
+const AGENT_CHAT_MODULE_SQL = `
+  SELECT
+    s.schema_name,
+    acm.thread_table_name,
+    acm.message_table_name,
+    acm.task_table_name
+  FROM metaschema_modules_public.agent_chat_module acm
+  JOIN metaschema_public.schema s ON s.id = acm.schema_id
+  LIMIT 1
+`;
+// ─── Loader ─────────────────────────────────────────────────────────────────
+exports.agentChatLoader = (0, create_loader_1.createModuleLoader)({
+    name: 'agentChat',
+    ttlMs: 60_000,
+    async resolve(ctx) {
+        const { tenantPool } = ctx;
+        const result = await tenantPool.query(AGENT_CHAT_MODULE_SQL);
+        const row = result.rows[0];
+        if (!row)
+            return undefined;
+        return {
+            schemaName: row.schema_name,
+            threadTableName: row.thread_table_name,
+            messageTableName: row.message_table_name,
+            taskTableName: row.task_table_name,
+        };
+    },
+});

package/loaders/billing.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Billing Module Loader
+ *
+ * Resolves per-database billing config from metaschema_modules_public.billing_module.
+ * Returns schema names and function names needed for quota checks and usage recording.
+ */
+import type { BillingConfig } from '../types';
+import type { ModuleLoader } from './types';
+export declare const billingLoader: ModuleLoader<BillingConfig>;

package/loaders/billing.js

@@ -0,0 +1,40 @@
+"use strict";
+/**
+ * Billing Module Loader
+ *
+ * Resolves per-database billing config from metaschema_modules_public.billing_module.
+ * Returns schema names and function names needed for quota checks and usage recording.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.billingLoader = void 0;
+const create_loader_1 = require("./create-loader");
+// ─── SQL ────────────────────────────────────────────────────────────────────
+const BILLING_MODULE_SQL = `
+  SELECT
+    s.schema_name AS public_schema,
+    ps.schema_name AS private_schema,
+    bm.record_usage_function
+  FROM metaschema_modules_public.billing_module bm
+  JOIN metaschema_public.schema s ON bm.schema_id = s.id
+  JOIN metaschema_public.schema ps ON bm.private_schema_id = ps.id
+  WHERE bm.database_id = $1
+  LIMIT 1
+`;
+// ─── Loader ─────────────────────────────────────────────────────────────────
+exports.billingLoader = (0, create_loader_1.createModuleLoader)({
+    name: 'billing',
+    ttlMs: 5 * 60_000,
+    async resolve(ctx) {
+        const { tenantPool, databaseId } = ctx;
+        const result = await tenantPool.query(BILLING_MODULE_SQL, [databaseId]);
+        const row = result.rows[0];
+        if (!row?.record_usage_function)
+            return undefined;
+        return {
+            publicSchema: row.public_schema,
+            privateSchema: row.private_schema,
+            recordUsageFunction: row.record_usage_function,
+            checkBillingQuotaFunction: 'check_billing_quota',
+        };
+    },
+});

package/loaders/index.d.ts

@@ -36,4 +36,7 @@ export { databaseSettingsLoader } from './database-settings';
 export { pubkeyLoader } from './pubkey';
 export { webauthnLoader } from './webauthn';
 export { authSettingsLoader } from './auth-settings';
+export { billingLoader } from './billing';
+export { inferenceLogLoader } from './inference-log';
+export { agentChatLoader } from './agent-chat';
 export declare function createDefaultRegistry(): import("./registry").LoaderRegistry;

package/loaders/index.js

@@ -27,7 +27,7 @@
  *   registry.register(myLoader);
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.authSettingsLoader = exports.webauthnLoader = exports.pubkeyLoader = exports.databaseSettingsLoader = exports.corsLoader = exports.rlsLoader = exports.createLoaderRegistry = exports.createModuleLoader = void 0;
+exports.agentChatLoader = exports.inferenceLogLoader = exports.billingLoader = exports.authSettingsLoader = exports.webauthnLoader = exports.pubkeyLoader = exports.databaseSettingsLoader = exports.corsLoader = exports.rlsLoader = exports.createLoaderRegistry = exports.createModuleLoader = void 0;
 exports.createDefaultRegistry = createDefaultRegistry;
 var create_loader_1 = require("./create-loader");
 Object.defineProperty(exports, "createModuleLoader", { enumerable: true, get: function () { return create_loader_1.createModuleLoader; } });
@@ -46,6 +46,12 @@ var webauthn_1 = require("./webauthn");
 Object.defineProperty(exports, "webauthnLoader", { enumerable: true, get: function () { return webauthn_1.webauthnLoader; } });
 var auth_settings_1 = require("./auth-settings");
 Object.defineProperty(exports, "authSettingsLoader", { enumerable: true, get: function () { return auth_settings_1.authSettingsLoader; } });
+var billing_1 = require("./billing");
+Object.defineProperty(exports, "billingLoader", { enumerable: true, get: function () { return billing_1.billingLoader; } });
+var inference_log_1 = require("./inference-log");
+Object.defineProperty(exports, "inferenceLogLoader", { enumerable: true, get: function () { return inference_log_1.inferenceLogLoader; } });
+var agent_chat_1 = require("./agent-chat");
+Object.defineProperty(exports, "agentChatLoader", { enumerable: true, get: function () { return agent_chat_1.agentChatLoader; } });
 /**
  * Convenience: create a registry pre-loaded with all built-in loaders.
  */
@@ -56,6 +62,9 @@ const database_settings_2 = require("./database-settings");
 const pubkey_2 = require("./pubkey");
 const webauthn_2 = require("./webauthn");
 const auth_settings_2 = require("./auth-settings");
+const billing_2 = require("./billing");
+const inference_log_2 = require("./inference-log");
+const agent_chat_2 = require("./agent-chat");
 function createDefaultRegistry() {
     const registry = (0, registry_2.createLoaderRegistry)();
     registry.register(rls_2.rlsLoader);
@@ -64,5 +73,8 @@ function createDefaultRegistry() {
     registry.register(pubkey_2.pubkeyLoader);
     registry.register(webauthn_2.webauthnLoader);
     registry.register(auth_settings_2.authSettingsLoader);
+    registry.register(billing_2.billingLoader);
+    registry.register(inference_log_2.inferenceLogLoader);
+    registry.register(agent_chat_2.agentChatLoader);
     return registry;
 }

package/loaders/inference-log.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Inference Log Module Loader
+ *
+ * Resolves per-database inference log config from metaschema_modules_public.inference_log_module.
+ * Returns the schema and table name for logging LLM inference usage.
+ */
+import type { InferenceLogConfig } from '../types';
+import type { ModuleLoader } from './types';
+export declare const inferenceLogLoader: ModuleLoader<InferenceLogConfig>;

package/loaders/inference-log.js

@@ -0,0 +1,36 @@
+"use strict";
+/**
+ * Inference Log Module Loader
+ *
+ * Resolves per-database inference log config from metaschema_modules_public.inference_log_module.
+ * Returns the schema and table name for logging LLM inference usage.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.inferenceLogLoader = void 0;
+const create_loader_1 = require("./create-loader");
+// ─── SQL ────────────────────────────────────────────────────────────────────
+const INFERENCE_LOG_MODULE_SQL = `
+  SELECT
+    s.schema_name AS schema,
+    ilm.inference_log_table_name AS table_name
+  FROM metaschema_modules_public.inference_log_module ilm
+  JOIN metaschema_public.schema s ON ilm.schema_id = s.id
+  WHERE ilm.database_id = $1
+  LIMIT 1
+`;
+// ─── Loader ─────────────────────────────────────────────────────────────────
+exports.inferenceLogLoader = (0, create_loader_1.createModuleLoader)({
+    name: 'inferenceLog',
+    ttlMs: 5 * 60_000,
+    async resolve(ctx) {
+        const { tenantPool, databaseId } = ctx;
+        const result = await tenantPool.query(INFERENCE_LOG_MODULE_SQL, [databaseId]);
+        const row = result.rows[0];
+        if (!row?.schema || !row?.table_name)
+            return undefined;
+        return {
+            schema: row.schema,
+            tableName: row.table_name,
+        };
+    },
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constructive-io/express-context",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Extractable Express middleware for Constructive tenant context — domain resolution, JWT auth, pgSettings, and withPgClient",
   "author": "Constructive <developers@constructive.io>",
   "homepage": "https://github.com/constructive-io/constructive",
@@ -59,5 +59,5 @@
     "jwt",
     "pgSettings"
   ],
-  "gitHead": "ccc303b2a2d1d9701648efc124ea1d9f2714711f"
+  "gitHead": "0d63238f2186b997a69a3287fa6cd35ebd93dda6"
 }

package/types.d.ts

@@ -119,6 +119,22 @@ export type ConstructiveAPIToken = {
     kind?: string;
     [key: string]: unknown;
 };
+export interface BillingConfig {
+    publicSchema: string;
+    privateSchema: string;
+    recordUsageFunction: string;
+    checkBillingQuotaFunction: string;
+}
+export interface InferenceLogConfig {
+    schema: string;
+    tableName: string;
+}
+export interface AgentChatConfig {
+    schemaName: string;
+    threadTableName: string | null;
+    messageTableName: string | null;
+    taskTableName: string | null;
+}
 /**
  * Maps built-in loader names to their resolved types.
  *
@@ -134,6 +150,9 @@ export interface BuiltinModuleMap {
     authSettings: AuthSettings;
     pubkeyChallengeSettings: PubkeyChallengeSettings;
     webauthnSettings: WebauthnSettings;
+    billing: BillingConfig;
+    inferenceLog: InferenceLogConfig;
+    agentChat: AgentChatConfig;
 }
 /**
  * Callback for executing queries within a tenant-scoped transaction