PCC-1623: Initial implementation of metadata groups in SDK + starter kit

.changeset/good-weeks-agree.md

@@ -0,0 +1,10 @@
+---
+"@pantheon-systems/next-approuter-pcc-starter-ts": patch
+"@pantheon-systems/pcc-react-sample-library": patch
+"@pantheon-systems/pcc-react-sdk": patch
+"@pantheon-systems/pcc-browser-sdk": patch
+"@pantheon-systems/pcc-sdk-core": patch
+"@pantheon-systems/pcc-cli": patch
+---
+
+Use 'label' for metadata group record identifiers instead of 'name'

.changeset/pre.json

@@ -0,0 +1,29 @@
+{
+  "mode": "pre",
+  "tag": "beta",
+  "initialVersions": {
+    "eslint-config-pcc-custom": "1.0.0",
+    "testpages": "0.1.0",
+    "@pantheon-systems/pcc-browser-sdk": "3.9.0",
+    "@pantheon-systems/pcc-cli": "3.9.0",
+    "@pantheon-systems/pcc-sdk-core": "3.9.0",
+    "@pantheon-systems/pcc-react-sample-library": "3.9.0",
+    "@pantheon-systems/pcc-react-sdk": "3.9.0",
+    "@pantheon-systems/pcc-vue-sdk": "3.9.0",
+    "gatsby-pcc-starter": "1.0.0",
+    "gatsby-pcc-starter-ts": "1.0.0",
+    "@pantheon-systems/next-pcc-starter": "1.0.0",
+    "@pantheon-systems/next-approuter-pcc-starter-ts": "1.1.8",
+    "@pantheon-systems/next-pcc-starter-ts": "1.0.0",
+    "@pantheon-systems/vue-pcc-starter": "1.1.3",
+    "@pantheon-systems/vue-pcc-starter-ts": "1.1.3"
+  },
+  "changesets": [
+    "good-weeks-agree",
+    "plenty-rice-cheer",
+    "proud-socks-cry",
+    "seven-owls-poke",
+    "sixty-moose-act",
+    "ten-cats-swim"
+  ]
+}

.changeset/seven-owls-poke.md

@@ -0,0 +1,5 @@
+---
+"@pantheon-systems/pcc-sdk-core": patch
+---
+
+Allow caller to retrieve all metadata groups, optionally hydrated.

.changeset/sixty-moose-act.md

@@ -0,0 +1,5 @@
+---
+"@pantheon-systems/pcc-sdk-core": minor
+---
+
+Add support for metadata groups (like authors).

packages/browser/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @pantheon-systems/pcc-browser-sdk
 
+## 3.10.0-beta.2
+
+### Patch Changes
+
+- 67bc79b: Use 'label' for metadata group record identifiers instead of 'name'
+- Updated dependencies [67bc79b]
+  - @pantheon-systems/[email protected]
+
+## 3.10.0-beta.1
+
+### Patch Changes
+
+- Updated dependencies [400fc48]
+  - @pantheon-systems/[email protected]
+
+## 3.10.0-beta.0
+
+### Patch Changes
+
+- Updated dependencies [572fb97]
+  - @pantheon-systems/[email protected]
+
 ## 3.9.0
 
 ### Patch Changes

packages/browser/package.json

@@ -2,7 +2,7 @@
   "name": "@pantheon-systems/pcc-browser-sdk",
   "author": "@pantheon-systems",
   "description": "Pantheon Content Cloud Browser SDK",
-  "version": "3.9.0",
+  "version": "3.10.0-beta.2",
   "main": "dist/index.js",
   "files": [
     "dist",

packages/cli/CHANGELOG.md

@@ -1,5 +1,34 @@
 # @pantheon-systems/pcc-cli
 
+## 3.10.0-beta.2
+
+### Minor Changes
+
+- 0b3ee7b: No longer download turbo.json when initializing a new project from
+  the starter kit.
+
+### Patch Changes
+
+- 67bc79b: Use 'label' for metadata group record identifiers instead of 'name'
+- 39b7604: Added a warning message when CLI build is pointing to non-production
+  environment.
+- Updated dependencies [67bc79b]
+  - @pantheon-systems/[email protected]
+
+## 3.10.0-beta.1
+
+### Patch Changes
+
+- Updated dependencies [400fc48]
+  - @pantheon-systems/[email protected]
+
+## 3.10.0-beta.0
+
+### Patch Changes
+
+- Updated dependencies [572fb97]
+  - @pantheon-systems/[email protected]
+
 ## 3.9.0
 
 ### Patch Changes

packages/cli/package.json

@@ -2,7 +2,7 @@
   "name": "@pantheon-systems/pcc-cli",
   "author": "@pantheon-systems",
   "description": "Pantheon Content Cloud CLI",
-  "version": "3.9.0",
+  "version": "3.10.0-beta.2",
   "type": "module",
   "license": "MIT",
   "keywords": [

packages/core/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @pantheon-systems/pcc-sdk-core
 
+## 3.10.0-beta.2
+
+### Patch Changes
+
+- 67bc79b: Use 'label' for metadata group record identifiers instead of 'name'
+
+## 3.10.0-beta.1
+
+### Patch Changes
+
+- 400fc48: Allow caller to retrieve all metadata groups, optionally hydrated.
+
+## 3.10.0-beta.0
+
+### Minor Changes
+
+- 572fb97: Add support for metadata groups (like authors).
+
 ## 3.9.0
 
 ### Minor Changes

packages/core/package.json

@@ -2,7 +2,7 @@
   "name": "@pantheon-systems/pcc-sdk-core",
   "author": "@pantheon-systems",
   "description": "Pantheon Content Cloud SDK Core",
-  "version": "3.9.0",
+  "version": "3.10.0-beta.2",
   "license": "MIT",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",

packages/core/src/core/pantheon-api.ts

@@ -1,7 +1,7 @@
 import queryString from "query-string";
 import { getArticleBySlugOrId, PCCConvenienceFunctions } from "../helpers";
 import { parseJwt } from "../lib/jwt";
-import { Article, SmartComponentMap } from "../types";
+import { Article, MetadataGroup, SmartComponentMap } from "../types";
 import { PantheonClient, PantheonClientConfig } from "./pantheon-client";
 
 export interface ApiRequest {
@@ -85,6 +85,11 @@ export interface PantheonAPIOptions {
    * Map of smart component names to their schemas.
    */
   smartComponentMap?: SmartComponentMap;
+
+  /**
+   * Metadata groups, schemas, and how to retrieve their data.
+   */
+  metadataGroups?: MetadataGroup[];
 }
 
 const defaultOptions = {
@@ -238,6 +243,53 @@ export const PantheonAPI = (givenOptions?: PantheonAPIOptions) => {
         return await res.redirect(302, options.notFoundPath);
       }
 
+      case "metadata_group": {
+        const groupIdentifier = command[1];
+        const objectId = command[2];
+
+        if (options.metadataGroups == null) {
+          return res.json({
+            error: "This collection has no metadata groups defined.",
+          });
+        }
+
+        if (groupIdentifier == null) {
+          return res.json({
+            rows: await Promise.all(
+              options.metadataGroups.map(
+                async ({ label, groupIdentifier, schema, list }) => ({
+                  label,
+                  groupIdentifier,
+                  schema,
+                  values:
+                    restOfQuery.hydrate === "true" ? await list() : undefined,
+                }),
+              ),
+            ),
+          });
+        }
+
+        const group = await options.metadataGroups.find(
+          (x) => x.groupIdentifier === groupIdentifier,
+        );
+
+        if (!group) {
+          return res.json({
+            error: "Could not find matching group by given identifier.",
+          });
+        }
+
+        if (!objectId) {
+          return res.json({
+            rows: await group.list(),
+          });
+        }
+
+        return res.json({
+          row: await group.get(objectId),
+        });
+      }
+
       default: {
         return await res.redirect(302, options.notFoundPath);
       }

packages/core/src/types/index.ts

@@ -108,11 +108,37 @@ export interface PantheonTreeNode<T extends "component" | string = string> {
   id?: string;
   type?: string;
 }
+
 export interface PantheonTree {
   version: string;
   children: PantheonTreeNode[];
 }
 
+interface MetadataGroupRowEssentials {
+  label: string;
+}
+
+export interface MetadataGroup {
+  label: string;
+  groupIdentifier: string;
+  schema?: Record<
+    string,
+    "string" | "textarea" | "number" | "boolean" | "date" | "file"
+  >;
+  get: (
+    id: string,
+  ) =>
+    | Promise<(unknown & MetadataGroupRowEssentials) | null | undefined>
+    | (unknown & MetadataGroupRowEssentials)
+    | null
+    | undefined;
+  list: () =>
+    | Promise<(unknown & MetadataGroupRowEssentials)[] | null | undefined>
+    | (unknown & MetadataGroupRowEssentials)[]
+    | null
+    | undefined;
+}
+
 const fieldTypes = z.enum([
   "string",
   "textarea",

packages/react-sample-library/CHANGELOG.md

@@ -1,5 +1,31 @@
 # @pantheon-systems/pcc-vue-sdk
 
+## 3.10.0-beta.2
+
+### Patch Changes
+
+- 67bc79b: Use 'label' for metadata group record identifiers instead of 'name'
+- Updated dependencies [67bc79b]
+- Updated dependencies [b89c5ee]
+  - @pantheon-systems/[email protected]
+  - @pantheon-systems/[email protected]
+
+## 3.10.0-beta.1
+
+### Patch Changes
+
+- Updated dependencies [400fc48]
+  - @pantheon-systems/[email protected]
+  - @pantheon-systems/[email protected]
+
+## 3.10.0-beta.0
+
+### Patch Changes
+
+- Updated dependencies [572fb97]
+  - @pantheon-systems/[email protected]
+  - @pantheon-systems/[email protected]
+
 ## 3.9.0
 
 ### Patch Changes

packages/react-sample-library/package.json

@@ -2,7 +2,7 @@
   "name": "@pantheon-systems/pcc-react-sample-library",
   "author": "@pantheon-systems",
   "description": "Pantheon Content Cloud Sample Component Library for React",
-  "version": "3.9.0",
+  "version": "3.10.0-beta.2",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",

packages/react-sdk/CHANGELOG.md

@@ -1,5 +1,32 @@
 # @pantheon-systems/pcc-react-sdk
 
+## 3.10.0-beta.2
+
+### Minor Changes
+
+- b89c5ee: The injected preview bar is deprecated in favor of the integrated
+  preview bar in the dashboard preview interface
+
+### Patch Changes
+
+- 67bc79b: Use 'label' for metadata group record identifiers instead of 'name'
+- Updated dependencies [67bc79b]
+  - @pantheon-systems/[email protected]
+
+## 3.10.0-beta.1
+
+### Patch Changes
+
+- Updated dependencies [400fc48]
+  - @pantheon-systems/[email protected]
+
+## 3.10.0-beta.0
+
+### Patch Changes
+
+- Updated dependencies [572fb97]
+  - @pantheon-systems/[email protected]
+
 ## 3.9.0
 
 ### Minor Changes

packages/react-sdk/package.json

@@ -2,7 +2,7 @@
   "name": "@pantheon-systems/pcc-react-sdk",
   "author": "@pantheon-systems",
   "description": "Pantheon Content Cloud React SDK",
-  "version": "3.9.0",
+  "version": "3.10.0-beta.2",
   "license": "MIT",
   "keywords": [
     "pcc",

starters/gatsby-starter-ts/package.json

@@ -15,7 +15,7 @@
   },
   "dependencies": {
     "@mdx-js/react": "2.3.0",
-    "@pantheon-systems/pcc-react-sdk": "~3.9.0",
+    "@pantheon-systems/pcc-react-sdk": "~3.10.0-beta.2",
     "@pantheon-systems/pds-toolkit-react": "1.0.0-dev.55",
     "autoprefixer": "^10.4.17",
     "gatsby": "5.13.5",

starters/gatsby-starter/package.json

@@ -15,7 +15,7 @@
   },
   "dependencies": {
     "@mdx-js/react": "2.3.0",
-    "@pantheon-systems/pcc-react-sdk": "3.9.0",
+    "@pantheon-systems/pcc-react-sdk": "3.10.0-beta.2",
     "@pantheon-systems/pds-toolkit-react": "1.0.0-dev.55",
     "autoprefixer": "^10.4.17",
     "gatsby": "5.13.5",