@qelos/global-types 4.2.0 → 4.2.1

package/dist/qelos-integrator.js

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * Shared contracts every Qelos framework integrator (`@qelos/integrator-*`)
+ * builds upon. Defined here — rather than in each integrator — so the
+ * per-request shape and configuration surface are guaranteed identical across
+ * frameworks.
+ *
+ * `@qelos/sdk` depends on `@qelos/global-types`, so this file deliberately
+ * avoids importing from the SDK; instead, {@link QelosContext} is generic over
+ * the SDK instance type and integrators specialize it with the concrete
+ * `QelosSDK` / `IUser` / `IWorkspace` types from `@qelos/sdk`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=qelos-integrator.js.map

package/dist/qelos-integrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qelos-integrator.js","sourceRoot":"","sources":["../qelos-integrator.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG"}

package/dist/query-filters.d.ts

@@ -0,0 +1,7 @@
+export interface ICommonQueryFilters {
+    $populate?: boolean;
+    $sort?: string;
+    $limit?: number;
+    $page?: number;
+    $flat?: boolean;
+}

package/dist/query-filters.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=query-filters.js.map

package/dist/query-filters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-filters.js","sourceRoot":"","sources":["../query-filters.ts"],"names":[],"mappings":""}

package/dist/screen-requirement.d.ts

@@ -0,0 +1,22 @@
+export interface IScreenRequirement {
+    key: string;
+    fromHTTP?: {
+        uri: string;
+        method: string;
+        query?: any;
+    };
+    fromCrud?: {
+        name: string;
+        identifier?: string;
+        query?: any;
+    };
+    fromBlueprint?: {
+        name: string;
+        identifier?: string;
+        query?: any;
+        dependsOn?: string;
+        dependsField?: string;
+    };
+    fromData?: any;
+    lazy?: boolean;
+}

package/dist/screen-requirement.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=screen-requirement.js.map

package/dist/screen-requirement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen-requirement.js","sourceRoot":"","sources":["../screen-requirement.ts"],"names":[],"mappings":""}

package/dist/workspace-configuration-metadata.d.ts

@@ -0,0 +1,17 @@
+export interface WorkspaceLabelDefinition {
+    title: string;
+    description: string;
+    value: string[];
+    allowedRolesForCreation?: string[];
+}
+export interface WorkspaceConfigurationMetadata {
+    isActive: boolean;
+    creationPrivilegedRoles: string[];
+    viewMembersPrivilegedWsRoles: string[];
+    labels: WorkspaceLabelDefinition[];
+    allowNonLabeledWorkspaces: boolean;
+    allowNonWorkspaceUsers: boolean;
+    allowLogo?: boolean;
+    createWorkspacePageTitle?: string;
+    labelsSelectorTitle?: string;
+}

package/dist/workspace-configuration-metadata.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=workspace-configuration-metadata.js.map

package/dist/workspace-configuration-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-configuration-metadata.js","sourceRoot":"","sources":["../workspace-configuration-metadata.ts"],"names":[],"mappings":""}

package/index.ts

@@ -10,6 +10,9 @@ export * from './query-filters'
 export * from './workspace-configuration-metadata'
 export * from './auth-configuration-metadata'
 export * from './app-configuration-metadata'
+export * from './mcp-configuration-metadata'
+export * from './mcp-endpoint'
+export * from './ai-models'
 export * from './integration-sources'
 export * from './integration-source-status'
 export * from './integration'

package/integration-sources.ts

@@ -40,6 +40,7 @@ export enum QelosTriggerOperation {
   webhook = 'webhook',
   apiWebhook = 'apiWebhook',
   chatCompletion = 'chatCompletion',
+  mcpTool = 'mcpTool',
 }
 
 export enum QelosTargetOperation {
@@ -283,6 +284,15 @@ export interface IOpenAISource extends IIntegrationSource {
 export interface IClaudeAiSource extends IIntegrationSource {
   _id?: string;
   kind: IntegrationSourceKind.ClaudeAi;
+  authentication: {
+    token: string;
+  };
+  metadata: {
+    /** Custom API base URL when using a proxy or compatible endpoint. */
+    apiUrl?: string;
+    defaultModel?: string | null;
+    initialMessages?: { role: string; content: string }[];
+  };
 }
 
 export interface IGeminiSource extends IIntegrationSource {

package/integration.ts

@@ -33,6 +33,7 @@ export interface IIntegration {
   trigger: IIntegrationEntity;
   target: IIntegrationEntity;
   dataManipulation: IDataManipulationStep[]
+  targetManipulation: IDataManipulationStep[]
   created: Date;
 }
 

package/mcp-configuration-metadata.ts

@@ -0,0 +1,33 @@
+/** Tool categories that must never be exposed via MCP (e.g. secrets vault). */
+export const MCP_FORBIDDEN_TOOL_IDS = ['secrets'] as const;
+
+export interface IMcpExposedTool {
+  toolId: string;
+  enabled: boolean;
+  roles: string[];
+  wsRoles: string[];
+  wsLabels: string[];
+}
+
+export interface IMcpConfigurationMetadata {
+  enabled: boolean;
+  permittedCallbackUrls: string[];
+  exposedTools: IMcpExposedTool[];
+  adminOnly: boolean;
+  serverName?: string;
+  serverVersion?: string;
+  loginUrl?: string;
+}
+
+export function sanitizeMcpConfigurationMetadata(
+  configuration: IMcpConfigurationMetadata,
+): IMcpConfigurationMetadata {
+  const forbidden = new Set<string>(MCP_FORBIDDEN_TOOL_IDS);
+
+  return {
+    ...configuration,
+    exposedTools: (configuration.exposedTools || []).filter(
+      (tool) => !forbidden.has(tool.toolId),
+    ),
+  };
+}

package/mcp-endpoint.ts

@@ -0,0 +1,12 @@
+export const MCP_ADMIN_PATH = '/api/mcp/admin';
+
+export const MCP_DOCS_BASE_URL = 'https://docs.qelos.io/mcp';
+
+export const MCP_DOCS_CONFIGURATION_URL = `${MCP_DOCS_BASE_URL}/configuration.html`;
+
+export const MCP_DOCS_CLIENTS_URL = `${MCP_DOCS_BASE_URL}/clients.html`;
+
+export function buildMcpAdminEndpointUrl(origin: string): string {
+  const trimmedOrigin = origin.replace(/\/+$/, '');
+  return `${trimmedOrigin}${MCP_ADMIN_PATH}`;
+}

package/package.json

@@ -1,14 +1,20 @@
 {
   "name": "@qelos/global-types",
-  "version": "4.2.0",
+  "version": "4.2.1",
   "description": "",
-  "main": "index.ts",
-  "types": "index.ts",
+  "main": "dist/index.js",
+  "module": "index.ts",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc"
+  },
   "author": "",
   "gitHead": "13468bc51557291935b96b1aeaa837b8b52861e8",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {}
-}
+  "devDependencies": {
+    "typescript": "^5.4.5"
+  }
+}

package/payments.ts

@@ -13,6 +13,23 @@ export type InvoiceStatus = 'paid' | 'pending' | 'failed' | 'refunded';
 /** Type of discount a coupon provides. */
 export type CouponDiscountType = 'percentage' | 'fixed';
 
+/**
+ * Real-world identity of the billable entity, passed through checkout so payment
+ * providers (e.g. Sumit) can create a properly-named customer record instead of
+ * falling back to the raw billable entity ID.
+ */
+export interface CheckoutCustomer {
+  name?: string;
+  /** Legal/invoice name, e.g. a company name distinct from the contact's personal name. */
+  nameForInvoice?: string;
+  email?: string;
+  phone?: string;
+  address?: string;
+  city?: string;
+  /** Company tax/VAT identifier. */
+  taxId?: string;
+}
+
 /** Tenant payments settings stored in the `payments-configuration` configuration key. */
 export interface IPaymentsConfigurationMetadata {
   isEnabled?: boolean;

package/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "module": "commonjs",
+    "target": "esnext",
+    "outDir": "./dist",
+    "sourceMap": true,
+    "declaration": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true
+  },
+  "exclude": [
+    "node_modules",
+    "dist",
+    "**/*.test.ts"
+  ]
+}

package/LICENSE

@@ -1,20 +0,0 @@
-Polyform Shield License 1.0.0
-
-Copyright (c) 2025 Velocitech LTD
-
-Your use of this software is governed by the Polyform Shield License 1.0.0.
-
-You may obtain a copy of the License at:
-https://polyformproject.org/licenses/shield/1.0.0
-
-Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-
-Additional Terms – Exception Notice:
-
-The author of this software grants additional permissions beyond the Polyform Shield License 1.0.0:
-
-✅ All uses of the software are permitted — including modification, distribution, commercial use, and sublicensing — as long as the software is not used to create, offer, or operate any product or service that competes directly with Qelos (https://qelos.io), a no-code platform for building AI-assisted SaaS applications.
-
-❌ "Direct competition" includes platforms, tools, or services that enable users to visually or programmatically create SaaS applications with the assistance of artificial intelligence.
-
-This exception does not modify the terms of the original Polyform Shield License for other users and applies only by explicit permission of the licensor.