fix: deprecate kinds in favor of far classes

Agoric · Sep 7, 2022 · d9469b9 · d9469b9
1 parent d9583f8
commit d9469b9
Showing 1 changed file with 9 additions and 0 deletions.
diff --git a/packages/vat-data/src/types.d.ts b/packages/vat-data/src/types.d.ts
@@ -95,12 +95,15 @@ type DefineKindOptions<C> = {
 
 export type VatData = {
   // virtual kinds
+  /** @deprecated Use defineVirtualFarClass instead */
   defineKind: <P, S, F>(
     tag: string,
     init: (...args: P) => S,
     facet: F,
     options?: DefineKindOptions<KindContext<S, F>>,
   ) => (...args: P) => KindFacet<F>;
+
+  /** @deprecated Use defineVirtualFarClassKit instead */
   defineKindMulti: <P, S, B>(
     tag: string,
     init: (...args: P) => S,
@@ -110,12 +113,16 @@ export type VatData = {
 
   // durable kinds
   makeKindHandle: (descriptionTag: string) => DurableKindHandle;
+
+  /** @deprecated Use defineDurableFarClass instead */
   defineDurableKind: <P, S, F>(
     kindHandle: DurableKindHandle,
     init: (...args: P) => S,
     facet: F,
     options?: DefineKindOptions<KindContext<S, F>>,
   ) => (...args: P) => KindFacet<F>;
+
+  /** @deprecated Use defineDurableFarClassKit instead */
   defineDurableKindMulti: <P, S, B>(
     kindHandle: DurableKindHandle,
     init: (...args: P) => S,
@@ -165,6 +172,7 @@ interface PickFacet {
   ): (...args: Parameters<M>) => ReturnType<M>[F];
 }
 
+/** @deprecated Use vivifyFarClass instead */
 type VivifyKind = <P, S, F>(
   baggage: Baggage,
   tag: string,
@@ -173,6 +181,7 @@ type VivifyKind = <P, S, F>(
   options?: DefineKindOptions<KindContext<S, F>>,
 ) => (...args: P) => KindFacet<F>;
 
+/** @deprecated Use vivifyFarClassKit instead */
 type VivifyKindMulti = <P, S, B>(
   baggage: Baggage,
   tag: string,