feat: replace programIDs with diagramID (CV3-364)

packages/api-sdk/src/resources/version/diagram.ts

@@ -0,0 +1,25 @@
+import Fetch from '@api-sdk/fetch';
+import { BaseModels } from '@voiceflow/base-types';
+
+import CrudNestedResource from '../crudNested';
+
+const ENDPOINT = 'diagrams';
+
+export type ModelKey = 'diagramID';
+
+class DiagramResource extends CrudNestedResource<string, BaseModels.Diagram.Model, ModelKey, DiagramResource> {
+  constructor(fetch: Fetch, { parentEndpoint }: { parentEndpoint: string }) {
+    super({
+      fetch,
+      clazz: DiagramResource,
+      endpoint: ENDPOINT,
+      clazzOptions: { parentEndpoint },
+    });
+  }
+
+  public async get(versionID: string, diagramID: string): Promise<BaseModels.Diagram.Model> {
+    return this._getByID<BaseModels.Diagram.Model>(versionID, diagramID);
+  }
+}
+
+export default DiagramResource;

packages/api-sdk/src/resources/version/index.ts

@@ -5,7 +5,10 @@ import { AnyRecord } from '@voiceflow/common';
 import { Fields } from '../base';
 import CrudResource from '../crud';
 import CanvasTemplate from './canvasTemplate';
+import Diagram from './diagram';
 import Domain from './domain';
+import Program from './program';
+import PrototypeProgram from './prototypeProgram';
 
 export const ENDPOINT = 'versions';
 
@@ -16,6 +19,12 @@ class VersionResource extends CrudResource<BaseModels.Version.Model<BaseModels.V
 
   public canvasTemplate: CanvasTemplate;
 
+  public diagram: Diagram;
+
+  public program: Program;
+
+  public prototypeProgram: PrototypeProgram;
+
   constructor(fetch: Fetch) {
     super({
       fetch,
@@ -25,6 +34,9 @@ class VersionResource extends CrudResource<BaseModels.Version.Model<BaseModels.V
 
     this.domain = new Domain(fetch, { parentEndpoint: ENDPOINT });
     this.canvasTemplate = new CanvasTemplate(fetch, { parentEndpoint: ENDPOINT });
+    this.diagram = new Diagram(fetch, { parentEndpoint: ENDPOINT });
+    this.program = new Program(fetch, { parentEndpoint: ENDPOINT });
+    this.prototypeProgram = new PrototypeProgram(fetch, { parentEndpoint: ENDPOINT });
   }
 
   public async get<T extends Partial<BaseModels.Version.Model<BaseModels.Version.PlatformData>>>(id: string, fields: Fields): Promise<T>;

packages/api-sdk/src/resources/version/program.ts

@@ -0,0 +1,25 @@
+import Fetch from '@api-sdk/fetch';
+import { BaseModels } from '@voiceflow/base-types';
+
+import CrudNestedResource from '../crudNested';
+
+const ENDPOINT = 'programs';
+
+export type ModelKey = 'diagramID';
+
+class ProgramResource extends CrudNestedResource<string, BaseModels.Program.Model, ModelKey, ProgramResource> {
+  constructor(fetch: Fetch, { parentEndpoint }: { parentEndpoint: string }) {
+    super({
+      fetch,
+      clazz: ProgramResource,
+      endpoint: ENDPOINT,
+      clazzOptions: { parentEndpoint },
+    });
+  }
+
+  public async get(versionID: string, diagramID: string): Promise<BaseModels.Program.Model> {
+    return this._getByID<BaseModels.Program.Model>(versionID, diagramID);
+  }
+}
+
+export default ProgramResource;

packages/api-sdk/src/resources/version/prototypeProgram.ts

@@ -0,0 +1,25 @@
+import Fetch from '@api-sdk/fetch';
+import { BaseModels } from '@voiceflow/base-types';
+
+import CrudNestedResource from '../crudNested';
+
+const ENDPOINT = 'prototype-programs';
+
+export type ModelKey = 'diagramID';
+
+class PrototypeProgramResource extends CrudNestedResource<string, BaseModels.Program.Model, ModelKey, PrototypeProgramResource> {
+  constructor(fetch: Fetch, { parentEndpoint }: { parentEndpoint: string }) {
+    super({
+      fetch,
+      clazz: PrototypeProgramResource,
+      endpoint: ENDPOINT,
+      clazzOptions: { parentEndpoint },
+    });
+  }
+
+  public async get(versionID: string, diagramID: string): Promise<BaseModels.Program.Model> {
+    return this._getByID<BaseModels.Program.Model>(versionID, diagramID);
+  }
+}
+
+export default PrototypeProgramResource;

packages/base-types/src/models/version/prototype.ts

@@ -4,7 +4,7 @@ import { BaseCommand, Intent, PrototypeModel, Slot } from '../base';
 
 export interface PrototypeStackFrame<Command extends BaseCommand = BaseCommand> {
   nodeID?: Nullable<string>;
-  programID: string;
+  diagramID: string;
 
   storage?: AnyRecord;
   commands?: Command[];

packages/base-types/src/runtimeLogs/utils/types.ts

@@ -11,7 +11,7 @@ export interface PathReference {
 /** A reference to a flow (frame) on the canvas. */
 export interface FlowReference {
   name: string | null;
-  programID: string;
+  diagramID: string;
 }
 
 /** A common interface for representing a before & after change of a value. */