nicot 1.3.8 → 1.4.1

package/dist/src/decorators/property.d.ts

@@ -2,6 +2,7 @@ import { ColumnCommonOptions } from 'typeorm/decorator/options/ColumnCommonOptio
 import { ApiPropertyOptions } from '@nestjs/swagger';
 import { ColumnWithLengthOptions } from 'typeorm/decorator/options/ColumnWithLengthOptions';
 import { AnyClass } from 'nesties';
+import { ValidationOptions } from 'class-validator';
 import { SimpleColumnType, UnsignedColumnType, WithLengthColumnType, WithPrecisionColumnType } from 'typeorm/driver/types/ColumnTypes';
 import { ColumnNumericOptions } from 'typeorm/decorator/options/ColumnNumericOptions';
 import { ClassOrArray, ParseType } from 'nesties';
@@ -52,6 +53,15 @@ export declare const SimpleJsonColumn: <C extends ClassOrArray>(definition: C, o
 export declare const StringJsonColumn: <C extends ClassOrArray>(definition: C, options?: PropertyOptions<ParseType<C>> & {
     columnType?: SimpleColumnType;
 }) => PropertyDecorator;
+/**
+ * Accepts either a valid base64 `string` or a raw binary payload
+ * (`Buffer` / `Uint8Array` / `ArrayBuffer`). The binary case represents the
+ * actual binary data being assigned directly instead of its base64 form.
+ */
+export declare const IsBase64OrBinary: (validationOptions?: ValidationOptions) => PropertyDecorator;
+export declare const Base64BinaryColumn: (options?: PropertyOptions<string> & {
+    columnType?: SimpleColumnType | WithLengthColumnType;
+}) => PropertyDecorator;
 export declare const NotColumn: (options?: OpenAPIOptions<any>, specials?: {
     keepInCreate?: boolean;
     hideInUpsert?: boolean;

package/dist/src/decorators/query.d.ts

@@ -32,6 +32,16 @@ export declare const createQueryArrayify: (newWrapper: QueryWrapper, singleFallb
 export declare const createQueryOperatorArrayify: (operator: string, singleFallback?: string | QueryWrapper) => (field?: string) => PropertyDecorator;
 export declare const QueryIn: (field?: string) => PropertyDecorator;
 export declare const QueryNotIn: (field?: string) => PropertyDecorator;
+/**
+ * Builds a query condition for a `Base64BinaryColumn`. The incoming base64
+ * string (the API-facing form) is decoded into a `Buffer` right before it is
+ * bound as a query parameter, so it can be compared against the raw binary
+ * stored in the database. A value that is already binary
+ * (Buffer / Uint8Array / ArrayBuffer) is used as-is.
+ */
+export declare const createQueryBase64Operator: (operator: string) => (field?: string) => PropertyDecorator;
+export declare const QueryBase64Equal: (field?: string) => PropertyDecorator;
+export declare const QueryBase64NotEqual: (field?: string) => PropertyDecorator;
 export declare const QueryFullText: (options?: QueryFullTextColumnOptions) => PropertyDecorator;
 export declare const QueryAnd: (...decs: PropertyDecorator[]) => PropertyDecorator;
 export declare const QueryOr: (...decs: PropertyDecorator[]) => PropertyDecorator;

package/dist/src/utility/base64-binary.d.ts

@@ -0,0 +1,23 @@
+import { ValueTransformer } from 'typeorm';
+export type BinaryLike = Buffer | Uint8Array | ArrayBuffer;
+/**
+ * Whether the value is a raw binary payload (Buffer / Uint8Array / ArrayBuffer).
+ * Such values are considered "already the binary" and are accepted as-is even
+ * though the TS-level type of a base64 binary column is a base64 `string`.
+ */
+export declare function isBinaryLike(value: unknown): value is BinaryLike;
+export declare function binaryToBuffer(value: BinaryLike): Buffer;
+/**
+ * Bridges a base64 `string` on the entity/API side with raw binary storage in
+ * the database.
+ *
+ * - `to` (entity -> DB): a base64 string is decoded into a `Buffer`. If the
+ *   incoming value is already binary (Buffer / Uint8Array / ArrayBuffer) it is
+ *   treated as the binary payload itself and stored directly.
+ * - `from` (DB -> entity): the stored binary is encoded back into a base64
+ *   string.
+ */
+export declare class Base64BinaryTransformer implements ValueTransformer {
+    to(entValue: string | BinaryLike | null | undefined): Buffer | null | undefined;
+    from(dbValue: BinaryLike | null | undefined): string | null | undefined;
+}

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

@@ -1 +1,2 @@
 export * from './query';
+export * from './base64-binary';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "nicot",
   "description": "Nest.js interacting with class-validator + OpenAPI + TypeORM for Nest.js Restful API development.",
-  "version": "1.3.8",
+  "version": "1.4.1",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
@@ -69,13 +69,14 @@
     "@nestjs/core": "^11.0.14",
     "@nestjs/platform-express": "^11.0.14",
     "@nestjs/testing": "^11.0.14",
-    "@nestjs/typeorm": "^11.0.0",
+    "@nestjs/typeorm": "^11.0.1",
     "@types/jest": "^29.5.14",
     "@types/lodash": "^4.17.20",
     "@types/node": "^22.15.2",
     "@types/supertest": "^2.0.12",
     "@typescript-eslint/eslint-plugin": "^4.33.0",
     "@typescript-eslint/parser": "^4.33.0",
+    "class-validator": "^0.15.1",
     "esbuild": "^0.25.12",
     "esbuild-register": "^3.6.0",
     "eslint": "^7.32.0",
@@ -87,6 +88,7 @@
     "rxjs": "^7.8.2",
     "supertest": "^6.2.4",
     "ts-jest": "^29.3.2",
+    "typeorm": "^1.0.0",
     "typescript": "^5.8.3"
   },
   "peerDependencies": {
@@ -95,9 +97,9 @@
     "@nestjs/core": "^11.0.0 || ^9.4.0 || ^10.0.0",
     "@nestjs/swagger": "^11.0.0 || ^7.1.8 || ^6.3.0",
     "class-transformer": "^0.5.1",
-    "class-validator": "^0.14.0",
+    "class-validator": "^0.14.0 || ^0.15.0",
     "rxjs": ">=7.0.0",
-    "typeorm": "^0.3.27"
+    "typeorm": "^0.3.27 || ^1.0.0"
   },
   "dependencies": {
     "lodash": "^4.17.21",