@classytic/arc 2.15.3 → 2.16.0

package/dist/cli/commands/introspect.mjs

@@ -1,13 +1,5 @@
-import { t as ResourceRegistry } from "../../ResourceRegistry-CTERg_2x.mjs";
-import { resolve } from "node:path";
-import { pathToFileURL } from "node:url";
+import { t as loadResourcesFromEntry } from "../../loadResourcesFromEntry-BLMEI2Xa.mjs";
 //#region src/cli/commands/introspect.ts
-/**
-* Arc CLI - Introspect Command
-*
-* Shows all registered resources and their configuration.
-* Requires an entry file that exports defineResource() results.
-*/
 function describePermission(value) {
 	if (!value) return "none";
 	if (typeof value === "function") return value.name ? `${value.name}()` : "[anonymous permission function]";
@@ -17,64 +9,61 @@ function describePermission(value) {
 }
 async function introspect(args) {
 	console.log("Introspecting Arc resources...\n");
-	try {
-		const entryPath = args[0];
-		if (!entryPath) {
-			console.log("Usage: arc introspect <entry-file>\n");
-			console.log("Where entry-file exports your defineResource() results.");
-			console.log("Example: arc introspect ./src/resources.js");
-			return;
+	const entryPath = args[0];
+	if (!entryPath) {
+		console.log("Usage: arc introspect <entry-file>\n");
+		console.log("Where entry-file exports your defineResource() results.");
+		console.log("Example: arc introspect ./src/resources.js");
+		return;
+	}
+	const { registry, registered } = await loadResourcesFromEntry(entryPath);
+	if (registered === 0) {
+		console.log("No resource definitions found in entry file.");
+		console.log("\nMake sure your file exports defineResource() results:");
+		console.log("  export const productResource = defineResource({ ... });");
+		return;
+	}
+	const resources = registry.getAll();
+	console.log(`Found ${resources.length} resource(s):\n`);
+	resources.forEach((resource, index) => {
+		console.log(`${index + 1}. ${resource.name}`);
+		console.log(`   Display Name: ${resource.displayName}`);
+		console.log(`   Prefix: ${resource.prefix}`);
+		console.log(`   Module: ${resource.module || "none"}`);
+		if (resource.permissions) {
+			console.log(`   Permissions:`);
+			Object.entries(resource.permissions).forEach(([op, permission]) => {
+				console.log(`     ${op}: ${describePermission(permission)}`);
+			});
 		}
-		const entryModule = await import(pathToFileURL(resolve(process.cwd(), entryPath)).href);
-		const registry = new ResourceRegistry();
-		let registered = 0;
-		function tryRegister(value) {
-			if (value && typeof value === "object" && "name" in value && "_registryMeta" in value && "toPlugin" in value) {
-				registry.register(value, value._registryMeta ?? {});
-				registered++;
-			}
+		if (resource.presets && resource.presets.length > 0) console.log(`   Presets: ${resource.presets.join(", ")}`);
+		const tf = resource.tenantField;
+		const purge = resource.resolvedTenantPurge;
+		if (tf !== void 0 || purge) {
+			const parts = [];
+			if (tf === false) parts.push("tenantField: false (company-wide)");
+			else if (typeof tf === "string") parts.push(`tenantField: ${tf}`);
+			if (purge && purge.source !== "disabled") parts.push(`onOrgDelete: ${purge.strategy.type} (${purge.source})`);
+			if (parts.length > 0) console.log(`   Tenancy: ${parts.join(" · ")}`);
 		}
-		for (const exported of Object.values(entryModule)) if (Array.isArray(exported)) exported.forEach(tryRegister);
-		else tryRegister(exported);
-		if (registered === 0) {
-			console.log("No resource definitions found in entry file.");
-			console.log("\nMake sure your file exports defineResource() results:");
-			console.log("  export const productResource = defineResource({ ... });");
-			return;
+		if (resource.customRoutes && resource.customRoutes.length > 0) console.log(`   Additional Routes: ${resource.customRoutes.length}`);
+		if (resource.actions && resource.actions.length > 0) {
+			const fallback = resource.actionPermissions ? ` (fallback: ${describePermission(resource.actionPermissions)})` : "";
+			const names = resource.actions.map((a) => a.id === false ? `${a.name} @/action` : a.name).join(", ");
+			console.log(`   Actions: ${names}${fallback}`);
 		}
-		const resources = registry.getAll();
-		console.log(`Found ${resources.length} resource(s):\n`);
-		resources.forEach((resource, index) => {
-			console.log(`${index + 1}. ${resource.name}`);
-			console.log(`   Display Name: ${resource.displayName}`);
-			console.log(`   Prefix: ${resource.prefix}`);
-			console.log(`   Module: ${resource.module || "none"}`);
-			if (resource.permissions) {
-				console.log(`   Permissions:`);
-				Object.entries(resource.permissions).forEach(([op, permission]) => {
-					console.log(`     ${op}: ${describePermission(permission)}`);
-				});
-			}
-			if (resource.presets && resource.presets.length > 0) console.log(`   Presets: ${resource.presets.join(", ")}`);
-			if (resource.customRoutes && resource.customRoutes.length > 0) console.log(`   Additional Routes: ${resource.customRoutes.length}`);
-			if (resource.actions && resource.actions.length > 0) {
-				const fallback = resource.actionPermissions ? ` (fallback: ${describePermission(resource.actionPermissions)})` : "";
-				console.log(`   Actions: ${resource.actions.map((a) => a.name).join(", ")}${fallback}`);
-			}
-			if (resource.aggregations && resource.aggregations.length > 0) console.log(`   Aggregations: ${resource.aggregations.map((a) => a.name).join(", ")}`);
-			console.log("");
-		});
-		const stats = registry.getStats();
-		console.log("Summary:");
-		console.log(`  Total Resources: ${stats.totalResources}`);
-		console.log(`  With Presets: ${resources.filter((r) => r.presets?.length > 0).length}`);
-		console.log(`  With Custom Routes: ${resources.filter((r) => r.customRoutes && r.customRoutes.length > 0).length}`);
-		console.log(`  With Actions: ${resources.filter((r) => r.actions && r.actions.length > 0).length}`);
-		console.log(`  With Aggregations: ${resources.filter((r) => r.aggregations && r.aggregations.length > 0).length}`);
-	} catch (error) {
-		if (error instanceof Error) throw error;
-		throw new Error(String(error));
-	}
+		if (resource.aggregations && resource.aggregations.length > 0) console.log(`   Aggregations: ${resource.aggregations.map((a) => a.name).join(", ")}`);
+		console.log("");
+	});
+	const stats = registry.getStats();
+	console.log("Summary:");
+	console.log(`  Total Resources: ${stats.totalResources}`);
+	console.log(`  With Presets: ${resources.filter((r) => r.presets?.length > 0).length}`);
+	console.log(`  With Custom Routes: ${resources.filter((r) => r.customRoutes && r.customRoutes.length > 0).length}`);
+	console.log(`  With Actions: ${resources.filter((r) => r.actions && r.actions.length > 0).length}`);
+	console.log(`  With Aggregations: ${resources.filter((r) => r.aggregations && r.aggregations.length > 0).length}`);
+	const cascadeCount = resources.filter((r) => r.resolvedTenantPurge && r.resolvedTenantPurge.source !== "disabled").length;
+	console.log(`  Cascading on Org-Delete: ${cascadeCount}`);
 }
 //#endregion
 export { introspect };

package/dist/cli/index.d.mts

@@ -1,7 +1,7 @@
 import { describe } from "./commands/describe.mjs";
 import { exportDocs } from "./commands/docs.mjs";
 import { doctor } from "./commands/doctor.mjs";
-import { generate } from "./commands/generate.mjs";
-import { init } from "./commands/init.mjs";
+import { n as generate } from "../generate-BWFwgcCM.mjs";
+import { t as init } from "../init-Dv71MsJr.mjs";
 import { introspect } from "./commands/introspect.mjs";
 export { describe, doctor, exportDocs, generate, init, introspect };

package/dist/cli/index.mjs

@@ -1,7 +1,7 @@
 import { describe } from "./commands/describe.mjs";
 import { exportDocs } from "./commands/docs.mjs";
 import { doctor } from "./commands/doctor.mjs";
-import { generate } from "./commands/generate.mjs";
-import { init } from "./commands/init.mjs";
+import { t as generate } from "../generate-CYac-OLv.mjs";
+import { t as init } from "../init-HDvoO9L5.mjs";
 import { introspect } from "./commands/introspect.mjs";
 export { describe, doctor, exportDocs, generate, init, introspect };

package/dist/{constants-Cxde4rpC.mjs → constants-TrJVIJl0.mjs}

@@ -66,6 +66,12 @@ const MAX_FILTER_DEPTH = 10;
 /**
 * Query parameters consumed by the framework — never treated as filters.
 * Shared by all query parsers (Arc built-in, Prisma, custom).
+*
+* `filter` is reserved so the bracket-wrapped form
+* (`?filter[foo.bar]=X` / `?filter[price][gte]=40`) lands as the parser's
+* canonical filter envelope instead of being attempted as a flat field
+* filter. See `ArcQueryParser.parseFilters()` for the unwrap step that
+* merges `q.filter[*]` back into the top-level filter map.
 */
 const RESERVED_QUERY_PARAMS = Object.freeze(new Set([
 	"page",
@@ -77,6 +83,7 @@ const RESERVED_QUERY_PARAMS = Object.freeze(new Set([
 	"after",
 	"cursor",
 	"lean",
+	"filter",
 	"_policyFilters"
 ]));
 //#endregion

package/dist/core/index.d.mts

@@ -1,3 +1,3 @@
-import { $t as SoftDeleteMixin, B as defineResource, Ct as AggregationConfig, Dt as AggregationMaterializedResult, Et as AggregationMaterializedContext, Ot as AggregationRateLimit, Qt as SoftDeleteExt, St as AggregationCacheConfig, Tt as AggregationIndexHint, V as ResourceDefinition, Zt as BaseController, _n as ListResult, an as BulkMixin, bn as AccessControl, bt as AggMeasureInput, cn as ControllerConfigurableOptions, dn as QueryResolverConfig, en as TreeExt, in as BulkExt, kt as AggregationsMap, ln as ControllerConstructionOptions, nn as SlugExt, on as BaseControllerOptions, rn as SlugMixin, sn as BaseCrudController, tn as TreeMixin, un as QueryResolver, vn as BodySanitizer, wt as AggregationDateRangeRequirement, xn as AccessControlConfig, xt as AggMeasureShorthand, yn as BodySanitizerConfig } from "../index-BswOSJCE.mjs";
-import { A as MAX_SEARCH_LENGTH, C as DEFAULT_UPDATE_METHOD, D as HookPhase, E as HookOperation, M as MutationOperation, N as RESERVED_QUERY_PARAMS, O as MAX_FILTER_DEPTH, P as SYSTEM_FIELDS, S as DEFAULT_TENANT_FIELD, T as HOOK_PHASES, _ as CrudOperation, a as createRequestContext, b as DEFAULT_MAX_LIMIT, c as sendControllerResponse, d as getEntityQuery, f as defineResourceVariants, g as CRUD_OPERATIONS, h as defineAggregation, i as createFastifyHandler, j as MUTATION_OPERATIONS, k as MAX_REGEX_LENGTH, l as getEntityId, m as createPermissionMiddleware, n as isFieldReadable, o as getControllerContext, p as createCrudRouter, r as createCrudHandlers, s as getControllerScope, t as collectReadBlockedFields, u as getEntityIdField, v as DEFAULT_ID_FIELD, w as HOOK_OPERATIONS, x as DEFAULT_SORT, y as DEFAULT_LIMIT } from "../index-BstGxcc3.mjs";
-export { AccessControl, AccessControlConfig, AggMeasureInput, AggMeasureShorthand, AggregationCacheConfig, AggregationConfig, AggregationDateRangeRequirement, AggregationIndexHint, AggregationMaterializedContext, AggregationMaterializedResult, AggregationRateLimit, AggregationsMap, BaseController, BaseControllerOptions, BaseCrudController, BodySanitizer, BodySanitizerConfig, BulkExt, BulkMixin, CRUD_OPERATIONS, ControllerConfigurableOptions, ControllerConstructionOptions, CrudOperation, DEFAULT_ID_FIELD, DEFAULT_LIMIT, DEFAULT_MAX_LIMIT, DEFAULT_SORT, DEFAULT_TENANT_FIELD, DEFAULT_UPDATE_METHOD, HOOK_OPERATIONS, HOOK_PHASES, HookOperation, HookPhase, ListResult, MAX_FILTER_DEPTH, MAX_REGEX_LENGTH, MAX_SEARCH_LENGTH, MUTATION_OPERATIONS, MutationOperation, QueryResolver, QueryResolverConfig, RESERVED_QUERY_PARAMS, ResourceDefinition, SYSTEM_FIELDS, SlugExt, SlugMixin, SoftDeleteExt, SoftDeleteMixin, TreeExt, TreeMixin, collectReadBlockedFields, createCrudHandlers, createCrudRouter, createFastifyHandler, createPermissionMiddleware, createRequestContext, defineAggregation, defineResource, defineResourceVariants, getControllerContext, getControllerScope, getEntityId, getEntityIdField, getEntityQuery, isFieldReadable, sendControllerResponse };
+import { $t as BaseController, At as AggregationRateLimit, B as defineResource, Cn as AccessControlConfig, Ct as AggMeasureShorthand, Dt as AggregationIndexHint, Et as AggregationDateRangeRequirement, Ot as AggregationMaterializedContext, Sn as AccessControl, St as AggMeasureInput, Tt as AggregationConfig, V as ResourceDefinition, an as SlugMixin, bn as BodySanitizer, cn as BaseControllerOptions, dn as ControllerConstructionOptions, en as SoftDeleteExt, fn as QueryResolver, in as SlugExt, jt as AggregationsMap, kt as AggregationMaterializedResult, ln as BaseCrudController, nn as TreeExt, on as BulkExt, pn as QueryResolverConfig, rn as TreeMixin, sn as BulkMixin, tn as SoftDeleteMixin, un as ControllerConfigurableOptions, wt as AggregationCacheConfig, xn as BodySanitizerConfig, yn as ListResult } from "../index-CkW0flkU.mjs";
+import { A as MAX_FILTER_DEPTH, C as DEFAULT_SORT, D as HOOK_PHASES, E as HOOK_OPERATIONS, F as RESERVED_QUERY_PARAMS, I as SYSTEM_FIELDS, M as MAX_SEARCH_LENGTH, N as MUTATION_OPERATIONS, O as HookOperation, P as MutationOperation, S as DEFAULT_MAX_LIMIT, T as DEFAULT_UPDATE_METHOD, _ as defineAggregation, a as createRequestContext, b as DEFAULT_ID_FIELD, c as sendControllerResponse, d as getEntityQuery, f as defineResourceVariants, g as createPermissionMiddleware, h as createCrudRouter, i as createFastifyHandler, j as MAX_REGEX_LENGTH, k as HookPhase, l as getEntityId, m as defineAction, n as isFieldReadable, o as getControllerContext, p as DefineActionConfig, r as createCrudHandlers, s as getControllerScope, t as collectReadBlockedFields, u as getEntityIdField, v as CRUD_OPERATIONS, w as DEFAULT_TENANT_FIELD, x as DEFAULT_LIMIT, y as CrudOperation } from "../index-B-ulKx5P.mjs";
+export { AccessControl, AccessControlConfig, AggMeasureInput, AggMeasureShorthand, AggregationCacheConfig, AggregationConfig, AggregationDateRangeRequirement, AggregationIndexHint, AggregationMaterializedContext, AggregationMaterializedResult, AggregationRateLimit, AggregationsMap, BaseController, BaseControllerOptions, BaseCrudController, BodySanitizer, BodySanitizerConfig, BulkExt, BulkMixin, CRUD_OPERATIONS, ControllerConfigurableOptions, ControllerConstructionOptions, CrudOperation, DEFAULT_ID_FIELD, DEFAULT_LIMIT, DEFAULT_MAX_LIMIT, DEFAULT_SORT, DEFAULT_TENANT_FIELD, DEFAULT_UPDATE_METHOD, DefineActionConfig, HOOK_OPERATIONS, HOOK_PHASES, HookOperation, HookPhase, ListResult, MAX_FILTER_DEPTH, MAX_REGEX_LENGTH, MAX_SEARCH_LENGTH, MUTATION_OPERATIONS, MutationOperation, QueryResolver, QueryResolverConfig, RESERVED_QUERY_PARAMS, ResourceDefinition, SYSTEM_FIELDS, SlugExt, SlugMixin, SoftDeleteExt, SoftDeleteMixin, TreeExt, TreeMixin, collectReadBlockedFields, createCrudHandlers, createCrudRouter, createFastifyHandler, createPermissionMiddleware, createRequestContext, defineAction, defineAggregation, defineResource, defineResourceVariants, getControllerContext, getControllerScope, getEntityId, getEntityIdField, getEntityQuery, isFieldReadable, sendControllerResponse };

package/dist/core/index.mjs

@@ -1,5 +1,5 @@
-import { a as DEFAULT_SORT, c as HOOK_OPERATIONS, d as MAX_REGEX_LENGTH, f as MAX_SEARCH_LENGTH, h as SYSTEM_FIELDS, i as DEFAULT_MAX_LIMIT, l as HOOK_PHASES, m as RESERVED_QUERY_PARAMS, n as DEFAULT_ID_FIELD, o as DEFAULT_TENANT_FIELD, p as MUTATION_OPERATIONS, r as DEFAULT_LIMIT, s as DEFAULT_UPDATE_METHOD, t as CRUD_OPERATIONS, u as MAX_FILTER_DEPTH } from "../constants-Cxde4rpC.mjs";
-import { a as BulkMixin, c as collectReadBlockedFields, d as AccessControl, i as SlugMixin, l as isFieldReadable, n as TreeMixin, o as BaseCrudController, r as SoftDeleteMixin, s as QueryResolver, t as BaseController, u as BodySanitizer } from "../BaseController-dx3m2J8V.mjs";
-import { _ as getControllerContext, g as createRequestContext, h as createFastifyHandler, m as createCrudHandlers, v as getControllerScope, y as sendControllerResponse } from "../routerShared-DrOa-26E.mjs";
-import { a as defineResource, c as createPermissionMiddleware, i as defineResourceVariants, l as defineAggregation, n as getEntityIdField, o as ResourceDefinition, r as getEntityQuery, s as createCrudRouter, t as getEntityId } from "../core-CvmOqEms.mjs";
-export { AccessControl, BaseController, BaseCrudController, BodySanitizer, BulkMixin, CRUD_OPERATIONS, DEFAULT_ID_FIELD, DEFAULT_LIMIT, DEFAULT_MAX_LIMIT, DEFAULT_SORT, DEFAULT_TENANT_FIELD, DEFAULT_UPDATE_METHOD, HOOK_OPERATIONS, HOOK_PHASES, MAX_FILTER_DEPTH, MAX_REGEX_LENGTH, MAX_SEARCH_LENGTH, MUTATION_OPERATIONS, QueryResolver, RESERVED_QUERY_PARAMS, ResourceDefinition, SYSTEM_FIELDS, SlugMixin, SoftDeleteMixin, TreeMixin, collectReadBlockedFields, createCrudHandlers, createCrudRouter, createFastifyHandler, createPermissionMiddleware, createRequestContext, defineAggregation, defineResource, defineResourceVariants, getControllerContext, getControllerScope, getEntityId, getEntityIdField, getEntityQuery, isFieldReadable, sendControllerResponse };
+import { a as DEFAULT_SORT, c as HOOK_OPERATIONS, d as MAX_REGEX_LENGTH, f as MAX_SEARCH_LENGTH, h as SYSTEM_FIELDS, i as DEFAULT_MAX_LIMIT, l as HOOK_PHASES, m as RESERVED_QUERY_PARAMS, n as DEFAULT_ID_FIELD, o as DEFAULT_TENANT_FIELD, p as MUTATION_OPERATIONS, r as DEFAULT_LIMIT, s as DEFAULT_UPDATE_METHOD, t as CRUD_OPERATIONS, u as MAX_FILTER_DEPTH } from "../constants-TrJVIJl0.mjs";
+import { a as BulkMixin, c as collectReadBlockedFields, d as AccessControl, i as SlugMixin, l as isFieldReadable, n as TreeMixin, o as BaseCrudController, r as SoftDeleteMixin, s as QueryResolver, t as BaseController, u as BodySanitizer } from "../BaseController-DlCCTIxJ.mjs";
+import { _ as getControllerContext, g as createRequestContext, h as createFastifyHandler, m as createCrudHandlers, v as getControllerScope, y as sendControllerResponse } from "../routerShared-CZV5aabX.mjs";
+import { a as defineResource, c as createCrudRouter, i as defineResourceVariants, l as createPermissionMiddleware, n as getEntityIdField, o as ResourceDefinition, r as getEntityQuery, s as defineAction, t as getEntityId, u as defineAggregation } from "../core-DBJ_j6rX.mjs";
+export { AccessControl, BaseController, BaseCrudController, BodySanitizer, BulkMixin, CRUD_OPERATIONS, DEFAULT_ID_FIELD, DEFAULT_LIMIT, DEFAULT_MAX_LIMIT, DEFAULT_SORT, DEFAULT_TENANT_FIELD, DEFAULT_UPDATE_METHOD, HOOK_OPERATIONS, HOOK_PHASES, MAX_FILTER_DEPTH, MAX_REGEX_LENGTH, MAX_SEARCH_LENGTH, MUTATION_OPERATIONS, QueryResolver, RESERVED_QUERY_PARAMS, ResourceDefinition, SYSTEM_FIELDS, SlugMixin, SoftDeleteMixin, TreeMixin, collectReadBlockedFields, createCrudHandlers, createCrudRouter, createFastifyHandler, createPermissionMiddleware, createRequestContext, defineAction, defineAggregation, defineResource, defineResourceVariants, getControllerContext, getControllerScope, getEntityId, getEntityIdField, getEntityQuery, isFieldReadable, sendControllerResponse };