@classytic/arc 2.9.1 → 2.10.8

package/dist/{versioning-Cm8qoFDg.mjs → versioning-B6mimogM.mjs}

@@ -10,7 +10,7 @@ const versioningPlugin = async (fastify, opts) => {
 	const { type, defaultVersion = "1", headerName = "accept-version", responseHeader = "x-api-version", deprecated = [], sunset } = opts;
 	const deprecatedSet = new Set(deprecated);
 	fastify.decorateRequest("apiVersion", defaultVersion);
-	fastify.addHook("onRequest", async (request) => {
+	fastify.addHook("onRequest", async (request, reply) => {
 		let version = defaultVersion;
 		if (type === "header") {
 			const headerValue = request.headers[headerName];
@@ -20,10 +20,8 @@ const versioningPlugin = async (fastify, opts) => {
 			if (match) version = match[1] ?? defaultVersion;
 		}
 		request.apiVersion = version;
-	});
-	fastify.addHook("onSend", async (request, reply) => {
-		reply.header(responseHeader, request.apiVersion);
-		if (deprecatedSet.has(request.apiVersion)) {
+		reply.header(responseHeader, version);
+		if (deprecatedSet.has(version)) {
 			reply.header("deprecation", "true");
 			reply.header("sunset", sunset ?? new Date(Date.now() + 2160 * 60 * 60 * 1e3).toISOString());
 		}

package/dist/versioning-CeUXHfjw.d.mts

@@ -0,0 +1,117 @@
+import { n as DomainEvent } from "./EventTransport-CfVEGaEl.mjs";
+import { FastifyPluginAsync, FastifyRequest } from "fastify";
+
+//#region src/plugins/caching.d.ts
+interface CachingRule {
+  /** Path prefix to match (e.g., '/api/products') */
+  match: string;
+  /** Cache-Control max-age in seconds */
+  maxAge: number;
+  /** Cache-Control: private vs public (default: public) */
+  private?: boolean;
+  /** stale-while-revalidate directive in seconds */
+  staleWhileRevalidate?: number;
+}
+interface CachingOptions {
+  /** Default max-age in seconds for Cache-Control (default: 0 = no-cache) */
+  maxAge?: number;
+  /** Enable ETag generation (default: true) */
+  etag?: boolean;
+  /** Enable conditional requests — 304 Not Modified (default: true) */
+  conditional?: boolean;
+  /** HTTP methods to cache (default: ['GET', 'HEAD']) */
+  methods?: string[];
+  /** Paths to exclude from caching (prefix match) */
+  exclude?: string[];
+  /** Custom cache rules per path prefix */
+  rules?: CachingRule[];
+}
+declare const cachingPlugin: FastifyPluginAsync<CachingOptions>;
+declare const _default$3: FastifyPluginAsync<CachingOptions>;
+//#endregion
+//#region src/plugins/sse.d.ts
+interface SSEOptions {
+  /** SSE endpoint path (default: '/events/stream') */
+  path?: string;
+  /** Require authentication (default: true) */
+  requireAuth?: boolean;
+  /** Event patterns to stream (default: ['*'] = all) */
+  patterns?: string[];
+  /** Heartbeat interval in ms (default: 30000) */
+  heartbeat?: number;
+  /** Filter events by organizationId from request.scope (default: false) */
+  orgScoped?: boolean;
+  /** Custom event filter function */
+  filter?: (event: DomainEvent<unknown>, request: FastifyRequest) => boolean;
+}
+declare const ssePlugin: FastifyPluginAsync<SSEOptions>;
+declare const _default$2: FastifyPluginAsync<SSEOptions>;
+//#endregion
+//#region src/plugins/metrics.d.ts
+interface MetricsOptions {
+  /** Endpoint path (default: '/_metrics') */
+  path?: string;
+  /** Prefix for all metric names (default: 'arc') */
+  prefix?: string;
+  /** Called after metrics are collected (for OTLP push, etc.) */
+  onCollect?: (metrics: MetricEntry[]) => void;
+}
+interface MetricEntry {
+  name: string;
+  type: "counter" | "histogram" | "gauge";
+  help: string;
+  values: Array<{
+    labels: Record<string, string>;
+    value: number;
+  }>;
+}
+interface MetricsCollector {
+  /** Get all metrics as structured data */
+  collect(): MetricEntry[];
+  /** Reset all metrics */
+  reset(): void;
+  /** Record a CRUD operation */
+  recordOperation(resource: string, operation: string, status: number, durationMs: number): void;
+  /** Record a cache hit */
+  recordCacheHit(resource: string): void;
+  /** Record a cache miss */
+  recordCacheMiss(resource: string): void;
+  /** Record an event publish */
+  recordEventPublish(eventType: string): void;
+  /** Record an event consume */
+  recordEventConsume(eventType: string): void;
+  /** Record a circuit breaker state change */
+  recordCircuitBreakerState(service: string, state: string): void;
+}
+declare module "fastify" {
+  interface FastifyInstance {
+    metrics: MetricsCollector;
+  }
+}
+declare const metricsPlugin: FastifyPluginAsync<MetricsOptions>;
+declare const _default$1: FastifyPluginAsync<MetricsOptions>;
+//#endregion
+//#region src/plugins/versioning.d.ts
+interface VersioningOptions {
+  /** Versioning strategy */
+  type: "header" | "prefix";
+  /** Default version when none specified (default: '1') */
+  defaultVersion?: string;
+  /** Header name to read (default: 'accept-version') */
+  headerName?: string;
+  /** Response header name (default: 'x-api-version') */
+  responseHeader?: string;
+  /** Deprecated versions — adds Deprecation + Sunset headers */
+  deprecated?: string[];
+  /** Sunset date for deprecated versions (ISO 8601) */
+  sunset?: string;
+}
+declare module "fastify" {
+  interface FastifyRequest {
+    apiVersion: string;
+  }
+}
+declare const versioningPlugin: FastifyPluginAsync<VersioningOptions>;
+declare const _default: FastifyPluginAsync<VersioningOptions>;
+//#endregion
+export { MetricsCollector as a, metricsPlugin as c, ssePlugin as d, CachingOptions as f, cachingPlugin as h, MetricEntry as i, SSEOptions as l, _default$3 as m, _default as n, MetricsOptions as o, CachingRule as p, versioningPlugin as r, _default$1 as s, VersioningOptions as t, _default$2 as u };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classytic/arc",
-  "version": "2.9.1",
+  "version": "2.10.8",
   "description": "Resource-oriented backend framework for Fastify — clean, minimal, powerful, tree-shakable",
   "type": "module",
   "exports": {
@@ -64,6 +64,22 @@
       "types": "./dist/hooks/index.d.mts",
       "default": "./dist/hooks/index.mjs"
     },
+    "./middleware": {
+      "types": "./dist/middleware/index.d.mts",
+      "default": "./dist/middleware/index.mjs"
+    },
+    "./pipeline": {
+      "types": "./dist/pipeline/index.d.mts",
+      "default": "./dist/pipeline/index.mjs"
+    },
+    "./context": {
+      "types": "./dist/context/index.d.mts",
+      "default": "./dist/context/index.mjs"
+    },
+    "./logger": {
+      "types": "./dist/logger/index.d.mts",
+      "default": "./dist/logger/index.mjs"
+    },
     "./registry": {
       "types": "./dist/registry/index.d.mts",
       "default": "./dist/registry/index.mjs"
@@ -112,10 +128,6 @@
       "types": "./dist/events/transports/redis-stream-entry.d.mts",
       "default": "./dist/events/transports/redis-stream-entry.mjs"
     },
-    "./dynamic": {
-      "types": "./dist/dynamic/index.d.mts",
-      "default": "./dist/dynamic/index.mjs"
-    },
     "./testing": {
       "types": "./dist/testing/index.d.mts",
       "default": "./dist/testing/index.mjs"
@@ -124,10 +136,6 @@
       "types": "./dist/testing/storageContract.d.mts",
       "default": "./dist/testing/storageContract.mjs"
     },
-    "./policies": {
-      "types": "./dist/policies/index.d.mts",
-      "default": "./dist/policies/index.mjs"
-    },
     "./factory": {
       "types": "./dist/factory/index.d.mts",
       "default": "./dist/factory/index.mjs"
@@ -188,10 +196,6 @@
       "types": "./dist/scope/index.d.mts",
       "default": "./dist/scope/index.mjs"
     },
-    "./rpc": {
-      "types": "./dist/rpc/index.d.mts",
-      "default": "./dist/rpc/index.mjs"
-    },
     "./mcp": {
       "types": "./dist/integrations/mcp/index.d.mts",
       "default": "./dist/integrations/mcp/index.mjs"
@@ -235,7 +239,8 @@
     "node": ">=22"
   },
   "peerDependencies": {
-    "@classytic/mongokit": ">=3.8.0",
+    "@classytic/mongokit": ">=3.11.0",
+    "@classytic/repo-core": ">=0.2.0",
     "@classytic/streamline": ">=2.1.0",
     "@fastify/cors": ">=11.0.0",
     "@fastify/helmet": ">=13.0.0",
@@ -255,11 +260,11 @@
     "@sinclair/typebox": ">=0.34.0",
     "better-auth": ">=1.6.2",
     "bullmq": ">=5.0.0",
-    "fastify": ">=5.0.0",
+    "fastify": "^5.8.5",
     "fastify-raw-body": ">=5.0.0",
     "ioredis": ">=5.0.0",
     "mongodb": ">=7.0.0",
-    "mongoose": ">=9.4.1",
+    "mongoose": "^9.4.1",
     "pino-pretty": ">=13.0.0",
     "zod": ">=4.0.0"
   },
@@ -267,6 +272,9 @@
     "@classytic/mongokit": {
       "optional": true
     },
+    "@classytic/repo-core": {
+      "optional": true
+    },
     "mongodb": {
       "optional": true
     },
@@ -352,9 +360,12 @@
     "secure-json-parse": "^4.1.0"
   },
   "devDependencies": {
+    "@better-auth/drizzle-adapter": "^1.6.2",
     "@better-auth/mongo-adapter": "^1.6.2",
     "@biomejs/biome": "^2.4.11",
-    "@classytic/mongokit": "^3.8.0",
+    "@classytic/mongokit": "^3.11.0",
+    "@classytic/repo-core": "^0.2.0",
+    "@classytic/sqlitekit": "^0.2.0",
     "@classytic/streamline": "^2.1.0",
     "@fastify/cors": "^11.2.0",
     "@fastify/helmet": "^13.0.2",
@@ -372,8 +383,10 @@
     "@vitest/coverage-v8": "^3.2.4",
     "ajv": "^8.18.0",
     "better-auth": "^1.6.2",
+    "better-sqlite3": "^12.9.0",
     "bullmq": "^5.73.5",
     "dotenv": "^17.4.2",
+    "drizzle-orm": "^0.45.2",
     "fast-check": "^4.6.0",
     "fastify-raw-body": "^5.0.0",
     "ioredis": "^5.10.1",
@@ -381,7 +394,7 @@
     "knip": "^6.4.1",
     "mongodb": "^7.1.0",
     "mongodb-memory-server": "^11.0.1",
-    "mongoose": "^9.4.1",
+    "mongoose": ">=9.4.1",
     "tsdown": "^0.21.7",
     "typescript": "^6.0.2",
     "vitest": "^3.0.0",

package/skills/arc/SKILL.md

@@ -8,11 +8,11 @@ description: |
   Triggers: arc, fastify resource, defineResource, createApp, BaseController, arc preset,
   arc auth, arc events, arc jobs, arc websocket, arc mcp, arc plugin, arc testing, arc cli,
   arc permissions, arc hooks, arc pipeline, arc factory, arc cache, arc QueryCache.
-version: 2.9.1
+version: 2.10.3
 license: MIT
 metadata:
   author: Classytic
-  version: "2.9.1"
+  version: "2.10.3"
 tags:
   - fastify
   - rest-api
@@ -692,14 +692,11 @@ class ProductController extends BaseController<Product> {
 import { createMongooseAdapter } from '@classytic/arc';
 const adapter = createMongooseAdapter({ model: ProductModel, repository: productRepo });
 
-// Custom adapter — implement CrudRepository interface:
-interface CrudRepository<TDoc> {
-  getAll(params?): Promise<TDoc[] | PaginatedResult<TDoc>>;
-  getById(id: string): Promise<TDoc | null>;
-  create(data): Promise<TDoc>;
-  update(id: string, data): Promise<TDoc | null>;
-  delete(id: string): Promise<boolean>;
-}
+// Custom adapter — implement MinimalRepo from @classytic/repo-core/repository:
+import type { MinimalRepo } from '@classytic/repo-core/repository';
+// MinimalRepo<TDoc> = five-method floor (getAll, getById, create, update, delete)
+// StandardRepo<TDoc> = MinimalRepo + optional batch ops, CAS, soft-delete, etc.
+// Arc feature-detects optional methods at call sites.
 ```
 
 ## Events
@@ -790,7 +787,7 @@ afterUpdate(hooks, 'product', async (ctx) => { await invalidateCache(ctx.result.
 ## Pipeline
 
 ```typescript
-import { guard, transform, intercept } from '@classytic/arc';
+import { guard, transform, intercept } from '@classytic/arc/pipeline';
 
 defineResource({
   pipe: {
@@ -1178,7 +1175,6 @@ import {
 } from '@classytic/arc/scope';
 import { createTenantKeyGenerator } from '@classytic/arc/scope';
 import { createRoleHierarchy } from '@classytic/arc/permissions';
-import { createServiceClient } from '@classytic/arc/rpc';
 import { metricsPlugin, versioningPlugin } from '@classytic/arc/plugins';
 import { webhookPlugin } from '@classytic/arc/integrations/webhooks';
 import { mcpPlugin, createMcpServer, defineTool, definePrompt, fieldRulesToZod, resourceToTools } from '@classytic/arc/mcp';

package/skills/arc/references/production.md

@@ -366,28 +366,6 @@ const runner = new MigrationRunner(mongoose.connection.db);
 await runner.up([v2]);
 ```
 
-## Policies
-
-Query-level authorization — modify queries based on user:
-
-```typescript
-import { createAccessControlPolicy } from '@classytic/arc/policies';
-
-const editorPolicy = createAccessControlPolicy({
-  statements: [
-    { resource: 'product', action: ['create', 'update'] },
-    { resource: 'order', action: ['read'] },
-  ],
-});
-
-defineResource({
-  permissions: {
-    create: editorPolicy,
-    update: editorPolicy,
-  },
-});
-```
-
 ## OpenAPI & External Paths
 
 Arc auto-generates OpenAPI 3.0 specs from resource definitions. External integrations (auth adapters, custom routes) inject their paths via `ExternalOpenApiPaths`.
@@ -562,25 +540,6 @@ const relayed = await outbox.relay();  // publishes pending → transport
 
 **OutboxStore interface**: `save(event)`, `getPending(limit)`, `acknowledge(eventId)` (+ optional `claimPending`, `fail`, `getDeadLettered`, `purge`). When you pass `repository`, arc adapts it internally.
 
-## RPC Service Client — Schema Versioning
-
-The service client supports a `schemaVersion` option for contract compatibility between services:
-
-```typescript
-import { createServiceClient } from '@classytic/arc/rpc';
-
-const catalog = createServiceClient({
-  baseUrl: 'http://catalog:3000',
-  schemaVersion: '1.2.0',  // sent as x-arc-schema-version header
-  correlationId: () => request.id,
-  retry: { maxRetries: 2 },
-});
-
-const products = await catalog.resource('product').list();
-```
-
-Receiving services can check `request.headers['x-arc-schema-version']` to detect version mismatches.
-
 ## Bulk Operations Preset
 
 Adds bulk CRUD routes — repository must provide `createMany`, `updateMany`, `deleteMany`:

package/dist/circuitBreaker-CvXkjfrW.d.mts

@@ -1,206 +0,0 @@
-//#region src/utils/circuitBreaker.d.ts
-/**
- * Circuit Breaker Pattern
- *
- * Wraps external service calls with failure protection.
- * Prevents cascading failures by "opening" the circuit when
- * a service is failing, allowing it time to recover.
- *
- * States:
- * - CLOSED: Normal operation, requests pass through
- * - OPEN: Too many failures, all requests fail fast
- * - HALF_OPEN: Testing if service recovered, limited requests
- *
- * @example
- * import { CircuitBreaker } from '@classytic/arc/utils';
- *
- * const paymentBreaker = new CircuitBreaker(async (amount) => {
- *   return await stripe.charges.create({ amount });
- * }, {
- *   failureThreshold: 5,
- *   resetTimeout: 30000,
- *   timeout: 5000,
- * });
- *
- * try {
- *   const result = await paymentBreaker.call(100);
- * } catch (error) {
- *   // Handle failure or circuit open
- * }
- */
-declare const CircuitState: {
-  readonly CLOSED: "CLOSED";
-  readonly OPEN: "OPEN";
-  readonly HALF_OPEN: "HALF_OPEN";
-};
-type CircuitState = (typeof CircuitState)[keyof typeof CircuitState];
-interface CircuitBreakerOptions {
-  /**
-   * Number of failures before opening circuit
-   * @default 5
-   */
-  failureThreshold?: number;
-  /**
-   * Time in ms before attempting to close circuit
-   * @default 60000 (60 seconds)
-   */
-  resetTimeout?: number;
-  /**
-   * Request timeout in ms
-   * @default 10000 (10 seconds)
-   */
-  timeout?: number;
-  /**
-   * Number of successful requests in HALF_OPEN before closing
-   * @default 1
-   */
-  successThreshold?: number;
-  /**
-   * Fallback function when circuit is open.
-   * Receives the same arguments as the wrapped function.
-   */
-  fallback?: (...args: unknown[]) => Promise<unknown>;
-  /**
-   * Callback when state changes
-   */
-  onStateChange?: (from: CircuitState, to: CircuitState) => void;
-  /**
-   * Callback on error
-   */
-  onError?: (error: Error) => void;
-  /**
-   * Name for logging/monitoring
-   */
-  name?: string;
-}
-interface CircuitBreakerStats {
-  name?: string;
-  state: CircuitState;
-  failures: number;
-  successes: number;
-  totalCalls: number;
-  openedAt: number | null;
-  lastCallAt: number | null;
-}
-declare class CircuitBreakerError extends Error {
-  state: CircuitState;
-  constructor(message: string, state: CircuitState);
-}
-declare class CircuitBreaker<T extends (...args: any[]) => Promise<any>> {
-  private state;
-  private failures;
-  private successes;
-  private totalCalls;
-  private nextAttempt;
-  private lastCallAt;
-  private openedAt;
-  private readonly failureThreshold;
-  private readonly resetTimeout;
-  private readonly timeout;
-  private readonly successThreshold;
-  private readonly fallback?;
-  private readonly onStateChange?;
-  private readonly onError?;
-  private readonly name;
-  private readonly fn;
-  constructor(fn: T, options?: CircuitBreakerOptions);
-  /**
-   * Call the wrapped function with circuit breaker protection
-   */
-  call(...args: Parameters<T>): Promise<ReturnType<T>>;
-  /**
-   * Execute function with timeout
-   */
-  private executeWithTimeout;
-  /**
-   * Handle successful call
-   */
-  private onSuccess;
-  /**
-   * Handle failed call
-   */
-  private onFailure;
-  /**
-   * Change circuit state
-   */
-  private setState;
-  /**
-   * Manually open the circuit
-   */
-  open(): void;
-  /**
-   * Manually close the circuit
-   */
-  close(): void;
-  /**
-   * Get current statistics
-   */
-  getStats(): CircuitBreakerStats;
-  /**
-   * Get current state
-   */
-  getState(): CircuitState;
-  /**
-   * Check if circuit is open
-   */
-  isOpen(): boolean;
-  /**
-   * Check if circuit is closed
-   */
-  isClosed(): boolean;
-  /**
-   * Reset statistics
-   */
-  reset(): void;
-}
-/**
- * Create a circuit breaker with sensible defaults
- *
- * @example
- * const emailBreaker = createCircuitBreaker(
- *   async (to, subject, body) => sendEmail(to, subject, body),
- *   { name: 'email-service' }
- * );
- */
-declare function createCircuitBreaker<T extends (...args: any[]) => Promise<any>>(fn: T, options?: CircuitBreakerOptions): CircuitBreaker<T>;
-/**
- * Circuit breaker registry for managing multiple breakers
- */
-declare class CircuitBreakerRegistry {
-  private breakers;
-  /**
-   * Register a circuit breaker
-   */
-  register<T extends (...args: any[]) => Promise<any>>(name: string, fn: T, options?: Omit<CircuitBreakerOptions, "name">): CircuitBreaker<T>;
-  /**
-   * Get a circuit breaker by name
-   */
-  get(name: string): CircuitBreaker<any> | undefined;
-  /**
-   * Get all breakers
-   */
-  getAll(): Map<string, CircuitBreaker<any>>;
-  /**
-   * Get statistics for all breakers
-   */
-  getAllStats(): Record<string, CircuitBreakerStats>;
-  /**
-   * Reset all breakers
-   */
-  resetAll(): void;
-  /**
-   * Open all breakers
-   */
-  openAll(): void;
-  /**
-   * Close all breakers
-   */
-  closeAll(): void;
-}
-/**
- * Create a new CircuitBreakerRegistry instance.
- * Use this instead of a global singleton — attach to fastify.arc or pass explicitly.
- */
-declare function createCircuitBreakerRegistry(): CircuitBreakerRegistry;
-//#endregion
-export { CircuitBreakerStats as a, createCircuitBreakerRegistry as c, CircuitBreakerRegistry as i, CircuitBreakerError as n, CircuitState as o, CircuitBreakerOptions as r, createCircuitBreaker as s, CircuitBreaker as t };