Add support for organizations, release v1.10.0

CHANGELOG.md

@@ -1,5 +1,8 @@
 # @stackblitz/sdk changelog
 
+## v1.10.0 (2024-05-03)
+- Added support for `organization` in `ProjectOptions`
+
 ## v1.9.0 (2023-04-04)
 
 - Moved the StackBlitz SDK to a dedicated repository: https://github.com/stackblitz/sdk.

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackblitz/sdk",
-  "version": "1.9.0",
+  "version": "1.10.0",
   "description": "SDK for generating and embedding StackBlitz projects.",
   "license": "MIT",
   "author": "Eric Simons",

src/interfaces.ts

@@ -109,6 +109,15 @@ export interface ProjectOptions {
    * Defaults to `https://stackblitz.com`.
    */
   origin?: string;
+  /**
+   * Set the organization where you want to run the project.
+   *
+   * Defaults to no organization.
+   */
+  organization?: {
+    provider: 'github';
+    name: string;
+  }
   /**
    * Show the sidebar as open or closed on page load.
    *
@@ -121,7 +130,7 @@ export interface ProjectOptions {
    * Choose the sidebar view to open on project load.
    *
    * Available views: `project` (default), `search`, `ports` (WebContainers only) and `settings`.
-   * 
+   *
    * @since 1.9.0
    */
   sidebarView?: UiSidebarView;
@@ -140,7 +149,7 @@ export interface ProjectOptions {
    *     startScript: 'build,serve'
    *
    * Defaults to looking for a `dev` script or a `start` script. Ignored in EngineBlock projects.
-   * 
+   *
    * @since 1.9.0
    */
   startScript?: string;
@@ -177,7 +186,7 @@ export interface OpenOptions extends ProjectOptions {
    * Opens the project with the editor UI partially hidden (known as “zen mode”).
    *
    * Defaults to `false`.
-   * 
+   *
    * @since 1.9.0
    */
   zenMode?: boolean;

src/params.ts

@@ -36,7 +36,9 @@ type ParamName =
   | 'terminalHeight'
   | 'theme'
   | 'view'
-  | 'zenMode';
+  | 'zenMode'
+  | 'orgName'
+  | 'orgProvider';
 
 export const generators: Record<keyof ParamOptions, (value: any) => string> = {
   clickToLoad: (value: ParamOptions['clickToLoad']) => trueParam('ctl', value),
@@ -54,6 +56,7 @@ export const generators: Record<keyof ParamOptions, (value: any) => string> = {
   theme: (value: ParamOptions['theme']) => enumParam('theme', value, UI_THEMES),
   view: (value: ParamOptions['view']) => enumParam('view', value, UI_VIEWS),
   zenMode: (value: ParamOptions['zenMode']) => trueParam('zenMode', value),
+  organization: (value: ParamOptions['organization']) => `${stringParams('orgName', value?.name)}&${stringParams('orgProvider', value?.provider)}`,
 };
 
 export function buildParams(options: ParamOptions = {}): string {

test/unit/params.spec.ts

@@ -84,6 +84,7 @@ describe('buildParams', () => {
       hideExplorer: false,
       hideNavigation: false,
       openFile: '',
+      organization: undefined,
       showSidebar: undefined,
       sidebarView: 'default',
       startScript: undefined,
@@ -107,6 +108,7 @@ describe('buildParams', () => {
       hideExplorer: true,
       hideNavigation: true,
       openFile: ['src/index.js,src/styles.css', 'package.json'],
+      organization: {name: 'stackblitz', provider: 'github'},
       showSidebar: true,
       sidebarView: 'search',
       startScript: 'dev:serve',
@@ -129,6 +131,8 @@ describe('buildParams', () => {
         'hideNavigation=1',
         'file=src%2Findex.js%2Csrc%2Fstyles.css',
         'file=package.json',
+        'orgName=stackblitz',
+        'orgProvider=github',
         'showSidebar=1',
         'sidebarView=search',
         'startScript=dev%3Aserve',