@classytic/arc 2.5.0 → 2.5.1

package/dist/index.mjs

@@ -127,6 +127,6 @@ function transform(name, handlerOrOptions) {
 }
 //#endregion
 //#region src/index.ts
-const version = "2.5.0";
+const version = "2.5.1";
 //#endregion
 export { ArcError, BaseController, CRUD_OPERATIONS, DEFAULT_ID_FIELD, DEFAULT_LIMIT, DEFAULT_MAX_LIMIT, DEFAULT_SORT, DEFAULT_TENANT_FIELD, DEFAULT_UPDATE_METHOD, ForbiddenError, HOOK_OPERATIONS, HOOK_PHASES, MAX_FILTER_DEPTH, MAX_REGEX_LENGTH, MAX_SEARCH_LENGTH, MUTATION_OPERATIONS, MongooseAdapter, NotFoundError, PrismaAdapter, RESERVED_QUERY_PARAMS, ResourceDefinition, SYSTEM_FIELDS, UnauthorizedError, ValidationError, adminOnly, allOf, allowPublic, anyOf, applyFieldReadPermissions, applyFieldWritePermissions, arcLog, assertValidConfig, authenticated, configureArcLogger, createDomainError, createDynamicPermissionMatrix, createMongooseAdapter, createOrgPermissions, createPrismaAdapter, defineResource, denyAll, envelope, fields, formatValidationErrors, fullPublic, getControllerScope, guard, intercept, middleware, ownerWithAdminBypass, presets_exports as permissions, pipe, publicRead, publicReadAdminWrite, readOnly, requestContext, requireAuth, requireOrgMembership, requireOrgRole, requireOwnership, requireRoles, requireTeamMembership, sortMiddlewares, transform, validateResourceConfig, version, when };

package/dist/integrations/mcp/index.d.mts

@@ -75,6 +75,8 @@ interface FieldRulesToZodOptions {
   extraHideFields?: string[];
   /** Filterable fields — only used in list mode */
   filterableFields?: readonly string[];
+  /** Allowed filter operators — generates `field[op]` entries in list mode (e.g., price[gt], price[lte]) */
+  allowedOperators?: readonly string[];
 }
 /** Single field rule entry from Arc's schemaOptions.fieldRules */
 interface FieldRuleEntry {

package/dist/integrations/mcp/index.mjs

@@ -1,4 +1,4 @@
-import { n as fieldRulesToZod, r as createMcpServer, t as resourceToTools } from "../../resourceToTools-CN0lwJrL.mjs";
+import { n as fieldRulesToZod, r as createMcpServer, t as resourceToTools } from "../../resourceToTools-B1B1svLx.mjs";
 import { createHash } from "node:crypto";
 import fp from "fastify-plugin";
 //#region src/integrations/mcp/definePrompt.ts

package/dist/integrations/mcp/testing.mjs

@@ -1,4 +1,4 @@
-import { r as createMcpServer, t as resourceToTools } from "../../resourceToTools-CN0lwJrL.mjs";
+import { r as createMcpServer, t as resourceToTools } from "../../resourceToTools-B1B1svLx.mjs";
 //#region src/integrations/mcp/testing.ts
 /**
 * @classytic/arc/mcp/testing — MCP Test Utilities

package/dist/plugins/tracing-entry.mjs

@@ -44,7 +44,7 @@ try {
 function createTracerProvider(options) {
 	if (!isAvailable) return null;
 	const { serviceName = "@classytic/arc", serviceVersion, exporterUrl = "http://localhost:4318/v1/traces" } = options;
-	const resolvedVersion = serviceVersion ?? "2.5.0";
+	const resolvedVersion = serviceVersion ?? "2.5.1";
 	const exporter = new OTLPTraceExporter({ url: exporterUrl });
 	const provider = new NodeTracerProvider({ resource: { attributes: {
 		"service.name": serviceName,

package/dist/{resourceToTools-CN0lwJrL.mjs → resourceToTools-B1B1svLx.mjs}

@@ -148,16 +148,55 @@ function typeToZod(type) {
 		default: return z.string();
 	}
 }
-/** Build list/query shape with filterable fields + pagination */
+/** Operators that apply to numeric/date fields */
+const COMPARISON_OPS = new Set([
+	"gt",
+	"gte",
+	"lt",
+	"lte"
+]);
+/** Map operator to a human-readable description suffix */
+function opDescription(op, fieldName) {
+	switch (op) {
+		case "gt": return `${fieldName} greater than`;
+		case "gte": return `${fieldName} greater than or equal`;
+		case "lt": return `${fieldName} less than`;
+		case "lte": return `${fieldName} less than or equal`;
+		case "ne": return `${fieldName} not equal to`;
+		case "in": return `${fieldName} in comma-separated list`;
+		case "nin": return `${fieldName} not in comma-separated list`;
+		case "exists": return `${fieldName} exists (true/false)`;
+		default: return `${fieldName} ${op}`;
+	}
+}
+/** Build list/query shape with filterable fields, operators, and pagination */
 function buildListShape(fieldRules, options) {
-	const { filterableFields = [], hiddenFields = [], extraHideFields = [] } = options;
+	const { filterableFields = [], hiddenFields = [], extraHideFields = [], allowedOperators } = options;
 	const allHidden = new Set([...hiddenFields, ...extraHideFields]);
 	const shape = { ...PAGINATION_SHAPE };
-	if (fieldRules) for (const name of filterableFields) {
+	if (!fieldRules) return shape;
+	for (const name of filterableFields) {
 		if (allHidden.has(name)) continue;
 		const rule = fieldRules[name];
 		if (!rule) continue;
-		shape[name] = buildFieldSchema(rule).optional();
+		const filterField = buildFieldSchema(rule);
+		shape[name] = filterField.optional();
+		if (allowedOperators?.length) {
+			const isNumericOrDate = rule.type === "number" || rule.type === "date";
+			for (const op of allowedOperators) {
+				if (COMPARISON_OPS.has(op) && !isNumericOrDate) continue;
+				if (op === "eq") continue;
+				if (op === "exists") {
+					shape[`${name}_${op}`] = z.boolean().optional().describe(opDescription(op, name));
+					continue;
+				}
+				if (op === "in" || op === "nin") {
+					shape[`${name}_${op}`] = z.string().optional().describe(opDescription(op, name));
+					continue;
+				}
+				shape[`${name}_${op}`] = filterField.optional().describe(opDescription(op, name));
+			}
+		}
 	}
 	return shape;
 }
@@ -193,7 +232,7 @@ function buildRequestContext(input, auth, operation, policyFilters) {
 		case "list": return {
 			...base,
 			params: {},
-			query: { ...input },
+			query: expandOperatorKeys(input),
 			body: void 0
 		};
 		case "get": return {
@@ -225,6 +264,40 @@ function buildRequestContext(input, auth, operation, policyFilters) {
 		};
 	}
 }
+/** Convert MCP operator keys (`price_gt`) to MongoKit bracket notation (`price[gt]`). */
+const OPERATOR_SUFFIXES = new Set([
+	"eq",
+	"ne",
+	"gt",
+	"gte",
+	"lt",
+	"lte",
+	"in",
+	"nin",
+	"exists"
+]);
+function expandOperatorKeys(input) {
+	const out = {};
+	for (const [key, value] of Object.entries(input)) {
+		const lastUnderscore = key.lastIndexOf("_");
+		if (lastUnderscore > 0) {
+			const op = key.slice(lastUnderscore + 1);
+			if (OPERATOR_SUFFIXES.has(op)) {
+				const field = key.slice(0, lastUnderscore);
+				const existing = out[field];
+				if (existing && typeof existing === "object" && existing !== null) existing[op] = value;
+				else if (existing === void 0) out[field] = { [op]: value };
+				else out[field] = {
+					eq: existing,
+					[op]: value
+				};
+				continue;
+			}
+		}
+		out[key] = value;
+	}
+	return out;
+}
 function buildScope(auth) {
 	if (!auth) return { kind: "public" };
 	if (auth.organizationId) return {
@@ -314,7 +387,8 @@ function resourceToTools(resource, config = {}) {
 				hiddenFields,
 				readonlyFields,
 				extraHideFields: config.hideFields,
-				filterableFields
+				filterableFields,
+				allowedOperators
 			}),
 			handler: createHandler(op, controller, resource.name, resource.permissions)
 		});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classytic/arc",
-  "version": "2.5.0",
+  "version": "2.5.1",
   "description": "Resource-oriented backend framework for Fastify — clean, minimal, powerful, tree-shakable",
   "type": "module",
   "exports": {