@classytic/arc 1.1.0 → 2.1.2

package/dist/ResourceRegistry-DsN4KJjV.mjs

@@ -0,0 +1,250 @@
+import { s as DEFAULT_UPDATE_METHOD, t as CRUD_OPERATIONS } from "./constants-DdXFXQtN.mjs";
+
+//#region src/registry/ResourceRegistry.ts
+var ResourceRegistry = class {
+	_resources;
+	_frozen;
+	constructor() {
+		this._resources = /* @__PURE__ */ new Map();
+		this._frozen = false;
+	}
+	/**
+	* Register a resource
+	*/
+	register(resource, options = {}) {
+		if (this._frozen) throw new Error(`Registry frozen. Cannot register '${resource.name}' after startup.`);
+		if (this._resources.has(resource.name)) throw new Error(`Resource '${resource.name}' already registered.`);
+		const entry = {
+			name: resource.name,
+			displayName: resource.displayName,
+			tag: resource.tag,
+			prefix: resource.prefix,
+			module: options.module ?? void 0,
+			adapter: resource.adapter ? {
+				type: resource.adapter.type,
+				name: resource.adapter.name
+			} : null,
+			permissions: resource.permissions,
+			presets: resource._appliedPresets ?? [],
+			routes: [],
+			additionalRoutes: resource.additionalRoutes.map((r) => ({
+				method: r.method,
+				path: r.path,
+				handler: typeof r.handler === "string" ? r.handler : r.handler.name || "anonymous",
+				operation: r.operation,
+				summary: r.summary,
+				description: r.description,
+				permissions: r.permissions,
+				wrapHandler: r.wrapHandler,
+				schema: r.schema
+			})),
+			events: Object.keys(resource.events ?? {}),
+			registeredAt: (/* @__PURE__ */ new Date()).toISOString(),
+			disableDefaultRoutes: resource.disableDefaultRoutes,
+			updateMethod: resource.updateMethod,
+			disabledRoutes: resource.disabledRoutes,
+			openApiSchemas: options.openApiSchemas,
+			fieldPermissions: extractFieldPermissions(resource.fields),
+			pipelineSteps: extractPipelineSteps(resource.pipe),
+			rateLimit: resource.rateLimit,
+			plugin: resource.toPlugin()
+		};
+		this._resources.set(resource.name, entry);
+		return this;
+	}
+	/**
+	* Get resource by name
+	*/
+	get(name) {
+		return this._resources.get(name);
+	}
+	/**
+	* Get all resources
+	*/
+	getAll() {
+		return Array.from(this._resources.values());
+	}
+	/**
+	* Get resources by module
+	*/
+	getByModule(moduleName) {
+		return this.getAll().filter((r) => r.module === moduleName);
+	}
+	/**
+	* Get resources by preset
+	*/
+	getByPreset(presetName) {
+		return this.getAll().filter((r) => r.presets.includes(presetName));
+	}
+	/**
+	* Check if resource exists
+	*/
+	has(name) {
+		return this._resources.has(name);
+	}
+	/**
+	* Get registry statistics
+	*/
+	getStats() {
+		const resources = this.getAll();
+		const presetCounts = {};
+		for (const r of resources) for (const preset of r.presets) presetCounts[preset] = (presetCounts[preset] ?? 0) + 1;
+		return {
+			totalResources: resources.length,
+			byModule: this._groupBy(resources, "module"),
+			presetUsage: presetCounts,
+			totalRoutes: resources.reduce((sum, r) => {
+				if (r.disableDefaultRoutes) return sum + (r.additionalRoutes?.length ?? 0);
+				const disabledSet = new Set(r.disabledRoutes ?? []);
+				let defaultCount = CRUD_OPERATIONS.filter((route) => !disabledSet.has(route)).length;
+				if (!disabledSet.has("update") && r.updateMethod === "both") defaultCount += 1;
+				return sum + defaultCount + (r.additionalRoutes?.length ?? 0);
+			}, 0),
+			totalEvents: resources.reduce((sum, r) => sum + (r.events?.length ?? 0), 0)
+		};
+	}
+	/**
+	* Get full introspection data
+	*/
+	getIntrospection() {
+		return {
+			resources: this.getAll().map((r) => {
+				const disabledSet = new Set(r.disabledRoutes ?? []);
+				const updateMethod = r.updateMethod ?? DEFAULT_UPDATE_METHOD;
+				const defaultRoutes = r.disableDefaultRoutes ? [] : [
+					...!disabledSet.has("list") ? [{
+						method: "GET",
+						path: r.prefix,
+						operation: "list"
+					}] : [],
+					...!disabledSet.has("get") ? [{
+						method: "GET",
+						path: `${r.prefix}/:id`,
+						operation: "get"
+					}] : [],
+					...!disabledSet.has("create") ? [{
+						method: "POST",
+						path: r.prefix,
+						operation: "create"
+					}] : [],
+					...!disabledSet.has("update") ? updateMethod === "both" ? [{
+						method: "PUT",
+						path: `${r.prefix}/:id`,
+						operation: "update"
+					}, {
+						method: "PATCH",
+						path: `${r.prefix}/:id`,
+						operation: "update"
+					}] : [{
+						method: updateMethod,
+						path: `${r.prefix}/:id`,
+						operation: "update"
+					}] : [],
+					...!disabledSet.has("delete") ? [{
+						method: "DELETE",
+						path: `${r.prefix}/:id`,
+						operation: "delete"
+					}] : []
+				];
+				return {
+					name: r.name,
+					displayName: r.displayName,
+					prefix: r.prefix,
+					module: r.module,
+					presets: r.presets,
+					permissions: r.permissions,
+					routes: [...defaultRoutes, ...r.additionalRoutes?.map((ar) => ({
+						method: ar.method,
+						path: `${r.prefix}${ar.path}`,
+						operation: ar.operation ?? (typeof ar.handler === "string" ? ar.handler : "custom"),
+						handler: typeof ar.handler === "string" ? ar.handler : void 0,
+						summary: ar.summary
+					})) ?? []],
+					events: r.events
+				};
+			}),
+			stats: this.getStats(),
+			generatedAt: (/* @__PURE__ */ new Date()).toISOString()
+		};
+	}
+	/**
+	* Freeze registry (prevent further registrations)
+	*/
+	freeze() {
+		this._frozen = true;
+	}
+	/**
+	* Check if frozen
+	*/
+	isFrozen() {
+		return this._frozen;
+	}
+	/**
+	* Unfreeze registry (allow new registrations)
+	*/
+	unfreeze() {
+		this._frozen = false;
+	}
+	/**
+	* Reset registry — clear all resources and unfreeze
+	*/
+	reset() {
+		this._resources.clear();
+		this._frozen = false;
+	}
+	/** @internal Alias for unfreeze() */
+	_unfreeze() {
+		this.unfreeze();
+	}
+	/** @internal Alias for reset() */
+	_clear() {
+		this.reset();
+	}
+	/**
+	* Group by key
+	*/
+	_groupBy(arr, key) {
+		const result = {};
+		for (const item of arr) {
+			const k = String(item[key] ?? "uncategorized");
+			result[k] = (result[k] ?? 0) + 1;
+		}
+		return result;
+	}
+};
+function extractFieldPermissions(fields) {
+	if (!fields || Object.keys(fields).length === 0) return void 0;
+	const result = {};
+	for (const [field, perm] of Object.entries(fields)) {
+		const entry = { type: perm._type };
+		if (perm.roles?.length) entry.roles = perm.roles;
+		if (perm.redactValue !== void 0) entry.redactValue = perm.redactValue;
+		result[field] = entry;
+	}
+	return result;
+}
+function extractPipelineSteps(pipe) {
+	if (!pipe) return void 0;
+	const steps = [];
+	if (Array.isArray(pipe)) steps.push(...pipe);
+	else {
+		const seen = /* @__PURE__ */ new Set();
+		for (const opSteps of Object.values(pipe)) if (Array.isArray(opSteps)) for (const step of opSteps) {
+			const key = `${step._type}:${step.name}`;
+			if (!seen.has(key)) {
+				seen.add(key);
+				steps.push(step);
+			}
+		}
+	}
+	if (steps.length === 0) return void 0;
+	return steps.map((s) => ({
+		type: s._type,
+		name: s.name,
+		operations: s.operations ? [...s.operations] : void 0
+	}));
+}
+
+//#endregion
+export { ResourceRegistry as t };
+//# sourceMappingURL=ResourceRegistry-DsN4KJjV.mjs.map

package/dist/ResourceRegistry-DsN4KJjV.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceRegistry-DsN4KJjV.mjs","names":[],"sources":["../src/registry/ResourceRegistry.ts"],"sourcesContent":["/**\n * Resource Registry\n *\n * Singleton that tracks all registered resources for introspection.\n */\n\nimport type {\n  IntrospectionData,\n  OpenApiSchemas,\n  RegistryEntry,\n  RegistryStats,\n  ResourcePermissions,\n} from '../types/index.js';\nimport type { ResourceDefinition } from '../core/defineResource.js';\nimport type { FieldPermissionMap } from '../permissions/fields.js';\nimport type { PipelineConfig, PipelineStep } from '../pipeline/types.js';\nimport { CRUD_OPERATIONS, DEFAULT_UPDATE_METHOD } from '../constants.js';\n\nexport interface RegisterOptions {\n  module?: string;\n  /** Pre-generated OpenAPI schemas */\n  openApiSchemas?: OpenApiSchemas;\n}\n\nexport class ResourceRegistry {\n  private _resources: Map<string, RegistryEntry>;\n  private _frozen: boolean;\n\n  constructor() {\n    this._resources = new Map();\n    this._frozen = false;\n  }\n\n  /**\n   * Register a resource\n   */\n  register(resource: ResourceDefinition<unknown>, options: RegisterOptions = {}): this {\n    if (this._frozen) {\n      throw new Error(\n        `Registry frozen. Cannot register '${resource.name}' after startup.`\n      );\n    }\n\n    if (this._resources.has(resource.name)) {\n      throw new Error(`Resource '${resource.name}' already registered.`);\n    }\n\n    const entry: RegistryEntry = {\n      name: resource.name,\n      displayName: resource.displayName,\n      tag: resource.tag,\n      prefix: resource.prefix,\n      module: options.module ?? undefined,\n      adapter: resource.adapter\n        ? {\n            type: resource.adapter.type,\n            name: resource.adapter.name,\n          }\n        : null,\n      permissions: resource.permissions as ResourcePermissions | undefined,\n      presets: resource._appliedPresets ?? [],\n      routes: [], // Populated later by getIntrospection()\n      additionalRoutes: resource.additionalRoutes.map((r) => ({\n        method: r.method,\n        path: r.path,\n        handler:\n          typeof r.handler === 'string'\n            ? r.handler\n            : (r.handler as Function).name || 'anonymous',\n        operation: r.operation,\n        summary: r.summary,\n        description: r.description,\n        permissions: r.permissions,\n        wrapHandler: r.wrapHandler,\n        schema: r.schema, // Include schema for OpenAPI docs\n      })),\n      events: Object.keys(resource.events ?? {}),\n      registeredAt: new Date().toISOString(),\n      disableDefaultRoutes: resource.disableDefaultRoutes,\n      updateMethod: resource.updateMethod,\n      disabledRoutes: resource.disabledRoutes,\n      openApiSchemas: options.openApiSchemas,\n      fieldPermissions: extractFieldPermissions(resource.fields),\n      pipelineSteps: extractPipelineSteps(resource.pipe),\n      rateLimit: resource.rateLimit,\n      plugin: resource.toPlugin(), // Store plugin factory\n    };\n\n    this._resources.set(resource.name, entry);\n    return this;\n  }\n\n  /**\n   * Get resource by name\n   */\n  get(name: string): RegistryEntry | undefined {\n    return this._resources.get(name);\n  }\n\n  /**\n   * Get all resources\n   */\n  getAll(): RegistryEntry[] {\n    return Array.from(this._resources.values());\n  }\n\n  /**\n   * Get resources by module\n   */\n  getByModule(moduleName: string): RegistryEntry[] {\n    return this.getAll().filter((r) => r.module === moduleName);\n  }\n\n  /**\n   * Get resources by preset\n   */\n  getByPreset(presetName: string): RegistryEntry[] {\n    return this.getAll().filter((r) => r.presets.includes(presetName));\n  }\n\n  /**\n   * Check if resource exists\n   */\n  has(name: string): boolean {\n    return this._resources.has(name);\n  }\n\n  /**\n   * Get registry statistics\n   */\n  getStats(): RegistryStats {\n    const resources = this.getAll();\n    const presetCounts: Record<string, number> = {};\n\n    for (const r of resources) {\n      for (const preset of r.presets) {\n        presetCounts[preset] = (presetCounts[preset] ?? 0) + 1;\n      }\n    }\n\n    return {\n      totalResources: resources.length,\n      byModule: this._groupBy(resources, 'module'),\n      presetUsage: presetCounts,\n      totalRoutes: resources.reduce((sum, r) => {\n        if (r.disableDefaultRoutes) {\n          return sum + (r.additionalRoutes?.length ?? 0);\n        }\n        const disabledSet = new Set(r.disabledRoutes ?? []);\n        let defaultCount = CRUD_OPERATIONS.filter(route => !disabledSet.has(route)).length;\n        // 'update' creates 2 routes when updateMethod is 'both' (PUT + PATCH)\n        if (!disabledSet.has('update') && r.updateMethod === 'both') {\n          defaultCount += 1;\n        }\n        return sum + defaultCount + (r.additionalRoutes?.length ?? 0);\n      }, 0),\n      totalEvents: resources.reduce((sum, r) => sum + (r.events?.length ?? 0), 0),\n    };\n  }\n\n  /**\n   * Get full introspection data\n   */\n  getIntrospection(): IntrospectionData {\n    return {\n      resources: this.getAll().map((r) => {\n        // Build default routes accounting for disabledRoutes and updateMethod\n        const disabledSet = new Set(r.disabledRoutes ?? []);\n        const updateMethod = r.updateMethod ?? DEFAULT_UPDATE_METHOD;\n        const defaultRoutes = r.disableDefaultRoutes ? [] : [\n          ...(!disabledSet.has('list') ? [{ method: 'GET', path: r.prefix, operation: 'list' }] : []),\n          ...(!disabledSet.has('get') ? [{ method: 'GET', path: `${r.prefix}/:id`, operation: 'get' }] : []),\n          ...(!disabledSet.has('create') ? [{ method: 'POST', path: r.prefix, operation: 'create' }] : []),\n          ...(!disabledSet.has('update') ? (\n            updateMethod === 'both'\n              ? [\n                  { method: 'PUT', path: `${r.prefix}/:id`, operation: 'update' },\n                  { method: 'PATCH', path: `${r.prefix}/:id`, operation: 'update' },\n                ]\n              : [{ method: updateMethod, path: `${r.prefix}/:id`, operation: 'update' }]\n          ) : []),\n          ...(!disabledSet.has('delete') ? [{ method: 'DELETE', path: `${r.prefix}/:id`, operation: 'delete' }] : []),\n        ];\n\n        return {\n          name: r.name,\n          displayName: r.displayName,\n          prefix: r.prefix,\n          module: r.module,\n          presets: r.presets,\n          permissions: r.permissions,\n          routes: [\n            ...defaultRoutes,\n            ...(r.additionalRoutes?.map((ar) => ({\n              method: ar.method,\n              path: `${r.prefix}${ar.path}`,\n              operation: ar.operation ?? (typeof ar.handler === 'string' ? ar.handler : 'custom'),\n              handler: typeof ar.handler === 'string' ? ar.handler : undefined,\n              summary: ar.summary,\n            })) ?? []),\n          ],\n          events: r.events,\n        };\n      }),\n      stats: this.getStats(),\n      generatedAt: new Date().toISOString(),\n    };\n  }\n\n  /**\n   * Freeze registry (prevent further registrations)\n   */\n  freeze(): void {\n    this._frozen = true;\n  }\n\n  /**\n   * Check if frozen\n   */\n  isFrozen(): boolean {\n    return this._frozen;\n  }\n\n  /**\n   * Unfreeze registry (allow new registrations)\n   */\n  unfreeze(): void {\n    this._frozen = false;\n  }\n\n  /**\n   * Reset registry — clear all resources and unfreeze\n   */\n  reset(): void {\n    this._resources.clear();\n    this._frozen = false;\n  }\n\n  /** @internal Alias for unfreeze() */\n  _unfreeze(): void {\n    this.unfreeze();\n  }\n\n  /** @internal Alias for reset() */\n  _clear(): void {\n    this.reset();\n  }\n\n  /**\n   * Group by key\n   */\n  private _groupBy(\n    arr: RegistryEntry[],\n    key: keyof RegistryEntry\n  ): Record<string, number> {\n    const result: Record<string, number> = {};\n    for (const item of arr) {\n      const k = String(item[key] ?? 'uncategorized');\n      result[k] = (result[k] ?? 0) + 1;\n    }\n    return result;\n  }\n}\n\nexport default ResourceRegistry;\n\n// ---------------------------------------------------------------------------\n// Helpers for extracting v2.0 metadata\n// ---------------------------------------------------------------------------\n\nfunction extractFieldPermissions(\n  fields?: FieldPermissionMap,\n): RegistryEntry['fieldPermissions'] {\n  if (!fields || Object.keys(fields).length === 0) return undefined;\n\n  const result: NonNullable<RegistryEntry['fieldPermissions']> = {};\n  for (const [field, perm] of Object.entries(fields)) {\n    const entry: { type: string; roles?: readonly string[]; redactValue?: unknown } = {\n      type: perm._type,\n    };\n    if (perm.roles?.length) entry.roles = perm.roles;\n    if (perm.redactValue !== undefined) entry.redactValue = perm.redactValue;\n    result[field] = entry;\n  }\n  return result;\n}\n\nfunction extractPipelineSteps(\n  pipe?: PipelineConfig,\n): RegistryEntry['pipelineSteps'] {\n  if (!pipe) return undefined;\n\n  const steps: PipelineStep[] = [];\n  if (Array.isArray(pipe)) {\n    steps.push(...pipe);\n  } else {\n    const seen = new Set<string>();\n    for (const opSteps of Object.values(pipe)) {\n      if (Array.isArray(opSteps)) {\n        for (const step of opSteps) {\n          const key = `${step._type}:${step.name}`;\n          if (!seen.has(key)) {\n            seen.add(key);\n            steps.push(step);\n          }\n        }\n      }\n    }\n  }\n\n  if (steps.length === 0) return undefined;\n\n  return steps.map((s) => ({\n    type: s._type,\n    name: s.name,\n    operations: s.operations ? [...s.operations] : undefined,\n  }));\n}\n"],"mappings":"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"}

package/dist/adapters/index.d.mts

@@ -0,0 +1,5 @@
+import "../elevation-B_2dRLVP.mjs";
+import { a as RepositoryLike, i as RelationMetadata, n as DataAdapter, o as SchemaMetadata, r as FieldMetadata, s as ValidationResult, t as AdapterFactory } from "../interface-Ch8HU9uM.mjs";
+import "../types-aYB4V7uN.mjs";
+import { a as PrismaQueryParserOptions, c as MongooseAdapterOptions, i as PrismaQueryParser, l as createMongooseAdapter, n as PrismaAdapterOptions, o as createPrismaAdapter, r as PrismaQueryOptions, s as MongooseAdapter, t as PrismaAdapter } from "../prisma-Dg9GoVdj.mjs";
+export { type AdapterFactory, type DataAdapter, type FieldMetadata, MongooseAdapter, type MongooseAdapterOptions, PrismaAdapter, type PrismaAdapterOptions, type PrismaQueryOptions, PrismaQueryParser, type PrismaQueryParserOptions, type RelationMetadata, type RepositoryLike, type SchemaMetadata, type ValidationResult, createMongooseAdapter, createPrismaAdapter };

package/dist/adapters/index.mjs

@@ -0,0 +1,3 @@
+import { a as createMongooseAdapter, i as MongooseAdapter, n as PrismaQueryParser, r as createPrismaAdapter, t as PrismaAdapter } from "../prisma-DJbMt3yf.mjs";
+
+export { MongooseAdapter, PrismaAdapter, PrismaQueryParser, createMongooseAdapter, createPrismaAdapter };

package/dist/audit/index.d.mts

@@ -0,0 +1,82 @@
+import "../elevation-B_2dRLVP.mjs";
+import "../interface-Ch8HU9uM.mjs";
+import "../types-aYB4V7uN.mjs";
+import { a as AuditContext, c as AuditStore, i as AuditAction, l as AuditStoreOptions, n as MongoAuditStoreOptions, o as AuditEntry, r as MongoConnection, s as AuditQueryOptions, u as createAuditEntry } from "../mongodb-CGzRbfAK.mjs";
+import { FastifyPluginAsync } from "fastify";
+
+//#region src/audit/auditPlugin.d.ts
+interface AuditPluginOptions {
+  /** Enable audit logging (default: false) */
+  enabled?: boolean;
+  /** Storage backends to use */
+  stores?: ('memory' | 'mongodb')[];
+  /** MongoDB connection (required if using mongodb store) */
+  mongoConnection?: MongoConnection;
+  /** MongoDB collection name (default: 'audit_logs') */
+  mongoCollection?: string;
+  /** TTL in days for MongoDB (default: 90) */
+  ttlDays?: number;
+  /** Custom stores (advanced) */
+  customStores?: AuditStore[];
+  /**
+   * Automatically audit CRUD operations via the hook system (default: true when enabled).
+   * When enabled, create/update/delete operations are auto-logged without manual calls.
+   *
+   * - `true`: Auto-audit all CRUD operations on all resources
+   * - `{ operations: ['create', 'delete'] }`: Only auto-audit specific operations
+   * - `{ exclude: ['health', 'metrics'] }`: Skip specific resources
+   * - `false`: Disable auto-audit (manual calls only)
+   */
+  autoAudit?: boolean | {
+    operations?: ('create' | 'update' | 'delete')[];
+    exclude?: string[];
+  };
+}
+declare module 'fastify' {
+  interface FastifyInstance {
+    /** Log an audit entry */
+    audit: AuditLogger;
+  }
+  interface FastifyRequest {
+    /** Audit context for current request */
+    auditContext?: AuditContext;
+  }
+}
+interface AuditLogger {
+  /** Log a create action */
+  create: (resource: string, documentId: string, data: Record<string, unknown>, context?: AuditContext) => Promise<void>;
+  /** Log an update action */
+  update: (resource: string, documentId: string, before: Record<string, unknown>, after: Record<string, unknown>, context?: AuditContext) => Promise<void>;
+  /** Log a delete action */
+  delete: (resource: string, documentId: string, data: Record<string, unknown>, context?: AuditContext) => Promise<void>;
+  /** Log a restore action (soft delete undo) */
+  restore: (resource: string, documentId: string, data: Record<string, unknown>, context?: AuditContext) => Promise<void>;
+  /** Log a custom action */
+  custom: (resource: string, documentId: string, action: string, data?: Record<string, unknown>, context?: AuditContext) => Promise<void>;
+  /** Query audit logs (if stores support it) */
+  query: (options: AuditQueryOptions) => Promise<AuditEntry[]>;
+}
+declare const auditPlugin: FastifyPluginAsync<AuditPluginOptions>;
+declare const _default: FastifyPluginAsync<AuditPluginOptions>;
+//#endregion
+//#region src/audit/stores/memory.d.ts
+interface MemoryAuditStoreOptions {
+  /** Maximum entries to keep (default: 1000) */
+  maxEntries?: number;
+}
+declare class MemoryAuditStore implements AuditStore {
+  readonly name = "memory";
+  private entries;
+  private maxEntries;
+  constructor(options?: MemoryAuditStoreOptions);
+  log(entry: AuditEntry): Promise<void>;
+  query(options?: AuditQueryOptions): Promise<AuditEntry[]>;
+  close(): Promise<void>;
+  /** Get all entries (for testing) */
+  getAll(): AuditEntry[];
+  /** Clear all entries (for testing) */
+  clear(): void;
+}
+//#endregion
+export { type AuditAction, type AuditContext, type AuditEntry, type AuditLogger, type AuditPluginOptions, type AuditQueryOptions, type AuditStore, type AuditStoreOptions, MemoryAuditStore, type MemoryAuditStoreOptions, type MongoAuditStoreOptions, _default as auditPlugin, auditPlugin as auditPluginFn, createAuditEntry };
+//# sourceMappingURL=index.d.mts.map

package/dist/audit/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/audit/auditPlugin.ts","../../src/audit/stores/memory.ts"],"mappings":";;;;;;;UAgCiB,kBAAA;EAoCc;EAlC7B,OAAA;EA6BE;EA3BF,MAAA;EA8BU;EA5BV,eAAA,GAAkB,eAAA;EA8BD;EA5BjB,eAAA;EA4B6B;EA1B7B,OAAA;EA8Be;EA5Bf,YAAA,GAAe,UAAA;;;;;;;;;;EAUf,SAAA;IACE,UAAA;IACA,OAAA;EAAA;AAAA;AAAA;EAAA,UAKQ,eAAA;IAoDL;IAlDH,KAAA,EAAO,WAAA;EAAA;EAAA,UAGC,cAAA;IAkDoE;IAhD5E,YAAA,GAAe,YAAA;EAAA;AAAA;AAAA,UAIF,WAAA;EAKP;EAHR,MAAA,GACE,QAAA,UACA,UAAA,UACA,IAAA,EAAM,MAAA,mBACN,OAAA,GAAU,YAAA,KACP,OAAA;EADO;EAIZ,MAAA,GACE,QAAA,UACA,UAAA,UACA,MAAA,EAAQ,MAAA,mBACR,KAAA,EAAO,MAAA,mBACP,OAAA,GAAU,YAAA,KACP,OAAA;EATA;EAYL,MAAA,GACE,QAAA,UACA,UAAA,UACA,IAAA,EAAM,MAAA,mBACN,OAAA,GAAU,YAAA,KACP,OAAA;EAbH;EAgBF,OAAA,GACE,QAAA,UACA,UAAA,UACA,IAAA,EAAM,MAAA,mBACN,OAAA,GAAU,YAAA,KACP,OAAA;EAnBK;EAsBV,MAAA,GACE,QAAA,UACA,UAAA,UACA,MAAA,UACA,IAAA,GAAO,MAAA,mBACP,OAAA,GAAU,YAAA,KACP,OAAA;EA3BI;EA8BT,KAAA,GAAQ,OAAA,EAHI,iBAAA,KAG2D,OAAA,CAAQ,UAAA;AAAA;AAAA,cAG3E,WAAA,EAAa,kBAAA,CAAmB,kBAAA;AAAA,cAAkB,QAAA;;;UC9GvC,uBAAA;EDuBkB;ECrBjC,UAAA;AAAA;AAAA,cAGW,gBAAA,YAA4B,UAAA;EAAA,SAC9B,IAAA;EAAA,QACD,OAAA;EAAA,QACA,UAAA;cAEI,OAAA,GAAS,uBAAA;EAIf,GAAA,CAAI,KAAA,EAAO,UAAA,GAAa,OAAA;EASxB,KAAA,CAAM,OAAA,GAAS,iBAAA,GAAyB,OAAA,CAAQ,UAAA;EAwChD,KAAA,CAAA,GAAS,OAAA;EDlBf;ECuBA,MAAA,CAAA,GAAU,UAAA;EDrBR;EC0BF,KAAA,CAAA;AAAA"}

package/dist/audit/index.mjs

@@ -0,0 +1,276 @@
+import { t as MongoAuditStore } from "../mongodb-BfJVlUJH.mjs";
+import fp from "fastify-plugin";
+
+//#region src/audit/stores/interface.ts
+/**
+* Create audit entry from context
+*/
+function createAuditEntry(resource, documentId, action, context, data) {
+	const changes = data?.before && data?.after ? detectChanges(data.before, data.after) : void 0;
+	return {
+		id: generateAuditId(),
+		resource,
+		documentId,
+		action,
+		userId: context.user?._id?.toString() ?? context.user?.id,
+		organizationId: context.organizationId,
+		before: data?.before,
+		after: data?.after,
+		changes,
+		requestId: context.requestId,
+		ipAddress: context.ipAddress,
+		userAgent: context.userAgent,
+		metadata: data?.metadata,
+		timestamp: /* @__PURE__ */ new Date()
+	};
+}
+/**
+* Detect changed fields between two objects
+*/
+function detectChanges(before, after) {
+	const changes = [];
+	const allKeys = new Set([...Object.keys(before), ...Object.keys(after)]);
+	for (const key of allKeys) {
+		if (key.startsWith("_") || key === "updatedAt") continue;
+		if (JSON.stringify(before[key]) !== JSON.stringify(after[key])) changes.push(key);
+	}
+	return changes;
+}
+/**
+* Generate unique audit ID
+*/
+function generateAuditId() {
+	return `aud_${Date.now().toString(36)}${Math.random().toString(36).substring(2, 10)}`;
+}
+
+//#endregion
+//#region src/audit/stores/memory.ts
+var MemoryAuditStore = class {
+	name = "memory";
+	entries = [];
+	maxEntries;
+	constructor(options = {}) {
+		this.maxEntries = options.maxEntries ?? 1e3;
+	}
+	async log(entry) {
+		this.entries.unshift(entry);
+		if (this.entries.length > this.maxEntries) this.entries = this.entries.slice(0, this.maxEntries);
+	}
+	async query(options = {}) {
+		let results = [...this.entries];
+		if (options.resource) results = results.filter((e) => e.resource === options.resource);
+		if (options.documentId) results = results.filter((e) => e.documentId === options.documentId);
+		if (options.userId) results = results.filter((e) => e.userId === options.userId);
+		if (options.organizationId) results = results.filter((e) => e.organizationId === options.organizationId);
+		if (options.action) {
+			const actions = Array.isArray(options.action) ? options.action : [options.action];
+			results = results.filter((e) => actions.includes(e.action));
+		}
+		if (options.from) results = results.filter((e) => e.timestamp >= options.from);
+		if (options.to) results = results.filter((e) => e.timestamp <= options.to);
+		const offset = options.offset ?? 0;
+		const limit = options.limit ?? 100;
+		results = results.slice(offset, offset + limit);
+		return results;
+	}
+	async close() {
+		this.entries = [];
+	}
+	/** Get all entries (for testing) */
+	getAll() {
+		return [...this.entries];
+	}
+	/** Clear all entries (for testing) */
+	clear() {
+		this.entries = [];
+	}
+};
+
+//#endregion
+//#region src/audit/auditPlugin.ts
+/**
+* Audit Plugin
+*
+* Optional audit trail with flexible storage options.
+* Disabled by default - enable explicitly for enterprise use cases.
+*
+* @example
+* import { auditPlugin } from '@classytic/arc/audit';
+*
+* // Development: in-memory
+* await fastify.register(auditPlugin, {
+*   enabled: true,
+*   stores: ['memory'],
+* });
+*
+* // Production: MongoDB with TTL
+* await fastify.register(auditPlugin, {
+*   enabled: true,
+*   stores: ['mongodb'],
+*   mongoConnection: mongoose.connection,
+*   ttlDays: 90,
+* });
+*/
+const auditPlugin = async (fastify, opts = {}) => {
+	const { enabled = false, stores: storeTypes = ["memory"], mongoConnection, mongoCollection = "audit_logs", ttlDays = 90, customStores = [] } = opts;
+	if (!enabled) {
+		fastify.decorate("audit", createNoopLogger());
+		fastify.decorateRequest("auditContext", void 0);
+		fastify.log?.debug?.("Audit plugin disabled");
+		return;
+	}
+	const stores = [...customStores];
+	for (const type of storeTypes) switch (type) {
+		case "memory":
+			stores.push(new MemoryAuditStore());
+			break;
+		case "mongodb":
+			if (!mongoConnection) throw new Error("Audit: mongoConnection required for mongodb store");
+			stores.push(new MongoAuditStore({
+				connection: mongoConnection,
+				collection: mongoCollection,
+				ttlDays
+			}));
+			break;
+	}
+	if (stores.length === 0) throw new Error("Audit: at least one store must be configured");
+	async function logToStores(entry) {
+		await Promise.all(stores.map((store) => store.log(entry)));
+	}
+	const audit = {
+		async create(resource, documentId, data, context) {
+			await logToStores(createAuditEntry(resource, documentId, "create", context ?? {}, { after: data }));
+		},
+		async update(resource, documentId, before, after, context) {
+			await logToStores(createAuditEntry(resource, documentId, "update", context ?? {}, {
+				before,
+				after
+			}));
+		},
+		async delete(resource, documentId, data, context) {
+			await logToStores(createAuditEntry(resource, documentId, "delete", context ?? {}, { before: data }));
+		},
+		async restore(resource, documentId, data, context) {
+			await logToStores(createAuditEntry(resource, documentId, "restore", context ?? {}, { after: data }));
+		},
+		async custom(resource, documentId, action, data, context) {
+			await logToStores(createAuditEntry(resource, documentId, "custom", context ?? {}, { metadata: {
+				customAction: action,
+				...data
+			} }));
+		},
+		async query(options) {
+			for (const store of stores) if (store.query) return store.query(options);
+			return [];
+		}
+	};
+	fastify.decorate("audit", audit);
+	fastify.decorateRequest("auditContext", void 0);
+	fastify.addHook("onRequest", async (request) => {
+		const user = request.user;
+		request.context;
+		const scope = request.scope;
+		request.auditContext = {
+			user,
+			organizationId: scope?.kind === "member" ? scope.organizationId : scope?.kind === "elevated" ? scope.organizationId : void 0,
+			requestId: request.id,
+			ipAddress: request.ip,
+			userAgent: request.headers["user-agent"],
+			endpoint: void 0,
+			duration: void 0
+		};
+	});
+	fastify.addHook("onResponse", async (request, reply) => {
+		if (request.auditContext) {
+			request.auditContext.endpoint = `${request.method} ${request.routeOptions?.url ?? request.url}`;
+			request.auditContext.duration = Math.round(reply.elapsedTime);
+		}
+	});
+	fastify.addHook("onClose", async () => {
+		await Promise.all(stores.map((store) => store.close?.()));
+	});
+	const autoAuditConfig = opts.autoAudit ?? true;
+	if (autoAuditConfig !== false) {
+		const defaultOps = [
+			"create",
+			"update",
+			"delete"
+		];
+		const ops = typeof autoAuditConfig === "object" ? autoAuditConfig.operations ?? defaultOps : defaultOps;
+		const excludeResources = new Set(typeof autoAuditConfig === "object" ? autoAuditConfig.exclude ?? [] : []);
+		fastify.addHook("onReady", async () => {
+			const arc = "arc" in fastify ? fastify.arc : void 0;
+			if (!arc?.hooks) {
+				fastify.log?.debug?.("Auto-audit skipped: arc-core plugin not registered");
+				return;
+			}
+			for (const op of ops) arc.hooks.after("*", op, async (ctx) => {
+				if (excludeResources.has(ctx.resource)) return;
+				const docId = autoAuditExtractId(ctx.result);
+				const scope = ctx.context?._scope;
+				const auditCtx = {
+					user: ctx.user,
+					organizationId: scope ? autoAuditGetOrgId(scope) : void 0
+				};
+				try {
+					if (op === "create") await audit.create(ctx.resource, docId, autoAuditToPlain(ctx.result), auditCtx);
+					else if (op === "update") await audit.update(ctx.resource, docId, autoAuditToPlain(ctx.meta?.existing), autoAuditToPlain(ctx.result), auditCtx);
+					else if (op === "delete") await audit.delete(ctx.resource, docId, autoAuditToPlain(ctx.result), auditCtx);
+				} catch (err) {
+					fastify.log?.warn?.({
+						resource: ctx.resource,
+						op,
+						err
+					}, "Auto-audit failed");
+				}
+			}, 90);
+			fastify.log?.debug?.({
+				ops,
+				exclude: [...excludeResources]
+			}, "Auto-audit hooks registered");
+		});
+	}
+	fastify.log?.debug?.({ stores: storeTypes }, "Audit plugin enabled");
+};
+/** Extract document ID from a result */
+function autoAuditExtractId(doc) {
+	if (!doc || typeof doc !== "object") return "";
+	const d = doc;
+	const rawId = d._id ?? d.id;
+	return rawId != null ? String(rawId) : "";
+}
+/** Convert Mongoose doc or plain object to plain object */
+function autoAuditToPlain(doc) {
+	if (!doc || typeof doc !== "object") return {};
+	if (typeof doc.toObject === "function") return doc.toObject();
+	return doc;
+}
+/** Extract org ID from scope (avoids importing scope module to prevent circular deps) */
+function autoAuditGetOrgId(scope) {
+	if (!scope || typeof scope !== "object") return void 0;
+	const s = scope;
+	if (s.kind === "member" || s.kind === "elevated") return s.organizationId;
+}
+/**
+* Create no-op logger for when audit is disabled
+*/
+function createNoopLogger() {
+	const noop = async () => {};
+	return {
+		create: noop,
+		update: noop,
+		delete: noop,
+		restore: noop,
+		custom: noop,
+		query: async () => []
+	};
+}
+var auditPlugin_default = fp(auditPlugin, {
+	name: "arc-audit",
+	fastify: "5.x",
+	dependencies: ["arc-core"]
+});
+
+//#endregion
+export { MemoryAuditStore, auditPlugin_default as auditPlugin, auditPlugin as auditPluginFn, createAuditEntry };
+//# sourceMappingURL=index.mjs.map