@puzzmo/cli 1.0.51 → 1.0.52

package/src/queries/gameRuntimes.ts

@@ -0,0 +1,64 @@
+import { graphql, query } from "../util/belay.js"
+import type { cliGameRuntimesQuery } from "./__generated__/cliGameRuntimesQuery.graphql.js"
+
+const gameRuntimesQuery = graphql`
+  query cliGameRuntimesQuery($token: String!) {
+    teamForToken(token: $token) {
+      slug
+      games(first: 500) {
+        edges {
+          node {
+            slug
+            runtime {
+              currentVersion {
+                assetsSha
+              }
+              nextVersion {
+                assetsSha
+              }
+              previousVersion {
+                assetsSha
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+`
+
+/** The deployed runtime build SHAs for a game, read from its runtime's current/next/previous version slots. */
+export type GameVersions = {
+  /** SHA of the live/current runtime build */
+  current: string | null
+  /** SHA of the staged "next" runtime build, if one exists */
+  next: string | null
+  /** SHA of the previous runtime build, if one exists */
+  previous: string | null
+}
+
+/**
+ * Fetches the runtime build SHAs for every game in the token's team, keyed by game slug. The token is sent both as
+ * the `teamForToken` argument and as the Bearer header — the latter is what unlocks the team-gated `runtime` field.
+ */
+export const fetchTeamGameVersions = async (apiURL: string, token: string): Promise<Map<string, GameVersions>> => {
+  const { data, errors } = await query<cliGameRuntimesQuery>(gameRuntimesQuery, {
+    variables: { token },
+    url: `${apiURL}/graphql`,
+    headers: { Authorization: `Bearer ${token}` },
+  })
+
+  if (errors?.length) throw new Error(`teamForToken failed: ${errors.map((e) => e.message).join("; ")}`)
+
+  const versions = new Map<string, GameVersions>()
+  for (const edge of data?.teamForToken?.games?.edges ?? []) {
+    const game = edge?.node
+    if (!game) continue
+    versions.set(game.slug, {
+      current: game.runtime?.currentVersion?.assetsSha || null,
+      next: game.runtime?.nextVersion?.assetsSha || null,
+      previous: game.runtime?.previousVersion?.assetsSha || null,
+    })
+  }
+  return versions
+}

package/src/util/belay.ts

@@ -0,0 +1,56 @@
+// "belay lite" — a local copy of the parts of @puzzmo-com/belay the CLI needs.
+// The CLI is published to npm and ships unbundled, so it can't depend on the private,
+// source-only belay package; this vendors the tiny query/graphql helpers instead.
+// The `graphql` tag lets the Relay compiler validate these queries and generate types
+// (see the "cli" project in relay.config.json). Keep this in sync with packages/belay.
+
+/** Standard GraphQL error shape */
+export type GraphQLError = {
+  message: string
+  locations?: Array<{ line: number; column: number }>
+  path?: Array<string | number>
+  extensions?: Record<string, unknown>
+}
+
+/** GraphQL response shape */
+export type GraphQLResponse<TData> = {
+  data?: TData
+  errors?: GraphQLError[]
+}
+
+/** Operation type with variables and response — matches Relay's generated operation types */
+export type OperationType = {
+  variables: Record<string, unknown>
+  response: unknown
+}
+
+/** Request options for the query function */
+export type RequestOptions<TVariables> = {
+  variables: TVariables
+  url: string
+  headers?: HeadersInit
+  signal?: AbortSignal
+}
+
+/**
+ * A graphql tagged template literal that returns the query string. This lets the Relay
+ * compiler pick up and validate the operation (and generate its types) without bundling relay-runtime.
+ */
+export const graphql = (strings: TemplateStringsArray): string => strings[0]!
+
+/** Execute a GraphQL query via fetch, typed with a Relay-generated operation type. */
+export const query = async <T extends OperationType>(
+  queryString: string,
+  options: RequestOptions<T["variables"]>,
+): Promise<GraphQLResponse<T["response"]>> => {
+  const { variables, url, headers, signal } = options
+
+  const response = await fetch(url, {
+    method: "POST",
+    headers: { "Content-Type": "application/json", ...headers },
+    signal,
+    body: JSON.stringify({ query: queryString, variables }),
+  })
+
+  return response.json() as Promise<GraphQLResponse<T["response"]>>
+}

package/src/util/discoverGames.ts

@@ -20,7 +20,10 @@ export type DiscoveredGame = {
   puzzmoJsonDir: string
   /** Validated puzzmo.json contents */
   puzzmoFile: PuzzmoFile
-  /** Absolute path to the dist directory containing the build artifacts */
+  /**
+   * Absolute path to the dist directory containing the build artifacts (empty string when discovered with requireDist: false and none was
+   * found)
+   */
   distDir: string
 }
 
@@ -37,8 +40,15 @@ export type DiscoveryResult = {
   errors: DiscoveryError[]
 }
 
+/** Options for {@link discoverGames} */
+export type DiscoverOptions = {
+  /** Require each game to have a non-empty dist folder (default true). Set false for commands that run before a build. */
+  requireDist?: boolean
+}
+
 /** Walks `rootDir` looking for puzzmo.json files, validates each, and resolves their dist directory */
-export const discoverGames = async (rootDir: string): Promise<DiscoveryResult> => {
+export const discoverGames = async (rootDir: string, options: DiscoverOptions = {}): Promise<DiscoveryResult> => {
+  const { requireDist = true } = options
   const root = path.resolve(rootDir)
   const puzzmoJsonPaths = findPuzzmoJsonFiles(root)
 
@@ -66,18 +76,20 @@ export const discoverGames = async (rootDir: string): Promise<DiscoveryResult> =
     const puzzmoJsonDir = path.dirname(puzzmoJsonPath)
     const distDir = resolveDistDir(puzzmoFile, puzzmoJsonDir, root)
 
-    if (!distDir) {
-      fileErrors.push(`Could not find a dist/build folder for ${puzzmoFile.game.slug}. Set "output.dir" in puzzmo.json.`)
-    } else if (!hasFiles(distDir)) {
-      fileErrors.push(`Dist folder is empty: ${distDir}`)
-    }
+    if (requireDist) {
+      if (!distDir) {
+        fileErrors.push(`Could not find a dist/build folder for ${puzzmoFile.game.slug}. Set "output.dir" in puzzmo.json.`)
+      } else if (!hasFiles(distDir)) {
+        fileErrors.push(`Dist folder is empty: ${distDir}`)
+      }
 
-    if (fileErrors.length) {
-      errors.push({ puzzmoJsonPath, slug: puzzmoFile.game.slug, errors: fileErrors })
-      continue
+      if (fileErrors.length) {
+        errors.push({ puzzmoJsonPath, slug: puzzmoFile.game.slug, errors: fileErrors })
+        continue
+      }
     }
 
-    games.push({ puzzmoJsonPath, puzzmoJsonDir, puzzmoFile, distDir: distDir as string })
+    games.push({ puzzmoJsonPath, puzzmoJsonDir, puzzmoFile, distDir: distDir ?? "" })
   }
 
   return { games, errors }

package/templates/minesweeper/README.md

@@ -15,5 +15,5 @@ Edit puzzles in `fixtures/puzzles/`. Game logic is in `src/main.ts`.
 ## Deployment
 
 ```
-yarn puzzmo upload
+yarn puzzmo games upload
 ```