@gravito/mass 2.0.0 → 3.0.1

package/dist/mass/src/validator.d.ts

@@ -1,18 +1,21 @@
 import type { Env, MiddlewareHandler } from '@gravito/photon';
 import type { Static, TSchema } from '@sinclair/typebox';
 /**
- * Validation source type.
+ * The source of the data to be validated.
+ * @public
  */
 export type ValidationSource = 'json' | 'query' | 'param' | 'form';
 /**
- * Create a validation middleware.
+ * Create a validation middleware using TypeBox.
  *
- * Validates the request data against the provided TypeBox schema.
+ * This function wraps the Hono TypeBox validator, providing a seamless
+ * integration with Gravito Photon for high-performance schema validation.
  *
- * @param source - Validation source (json, query, param, form)
- * @param schema - TypeBox Schema
- * @param hook - Optional callback to handle validation results
- * @returns Photon middleware handler that validates the request.
+ * @param source - The request part to validate (json, query, param, form)
+ * @param schema - The TypeBox schema to validate against
+ * @param hook - Optional callback to handle validation results manually
+ * @returns A Photon-compatible middleware handler.
+ * @public
  */
 export declare function validate<T extends TSchema, S extends ValidationSource, E extends Env = any, P extends string = any>(source: S, schema: T, hook?: (result: any, c: any) => any): MiddlewareHandler<E, P, {
     in: {

package/dist/mass/src/validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../src/validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAE7D,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAExD;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAA;AAElE;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CACtB,CAAC,SAAS,OAAO,EACjB,CAAC,SAAS,gBAAgB,EAC1B,CAAC,SAAS,GAAG,GAAG,GAAG,EACnB,CAAC,SAAS,MAAM,GAAG,GAAG,EAEtB,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,CAAC,EACT,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,KAAK,GAAG,GAClC,iBAAiB,CAClB,CAAC,EACD,CAAC,EACD;IACE,EAAE,EAAE;SAAG,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;KAAE,CAAA;IAC3B,GAAG,EAAE;SAAG,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;KAAE,CAAA;CAC7B,CACF,CAEA"}
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../src/validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAE7D,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAExD;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAA;AAElE;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CACtB,CAAC,SAAS,OAAO,EACjB,CAAC,SAAS,gBAAgB,EAC1B,CAAC,SAAS,GAAG,GAAG,GAAG,EACnB,CAAC,SAAS,MAAM,GAAG,GAAG,EAEtB,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,CAAC,EACT,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,KAAK,GAAG,GAClC,iBAAiB,CAClB,CAAC,EACD,CAAC,EACD;IACE,EAAE,EAAE;SAAG,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;KAAE,CAAA;IAC3B,GAAG,EAAE;SAAG,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;KAAE,CAAA;CAC7B,CACF,CAEA"}

package/dist/photon/src/index.d.ts

@@ -1,3 +1,21 @@
+/**
+ * @gravito/photon - High-performance web framework based on Hono.
+ *
+ * Photon is the primary web engine for Gravito, providing a fast,
+ * flexible, and standard-compliant API for building web applications.
+ * It re-exports Hono while adding enterprise-grade middleware and utilities.
+ *
+ * @example
+ * ```typescript
+ * import { Photon } from '@gravito/photon'
+ * const app = new Photon()
+ * app.get('/', (c) => c.text('Hello!'))
+ * ```
+ */
 export * from 'hono';
 export { Hono as Photon } from 'hono';
+/**
+ * Binary-related middleware for Photon.
+ */
+export * from './middleware/binary';
 //# sourceMappingURL=index.d.ts.map

package/dist/photon/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../photon/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,MAAM,CAAA;AACpB,OAAO,EAAE,IAAI,IAAI,MAAM,EAAE,MAAM,MAAM,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../photon/src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,cAAc,MAAM,CAAA;AACpB,OAAO,EAAE,IAAI,IAAI,MAAM,EAAE,MAAM,MAAM,CAAA;AACrC;;GAEG;AACH,cAAc,qBAAqB,CAAA"}

package/dist/photon/src/middleware/binary.d.ts

@@ -0,0 +1,35 @@
+import type { MiddlewareHandler } from 'hono';
+/**
+ * Binary Middleware for Photon
+ *
+ * Automatically detects 'Accept: application/cbor' and encodes
+ * JSON responses using the CBOR binary format for high-performance communication.
+ *
+ * @example
+ * ```typescript
+ * import { Photon } from '@gravito/photon'
+ * import { binaryMiddleware } from '@gravito/photon/middleware/binary'
+ *
+ * const app = new Photon()
+ * app.use(binaryMiddleware())
+ *
+ * app.get('/api/data', (c) => c.json({ items: [...] }))
+ * ```
+ *
+ * @performance
+ * - CBOR encoding is ~2-3x faster than JSON.stringify for large objects
+ * - Binary format reduces payload size by 20-40% on average
+ * - Recommended for high-frequency API calls with large datasets
+ *
+ * @client_usage
+ * ```typescript
+ * import { decode } from 'cborg'
+ *
+ * const res = await fetch('/api/data', {
+ *   headers: { Accept: 'application/cbor' }
+ * })
+ * const data = decode(new Uint8Array(await res.arrayBuffer()))
+ * ```
+ */
+export declare const binaryMiddleware: () => MiddlewareHandler;
+//# sourceMappingURL=binary.d.ts.map

package/dist/photon/src/middleware/binary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary.d.ts","sourceRoot":"","sources":["../../../../../photon/src/middleware/binary.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAA;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,gBAAgB,QAAO,iBAyBnC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gravito/mass",
-  "version": "2.0.0",
+  "version": "3.0.1",
   "description": "TypeBox-based validation for Gravito - High-performance schema validation with full TypeScript support",
   "type": "module",
   "main": "./dist/index.js",