@decaf-ts/for-fabric 0.12.10 → 0.13.0

package/lib/types/contracts/crud/crud-contract.d.mts

@@ -11,6 +11,7 @@ import { Checkable, healthcheck } from "../../shared/interfaces/Checkable.d.mts"
 import { Constructor } from "@decaf-ts/decoration";
 import { FabricContractContext } from "../ContractContext.d.mts";
 import { PrimaryKeyType } from "@decaf-ts/db-decorators";
+import { FabricFlags } from "../../shared/index.d.mts";
 /**
  * @description Base contract class for CRUD operations in Fabric chaincode
  * @summary Provides standard create, read, update, and delete operations for models in Fabric chaincode
@@ -113,6 +114,7 @@ export declare abstract class FabricCrudContract<M extends Model> extends Contra
      */
     read(ctx: Ctx | FabricContractContext, key: PrimaryKeyType | string, ...args: any[]): Promise<M | string>;
     protected getTransientData(ctx: FabricContractContext): any;
+    protected deserializeBulkModels(models: string): M[];
     /**
      * @description Updates a single model in the state database
      * @summary Delegates to the repository's update method
@@ -196,5 +198,5 @@ export declare abstract class FabricCrudContract<M extends Model> extends Contra
     protected ensureMirrorWritePermissions(ctx: FabricContractContext): void;
     protected logCtx<ARGS extends any[] = any[], METHOD extends MethodOrOperation = MethodOrOperation>(args: MaybeContextualArg<FabricContractContext, ARGS>, operation: METHOD): FabricContextualizedArgs<ARGS, METHOD extends string ? true : false>;
     protected logCtx<ARGS extends any[] = any[], METHOD extends MethodOrOperation = MethodOrOperation>(args: MaybeContextualArg<FabricContractContext, ARGS>, operation: METHOD, allowCreate: false): FabricContextualizedArgs<ARGS, METHOD extends string ? true : false>;
-    protected logCtx<ARGS extends any[] = any[], METHOD extends MethodOrOperation = MethodOrOperation>(args: MaybeContextualArg<FabricContractContext, ARGS>, operation: METHOD, allowCreate: true): Promise<FabricContextualizedArgs<ARGS, METHOD extends string ? true : false>>;
+    protected logCtx<ARGS extends any[] = any[], METHOD extends MethodOrOperation = MethodOrOperation>(args: MaybeContextualArg<FabricContractContext, ARGS>, operation: METHOD, allowCreate: true, overrides?: Partial<FabricFlags<any>>): Promise<FabricContextualizedArgs<ARGS, METHOD extends string ? true : false>>;
 }

package/lib/types/contracts/types.d.cts

@@ -25,6 +25,7 @@ export interface FabricContractFlags extends FabricFlags {
     segregateRead?: string | string[];
     forceSegregateWrite?: boolean;
     fullySegregated?: boolean;
+    allowContextTransientMap?: boolean;
     sequenceSegregation?: Map<string, {
         fullySegregated: boolean;
         collections: string[];

package/lib/types/contracts/types.d.mts

@@ -25,6 +25,7 @@ export interface FabricContractFlags extends FabricFlags {
     segregateRead?: string | string[];
     forceSegregateWrite?: boolean;
     fullySegregated?: boolean;
+    allowContextTransientMap?: boolean;
     sequenceSegregation?: Map<string, {
         fullySegregated: boolean;
         collections: string[];

package/lib/types/shared/constants.d.cts

@@ -13,7 +13,11 @@ export declare enum FabricModelKeys {
     FABRIC = "fabric",
     OWNED_BY = "owned-by",
     TRANSACTION_ID = "transaction-id",
-    MIRROR = "mirror"
+    MIRROR = "mirror",
+    CONTRACT = "fabric.contract",
+    CHAINCODE = "fabric.chaincode",
+    CHANNEL = "fabric.channel",
+    OVERRIDES = "__overrides"
 }
 /**
  * @description Supported identity types for Fabric credentials

package/lib/types/shared/constants.d.mts

@@ -13,7 +13,11 @@ export declare enum FabricModelKeys {
     FABRIC = "fabric",
     OWNED_BY = "owned-by",
     TRANSACTION_ID = "transaction-id",
-    MIRROR = "mirror"
+    MIRROR = "mirror",
+    CONTRACT = "fabric.contract",
+    CHAINCODE = "fabric.chaincode",
+    CHANNEL = "fabric.channel",
+    OVERRIDES = "__overrides"
 }
 /**
  * @description Supported identity types for Fabric credentials

package/lib/types/shared/decorators.d.cts

@@ -1,4 +1,4 @@
-import { Repo, Context, Repository, ContextOf } from "@decaf-ts/core";
+import { Repo, Context, Repository, ContextOf, ContextualArgs } from "@decaf-ts/core";
 import { Model } from "@decaf-ts/decorator-validation";
 import { ClientIdentity } from "fabric-shim-api";
 import { Constructor } from "@decaf-ts/decoration";
@@ -6,6 +6,14 @@ import { FabricFlags } from "./types.d.cts";
 import { FabricContractFlags } from "../contracts/types.d.cts";
 import "../shared/overrides";
 import { type FabricContractContext } from "../contracts/ContractContext.d.cts";
+export type ResolverFunction<T> = (model: Constructor<Model<any>>, ...args: ContextualArgs<any>) => Promise<T> | T;
+export declare const DefaultContractResolver: (model: Constructor<Model<any>>, ...args: ContextualArgs<any>) => string;
+export type ChaincodeMetadata = {
+    resolver: string | ResolverFunction<string>;
+};
+export declare function contract(resolver: any): (model: any, prop?: any, descriptor?: PropertyDescriptor | number) => void;
+export declare function chaincode(resolver: any): (model: any, prop?: any, descriptor?: PropertyDescriptor | number) => void;
+export declare function channel(resolver: any): (model: any, prop?: any, descriptor?: PropertyDescriptor | number) => void;
 /**
  * @description Extracts the MSP ID from either a string or ClientIdentity object
  * @param identity - The identity value which can be a string MSP ID or ClientIdentity object

package/lib/types/shared/decorators.d.mts

@@ -1,4 +1,4 @@
-import { Repo, Context, Repository, ContextOf } from "@decaf-ts/core";
+import { Repo, Context, Repository, ContextOf, ContextualArgs } from "@decaf-ts/core";
 import { Model } from "@decaf-ts/decorator-validation";
 import { ClientIdentity } from "fabric-shim-api";
 import { Constructor } from "@decaf-ts/decoration";
@@ -6,6 +6,14 @@ import { FabricFlags } from "./types.d.mts";
 import { FabricContractFlags } from "../contracts/types.d.mts";
 import "../shared/overrides";
 import { type FabricContractContext } from "../contracts/ContractContext.d.mts";
+export type ResolverFunction<T> = (model: Constructor<Model<any>>, ...args: ContextualArgs<any>) => Promise<T> | T;
+export declare const DefaultContractResolver: (model: Constructor<Model<any>>, ...args: ContextualArgs<any>) => string;
+export type ChaincodeMetadata = {
+    resolver: string | ResolverFunction<string>;
+};
+export declare function contract(resolver: any): (model: any, prop?: any, descriptor?: PropertyDescriptor | number) => void;
+export declare function chaincode(resolver: any): (model: any, prop?: any, descriptor?: PropertyDescriptor | number) => void;
+export declare function channel(resolver: any): (model: any, prop?: any, descriptor?: PropertyDescriptor | number) => void;
 /**
  * @description Extracts the MSP ID from either a string or ClientIdentity object
  * @param identity - The identity value which can be a string MSP ID or ClientIdentity object

package/lib/types/shared/overrides/Model.d.cts

@@ -2,6 +2,7 @@ import { SegregatedModel } from "../types.d.cts";
 import { Constructor } from "@decaf-ts/decoration";
 import "@decaf-ts/decorator-validation";
 import { CollectionResolver, MirrorMetadata } from "../decorators.d.cts";
+import { ContextualArgs } from "@decaf-ts/core";
 declare module "@decaf-ts/decorator-validation" {
     interface Model {
         isPrivate<M extends Model>(this: M): boolean;
@@ -18,5 +19,8 @@ declare module "@decaf-ts/decorator-validation" {
             privateCols: (string | CollectionResolver)[];
             sharedCols: (string | CollectionResolver)[];
         };
+        function chaincodeOf<M extends Model>(model: Constructor<M>, ...args: ContextualArgs<any>): string | undefined | Promise<string | undefined>;
+        function contractOf<M extends Model>(model: Constructor<M>, ...args: ContextualArgs<any>): string | undefined | Promise<string | undefined>;
+        function channelOf<M extends Model>(model: Constructor<M>, ...args: ContextualArgs<any>): string | undefined | Promise<string | undefined>;
     }
 }

package/lib/types/shared/overrides/Model.d.mts

@@ -2,6 +2,7 @@ import { SegregatedModel } from "../types.d.mts";
 import { Constructor } from "@decaf-ts/decoration";
 import "@decaf-ts/decorator-validation";
 import { CollectionResolver, MirrorMetadata } from "../decorators.d.mts";
+import { ContextualArgs } from "@decaf-ts/core";
 declare module "@decaf-ts/decorator-validation" {
     interface Model {
         isPrivate<M extends Model>(this: M): boolean;
@@ -18,5 +19,8 @@ declare module "@decaf-ts/decorator-validation" {
             privateCols: (string | CollectionResolver)[];
             sharedCols: (string | CollectionResolver)[];
         };
+        function chaincodeOf<M extends Model>(model: Constructor<M>, ...args: ContextualArgs<any>): string | undefined | Promise<string | undefined>;
+        function contractOf<M extends Model>(model: Constructor<M>, ...args: ContextualArgs<any>): string | undefined | Promise<string | undefined>;
+        function channelOf<M extends Model>(model: Constructor<M>, ...args: ContextualArgs<any>): string | undefined | Promise<string | undefined>;
     }
 }

package/lib/types/version.d.cts

@@ -5,12 +5,12 @@ export declare const VERSION = "0.12.10";
  * the placeholder with the actual commit hash at publish time.
  * @const COMMIT
  */
-export declare const COMMIT = "f2d8170";
+export declare const COMMIT = "5880c77";
 /**
  * @description Represents the full version string of the module.
  * @summary Stores the semver version and commit hash for the package.
  * The build replaces the placeholder with the actual `<version>-<commit>` value at publish time.
  * @const FULL_VERSION
  */
-export declare const FULL_VERSION = "0.12.10-f2d8170";
+export declare const FULL_VERSION = "0.12.10-5880c77";
 export declare const PACKAGE_NAME = "@decaf-ts/for-fabric";

package/lib/types/version.d.mts

@@ -5,12 +5,12 @@ export declare const VERSION = "0.12.10";
  * the placeholder with the actual commit hash at publish time.
  * @const COMMIT
  */
-export declare const COMMIT = "f2d8170";
+export declare const COMMIT = "5880c77";
 /**
  * @description Represents the full version string of the module.
  * @summary Stores the semver version and commit hash for the package.
  * The build replaces the placeholder with the actual `<version>-<commit>` value at publish time.
  * @const FULL_VERSION
  */
-export declare const FULL_VERSION = "0.12.10-f2d8170";
+export declare const FULL_VERSION = "0.12.10-5880c77";
 export declare const PACKAGE_NAME = "@decaf-ts/for-fabric";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decaf-ts/for-fabric",
-  "version": "0.12.10",
+  "version": "0.13.0",
   "packageManager": "npm@11.13.0",
   "description": "Abstracts fabric logic",
   "type": "module",