docs: add pc builder tsdoc

hirosystems · Jul 24, 2023 · ec88d1d · ec88d1d
1 parent 3bddcc5
commit ec88d1d
Show file tree

Hide file tree

Showing 2 changed files with 26 additions and 1 deletion.
diff --git a/packages/transactions/src/index.ts b/packages/transactions/src/index.ts
@@ -30,6 +30,22 @@ export {
   isTokenTransferPayload,
   serializePayload,
 } from './payload';
+/**
+ * ### `Pc.` Post Condition Builder
+ * @beta Interface may be subject to change in future releases.
+ *
+ * The Pc namespace is provided as a convenience to build post conditions.
+ * The pattern chains methods together to build a post condition.
+ * `PRINCIPAL -> [AMOUNT] -> CODE -> ASSET`
+ *
+ * The builder starts with the {@link Pc.principal} method.
+ *
+ * @example
+ * ```
+ * import { Pc } from '@stacks/transactions';
+ * Pc.principal('STB44HYPYAT2BB2QE513NSP81HTMYWBJP02HPGK6').willSendEq(10000).ustx();
+ * ```
+ */
 export * as Pc from './pc';
 export {
   createFungiblePostCondition,

diff --git a/packages/transactions/src/pc.ts b/packages/transactions/src/pc.ts
@@ -42,7 +42,7 @@ type NftString = `${ContractIdString}::${string}`;
  * @example
  * ```
  * import { Pc } from '@stacks/transactions';
- * Pc.principal('STB44HYPYAT2BB2QE513NSP81HTMYWBJP02HPGK6').willSendEq(100).stx();
+ * Pc.principal('STB44HYPYAT2BB2QE513NSP81HTMYWBJP02HPGK6').willSendEq(10000).ustx();
  * ```
  */
 export function principal(principal: AddressString | ContractIdString) {
@@ -55,6 +55,9 @@ export function principal(principal: AddressString | ContractIdString) {
   return new PartialPcWithPrincipal(principal, undefined);
 }
 
+/**
+ * Not meant to be used directly. Start from `Pc.principal(…)` instead.
+ */
 class PartialPcWithPrincipal {
   constructor(private address: string, private contractName?: string) {}
 
@@ -192,6 +195,9 @@ class PartialPcWithPrincipal {
   }
 }
 
+/**
+ * Not meant to be used directly. Start from `Pc.principal(…)` instead.
+ */
 class PartialPcFtWithCode {
   constructor(
     private address: string,
@@ -236,6 +242,9 @@ class PartialPcFtWithCode {
   }
 }
 
+/**
+ * Not meant to be used directly. Start from `Pc.principal(…)` instead.
+ */
 class PartialPcNftWithCode {
   constructor(
     private principal: string,