@superblocksteam/util 1.9.3 → 1.11.0

package/.prettierrc

@@ -0,0 +1,17 @@
+{
+  "printWidth": 80,
+  "tabWidth": 2,
+  "useTabs": false,
+  "semi": true,
+  "singleQuote": false,
+  "trailingComma": "all",
+  "arrowParens": "always",
+  "overrides": [
+    {
+      "files": ["*.ts", "*.tsx", "*.mts"],
+      "options": {
+        "parser": "typescript"
+      }
+    }
+  ]
+}

package/LICENSE.txt

@@ -0,0 +1,87 @@
+Superblocks Community Software License
+
+This Superblocks Community License Agreement (the “Agreement”) sets forth the terms on which DayZero
+Software, Inc. d/b/a Superblocks (“Superblocks”) makes available certain software made available by Superblocks
+under this Agreement (the “Software”). BY INSTALLING, DOWNLOADING, ACCESSING, USING OR
+DISTRIBUTING ANY OF THE SOFTWARE, YOU AGREE TO THE TERMS AND CONDITIONS OF THIS
+AGREEMENT.IF YOU DO NOT AGREE TO SUCH TERMS AND CONDITIONS, YOU MUST NOT USE THE
+SOFTWARE. IF YOU ARE RECEIVING THE SOFTWARE ON BEHALF OF A LEGAL ENTITY, YOU
+REPRESENT AND WARRANT THAT YOU HAVE THE ACTUAL AUTHORITY TO AGREE TO THE
+TERMS AND CONDITIONS OF THIS AGREEMENT ON BEHALF OF SUCH ENTITY. “Licensee” means you,
+an individual, or the entity on whose behalf you are receiving the Software.
+
+1. LICENSE GRANT AND CONDITIONS.
+
+1.1 License. Subject to the terms and conditions of this Agreement, Superblocks hereby grants to Licensee a
+non-exclusive, royalty-free, worldwide, non-transferable, non-sublicenseable license during the term of this
+Agreement to: (a) use the Software; (b) prepare modifications and derivative works of the Software; (c)
+distribute the Software (including without limitation in source code or object code form); and (d) reproduce
+copies of the Software (the “License”). Licensee is not granted the right to, and Licensee shall not, exercise the
+License for an Excluded Purpose. For purposes of this Agreement, “Excluded Purpose” means making
+available any software-as-a-service, platform-as-a-service, infrastructure-as-a-service or other similar online
+service that competes with Superblocks’ products or services.
+
+1.2 Conditions. In consideration of the License, Licensee’s distribution of the Software is subject to the
+following conditions:
+
+  a. Licensee must cause any Software modified by Licensee to carry prominent notices stating that Licensee
+  modified the Software.
+  b. On each Software copy, Licensee shall reproduce and not remove or alter all Superblocks or third party
+  copyright or other proprietary notices contained in the Software, and Licensee must provide the notice
+  below with each copy.
+
+  “This software is made available by DayZero Software, Inc. d/b/a Superblocks, under the terms of the
+  Superblocks Community License Agreement. © 2022 DayZero Software, Inc.”
+
+1.3 Licensee Modifications. Licensee may add its own copyright notices to modifications made by Licensee
+and may provide additional or different license terms and conditions for use, reproduction, or distribution of
+Licensee’s modifications. While redistributing the Software or modifications thereof, Licensee may choose to
+offer, for a fee or free of charge, support, warranty, indemnity, or other obligations. Licensee, and not
+Superblocks, will be responsible for any such obligations.
+
+1.4 No Sublicensing. The License does not include the right to sublicense the Software, however, each recipient
+to which Licensee provides the Software may exercise the Licenses so long as such recipient agrees to the terms
+and conditions of this Agreement.
+
+2. TERM AND TERMINATION. This Agreement will continue unless and until earlier terminated as set forth
+herein. If Licensee breaches any of its conditions or obligations under this Agreement, this Agreement will
+terminate automatically and the License will terminate automatically and permanently.
+
+3. INTELLECTUAL PROPERTY. As between the parties, Superblocks will retain all right, title, and interest in
+the Software, and all intellectual property rights therein. Superblocks hereby reserves all rights not expressly
+granted to Licensee in this Agreement. Superblocks hereby reserves all rights in its trademarks and service
+marks, and no licenses therein are granted in this Agreement.
+
+4. DISCLAIMER. SUPERBLOCKS HEREBY DISCLAIMS ANY AND ALL WARRANTIES AND
+CONDITIONS, EXPRESS, IMPLIED, STATUTORY, OR OTHERWISE, AND SPECIFICALLY
+DISCLAIMS ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+PURPOSE, WITH RESPECT TO THE SOFTWARE.
+
+5. LIMITATION OF LIABILITY. SUPERBLOCKS WILL NOT BE LIABLE FOR ANY DAMAGES OF
+ANY KIND, INCLUDING BUT NOT LIMITED TO, LOST PROFITS OR ANY CONSEQUENTIAL,
+SPECIAL, INCIDENTAL, INDIRECT, OR DIRECT DAMAGES, HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, ARISING OUT OF THIS AGREEMENT. THE FOREGOING SHALL APPLY TO
+THE EXTENT PERMITTED BY APPLICABLE LAW.
+
+6. GENERAL.
+
+6.1  Governing Law. This Agreement will be governed by and interpreted in accordance with the laws of the
+state of California, without reference to its conflict of laws principles. If Licensee is located within the United
+States, all disputes arising out of this Agreement are subject to the exclusive jurisdiction of courts located in San
+Mateo County, California. USA. If Licensee is located outside of the United States, any dispute, controversy or
+claim arising out of or relating to this Agreement will be referred to and finally determined by arbitration in
+accordance with the JAMS International Arbitration Rules. The tribunal will consist of one neutral arbitrator.
+The place of arbitration will be Palo Alto, California. The language to be used in the arbitral proceedings will be
+English. Judgment upon the award rendered by the arbitrator may be entered in any court having jurisdiction
+thereof.
+
+6.2.  Assignment. Licensee may not assign its rights under this Agreement to any third party. Superblocks may
+freely assign its rights under this Agreement to any third party.
+
+6.3.  Other.  This Agreement is the entire agreement between the parties regarding the subject matter hereof.
+No amendment or modification of this Agreement will be valid or binding upon the parties unless made in
+writing and signed by the duly authorized representatives of both parties. In the event that any provision,
+including without limitation any condition, of this Agreement is held to be unenforceable, this Agreement and
+all licenses and rights granted hereunder will immediately terminate. Waiver by Superblocks of a breach of any
+provision of this Agreement or the failure by Superblocks to exercise any right hereunder will not be construed
+as a waiver of any subsequent breach of that right or as a waiver of any other right.

package/dist/component-configs.js

@@ -1,8 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getContentType = exports.getComponentConfigs = void 0;
+exports.getContentType = void 0;
+exports.getComponentConfigs = getComponentConfigs;
 const tslib_1 = require("tslib");
-const child_process_1 = require("child_process");
+const node_child_process_1 = require("node:child_process");
 const node_os_1 = tslib_1.__importDefault(require("node:os"));
 const node_path_1 = tslib_1.__importDefault(require("node:path"));
 const fs = tslib_1.__importStar(require("fs-extra"));
@@ -15,7 +16,7 @@ const compileTypeScript = (inputFilePath, outputDir) => {
         try {
             const tscPath = require.resolve("typescript/bin/tsc");
             if (tscPath) {
-                (0, child_process_1.execFile)("node", [
+                (0, node_child_process_1.execFile)("node", [
                     tscPath,
                     node_path_1.default.resolve(inputFilePath),
                     "--outDir",
@@ -49,7 +50,7 @@ const compileTypeScript = (inputFilePath, outputDir) => {
                 });
             }
         }
-        catch (e) {
+        catch {
             reject(new Error("Could not find TypeScript, please install it globally (npm install -g typescript)"));
         }
     });
@@ -83,7 +84,7 @@ async function getComponentConfigs(generateTypesFiles) {
             console.log(`Found component in ${absPath}`);
             return { ccpath, config };
         }
-        catch (e) {
+        catch {
             // Noop because there is a fallback
         }
         try {
@@ -135,7 +136,6 @@ async function getComponentConfigs(generateTypesFiles) {
         hasError,
     };
 }
-exports.getComponentConfigs = getComponentConfigs;
 const getContentType = (filename) => {
     const mimeType = mimeTypes.lookup(filename);
     if (!mimeType) {

package/dist/data-types.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isValidDataType = exports.dataTypeDefinions = exports.supportedDataTypes = void 0;
+exports.dataTypeDefinions = exports.supportedDataTypes = void 0;
+exports.isValidDataType = isValidDataType;
 exports.supportedDataTypes = [
     "string",
     "number",
@@ -28,4 +29,3 @@ exports.dataTypeDefinions = {
 function isValidDataType(input) {
     return Object.prototype.hasOwnProperty.call(exports.dataTypeDefinions, input);
 }
-exports.isValidDataType = isValidDataType;

package/dist/generate-component-types.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateComponentTypesFile = void 0;
+exports.generateComponentTypesFile = generateComponentTypesFile;
 const data_types_1 = require("./data-types");
 const indent = (str, spaces) => {
     const spacesString = " ".repeat(spaces);
@@ -43,4 +43,3 @@ ${eventHandlers.length === 0
             .join("")}};
 `;
 }
-exports.generateComponentTypesFile = generateComponentTypesFile;

package/dist/identifiers.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isReservedPropertyName = exports.isValidIdentifier = exports.suggestIdentifier = void 0;
+exports.suggestIdentifier = suggestIdentifier;
+exports.isValidIdentifier = isValidIdentifier;
+exports.isReservedPropertyName = isReservedPropertyName;
 // convert a string to upper camel case, e.g. "123 & this is my component, foo-bar" -> "123ThisIsMyComponentFooBar"
 function wordsToUpperCamelCase(str) {
     return str
@@ -30,12 +32,10 @@ function suggestIdentifier(label, capitalizeFirst = false) {
         return upperCamelCase[0].toLowerCase() + upperCamelCase.slice(1);
     }
 }
-exports.suggestIdentifier = suggestIdentifier;
 const IdentifierRegex = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
 function isValidIdentifier(str) {
     return IdentifierRegex.test(str);
 }
-exports.isValidIdentifier = isValidIdentifier;
 const reservedPropertyNames = new Set([
     "ENTITY_TYPE",
     "bindingPaths",
@@ -65,4 +65,3 @@ function isReservedPropertyName(str) {
         // also treat any property name starting with "default_" as reserved since we use this prefix for default properties
         str.startsWith("default_"));
 }
-exports.isReservedPropertyName = isReservedPropertyName;

package/dist/login.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getLocalTokenWithUrl = exports.getLocalTokenWithUrlIfExists = exports.saveApiToken = void 0;
+exports.saveApiToken = saveApiToken;
+exports.getLocalTokenWithUrlIfExists = getLocalTokenWithUrlIfExists;
+exports.getLocalTokenWithUrl = getLocalTokenWithUrl;
 const tslib_1 = require("tslib");
 const node_os_1 = require("node:os");
 const node_path_1 = require("node:path");
@@ -27,7 +29,6 @@ async function saveApiToken(superblocksBaseUrl, token) {
         throw new constants_1.FileAccessError("Could not save token");
     }
 }
-exports.saveApiToken = saveApiToken;
 async function getLocalTokenWithUrlIfExists() {
     try {
         return await getLocalTokenWithUrl();
@@ -36,10 +37,9 @@ async function getLocalTokenWithUrlIfExists() {
         return undefined;
     }
 }
-exports.getLocalTokenWithUrlIfExists = getLocalTokenWithUrlIfExists;
 async function getLocalTokenWithUrl() {
     try {
-        const tokenConfig = await fs.readJSON((0, node_path_1.join)((0, node_os_1.homedir)(), constants_1.TOKEN_CONFIG_PATH));
+        const tokenConfig = await fs.readJSON(process.env.SUPERBLOCKS_AUTH_FILE || (0, node_path_1.join)((0, node_os_1.homedir)(), constants_1.TOKEN_CONFIG_PATH));
         if (tokenConfig.token) {
             // user logged in
             return {
@@ -58,4 +58,3 @@ async function getLocalTokenWithUrl() {
         throw new Error("No local API key found");
     }
 }
-exports.getLocalTokenWithUrl = getLocalTokenWithUrl;

package/dist/resource-configs.d.ts

@@ -6,21 +6,34 @@ export type VersionedResourceConfig = {
     location: string;
     resourceType: SuperblocksResourceType;
 };
+export type SuperblocksResourceConfigMetadata = {
+    fileVersion?: string;
+};
 export type SuperblocksResourceConfig = {
     id: string;
+    metadata?: SuperblocksResourceConfigMetadata;
 };
-export type SuperblocksBackendConfig = SuperblocksResourceConfig & {
+export type SuperblocksBackendConfig = SuperblocksResourceConfig & SourceFilesContanier & {
     configType: "BACKEND";
 };
 export type SuperblocksApplicationConfig = SuperblocksResourceConfig & {
     configType: "APPLICATION";
     defaultPageId?: string;
-    apis: Record<string, string>;
-    pages?: Record<string, {
-        id: string;
-        name: string;
-        apis: Record<string, string>;
-    }>;
+    apis?: Record<string, string>;
+    appApis?: Record<string, ApiInfo>;
+    pages?: Record<string, PageInfo>;
+};
+export type PageInfo = {
+    id: string;
+    name: string;
+    apis?: Record<string, string>;
+    pageApis?: Record<string, ApiInfo>;
+};
+export type SourceFilesContanier = {
+    sourceFiles?: string[];
+};
+export type ApiInfo = SourceFilesContanier & {
+    name: string;
 };
 export type SuperblocksMonorepoConfig = {
     configType: "ROOT";
@@ -35,5 +48,6 @@ export type SuperblocksConfig = SuperblocksMonorepoConfig | SuperblocksApplicati
 export declare function getSuperblocksMonorepoConfigJson(checkParentDir?: boolean, pathPrefix?: string): Promise<[SuperblocksMonorepoConfig, string]>;
 export declare function getSuperblocksApplicationConfigJson(applicationPath?: string): Promise<SuperblocksApplicationConfig>;
 export declare function getSuperblocksApplicationConfigIfExists(applicationPath: string): Promise<SuperblocksApplicationConfig | undefined>;
+export declare function getSuperblocksBackendConfigIfExists(backendPath: string): Promise<SuperblocksBackendConfig | undefined>;
 export declare function getSuperblocksBackendConfigJson(): Promise<SuperblocksBackendConfig>;
 export declare function getSuperblocksResourceConfigIfExists(): Promise<SuperblocksResourceConfig | undefined>;

package/dist/resource-configs.js

@@ -1,6 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getSuperblocksResourceConfigIfExists = exports.getSuperblocksBackendConfigJson = exports.getSuperblocksApplicationConfigIfExists = exports.getSuperblocksApplicationConfigJson = exports.getSuperblocksMonorepoConfigJson = void 0;
+exports.getSuperblocksMonorepoConfigJson = getSuperblocksMonorepoConfigJson;
+exports.getSuperblocksApplicationConfigJson = getSuperblocksApplicationConfigJson;
+exports.getSuperblocksApplicationConfigIfExists = getSuperblocksApplicationConfigIfExists;
+exports.getSuperblocksBackendConfigIfExists = getSuperblocksBackendConfigIfExists;
+exports.getSuperblocksBackendConfigJson = getSuperblocksBackendConfigJson;
+exports.getSuperblocksResourceConfigIfExists = getSuperblocksResourceConfigIfExists;
 const tslib_1 = require("tslib");
 const path_1 = tslib_1.__importDefault(require("path"));
 const fs = tslib_1.__importStar(require("fs-extra"));
@@ -35,12 +40,12 @@ async function getSuperblocksMonorepoConfigJson(checkParentDir = false, pathPref
     catch {
         if (!checkParentDir) {
             // no superblocks config file found
-            throw new Error("No Superblocks config file found in current directory " + attemptedPath);
+            throw new Error("No Superblocks config file found in current directory " +
+                attemptedPath);
         }
         return getSuperblocksMonorepoConfigJson(true, "../" + pathPrefix);
     }
 }
-exports.getSuperblocksMonorepoConfigJson = getSuperblocksMonorepoConfigJson;
 async function getSuperblocksApplicationConfigJson(applicationPath) {
     let superblocksConfig;
     try {
@@ -58,7 +63,6 @@ async function getSuperblocksApplicationConfigJson(applicationPath) {
     }
     return superblocksConfig;
 }
-exports.getSuperblocksApplicationConfigJson = getSuperblocksApplicationConfigJson;
 async function getSuperblocksApplicationConfigIfExists(applicationPath) {
     let superblocksConfig;
     try {
@@ -75,7 +79,22 @@ async function getSuperblocksApplicationConfigIfExists(applicationPath) {
     }
     return superblocksConfig;
 }
-exports.getSuperblocksApplicationConfigIfExists = getSuperblocksApplicationConfigIfExists;
+async function getSuperblocksBackendConfigIfExists(backendPath) {
+    let superblocksConfig;
+    try {
+        const configPath = backendPath
+            ? path_1.default.join(backendPath, constants_1.RESOURCE_CONFIG_PATH)
+            : constants_1.RESOURCE_CONFIG_PATH;
+        superblocksConfig = await fs.readJSON(configPath);
+    }
+    catch {
+        // no superblocks config file found
+    }
+    if ((superblocksConfig === null || superblocksConfig === void 0 ? void 0 : superblocksConfig.configType) !== "BACKEND") {
+        return undefined;
+    }
+    return superblocksConfig;
+}
 async function getSuperblocksBackendConfigJson() {
     let superblocksConfig;
     try {
@@ -90,7 +109,6 @@ async function getSuperblocksBackendConfigJson() {
     }
     return superblocksConfig;
 }
-exports.getSuperblocksBackendConfigJson = getSuperblocksBackendConfigJson;
 async function getSuperblocksResourceConfigIfExists() {
     let config;
     try {
@@ -107,4 +125,3 @@ async function getSuperblocksResourceConfigIfExists() {
     }
     return config;
 }
-exports.getSuperblocksResourceConfigIfExists = getSuperblocksResourceConfigIfExists;

package/dist/types.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="node" />
 import { type UUID } from "node:crypto";
 import { type DataType } from "./data-types";
 interface PropertiesPanelDisplay<T extends DataType> {

package/dist/unreachable.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.unreachable = void 0;
+exports.unreachable = unreachable;
 function unreachable(value) {
     throw new TypeError("Encountered impossible value: " + JSON.stringify(value));
 }
-exports.unreachable = unreachable;

package/dist/validation.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateCustomComponents = void 0;
+exports.validateCustomComponents = validateCustomComponents;
 const tslib_1 = require("tslib");
 const ajv_1 = tslib_1.__importDefault(require("ajv"));
 const better_ajv_errors_1 = tslib_1.__importDefault(require("better-ajv-errors"));
@@ -147,4 +147,3 @@ function validateCustomComponents(data) {
     }
     return { valid: true };
 }
-exports.validateCustomComponents = validateCustomComponents;

package/eslint.config.js

@@ -0,0 +1,73 @@
+const js = require("@eslint/js");
+const importPlugin = require("eslint-plugin-import");
+const prettier = require("eslint-plugin-prettier");
+const eslintPluginPrettierRecommended = require("eslint-plugin-prettier/recommended");
+const unicorn = require("eslint-plugin-unicorn");
+const globals = require("globals");
+const tseslint = require("typescript-eslint");
+
+const config = [
+  {
+    ignores: [
+      "**/public/*",
+      "**/build/*",
+      "**/node_modules/*",
+      "**/dist/*",
+      "**/assets/",
+      "**/.*",
+      "eslint.config.js",
+      "tsup.config.ts",
+    ],
+  },
+  js.configs.recommended,
+  ...tseslint.configs.recommended,
+  eslintPluginPrettierRecommended,
+  {
+    plugins: {
+      "@typescript-eslint": tseslint.plugin,
+      prettier,
+      import: importPlugin,
+      unicorn,
+    },
+    languageOptions: {
+      ecmaVersion: 2020,
+      sourceType: "commonjs",
+      globals: globals.node,
+    },
+    rules: {
+      "@typescript-eslint/explicit-module-boundary-types": "off",
+      "@typescript-eslint/no-explicit-any": "off",
+      "@typescript-eslint/no-unused-vars": "error",
+      "@typescript-eslint/no-var-requires": "off",
+      "unicorn/no-nested-ternary": "off",
+      "import/order": [
+        "error",
+        {
+          alphabetize: { order: "asc" },
+          groups: [
+            "builtin",
+            "external",
+            "internal",
+            "parent",
+            "sibling",
+            "index",
+            "object",
+            "type",
+          ],
+        },
+      ],
+      "import/no-cycle": "error",
+      "no-template-curly-in-string": "off",
+      "no-useless-escape": "off",
+      "no-void": ["error", { allowAsStatement: true }],
+    },
+  },
+  {
+    files: ["**/*.test.ts", "test/**/*.js", "test/helpers/init.js"],
+    rules: {
+      "@typescript-eslint/no-unused-expressions": "off",
+    },
+  },
+];
+
+module.exports = config;

package/package.json

@@ -1,31 +1,38 @@
 {
   "name": "@superblocksteam/util",
-  "version": "1.9.3",
+  "version": "1.11.0",
   "main": "dist/index.js",
   "homepage": "https://www.superblocks.com",
-  "scripts": {
-    "dev": "tsc --watch",
-    "build": "tsc --build",
-    "clean": "npm run clean:build && rm -rf node_modules",
-    "clean:build": "tsc --build --clean && rm -rf dist tsconfig.tsbuildinfo",
-    "lint": "eslint . --ext .ts --config .eslintrc.json",
-    "lint:fix": "eslint . --ext .ts --config .eslintrc.json --fix",
-    "typecheck": "tsc --noEmit"
-  },
   "license": "Superblocks Community Software License",
   "description": "",
   "dependencies": {
     "ajv": "^8.12.0",
     "better-ajv-errors": "^1.2.0",
+    "fs-extra": "^11.1.1",
+    "lodash": "^4.17.21",
     "mime-types": "^2.1.35"
   },
   "devDependencies": {
+    "@types/fs-extra": "^11.0.1",
+    "@types/lodash": "^4.17.7",
     "@types/mime-types": "^2.1.1",
-    "@typescript-eslint/eslint-plugin": "^5.60.1",
-    "@typescript-eslint/parser": "^5.60.1",
-    "eslint": "^8.48.0",
+    "@types/node": "^20.11.18",
+    "@typescript-eslint/eslint-plugin": "^8.25.0",
+    "@typescript-eslint/parser": "^8.25.0",
+    "eslint": "^9.21.0",
     "eslint-plugin-unicorn": "^47.0.0",
-    "prettier": "^2.8.8",
+    "prettier": "^3.5.2",
+    "tslib": "^2.5.0",
     "typescript": "^5.1.3"
+  },
+  "scripts": {
+    "dev": "tsc --watch",
+    "build": "tsc --build",
+    "clean": "npm run clean:build && rm -rf node_modules",
+    "clean:build": "tsc --build --clean && rm -rf dist tsconfig.tsbuildinfo",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "typecheck": "tsc --noEmit",
+    "check": "pnpm run lint && pnpm run typecheck"
   }
-}
+}

package/src/component-configs.ts

@@ -1,4 +1,4 @@
-import { execFile } from "child_process";
+import { execFile } from "node:child_process";
 import os from "node:os";
 import path from "node:path";
 import * as fs from "fs-extra";
@@ -46,14 +46,14 @@ const compileTypeScript = (inputFilePath: string, outputDir: string) => {
               return;
             }
             resolve("Compilation successful!");
-          }
+          },
         );
       }
-    } catch (e) {
+    } catch {
       reject(
         new Error(
-          "Could not find TypeScript, please install it globally (npm install -g typescript)"
-        )
+          "Could not find TypeScript, please install it globally (npm install -g typescript)",
+        ),
       );
     }
   });
@@ -71,22 +71,22 @@ async function getFolderPaths() {
         (dirent.isSymbolicLink() &&
           fs
             .statSync(path.join(CUSTOM_COMPONENTS_PATH, dirent.name))
-            .isDirectory())
+            .isDirectory()),
     );
     // map each directory to its path
     const folderPathsArray = directories.map((dirent) =>
-      path.join(CUSTOM_COMPONENTS_PATH, dirent.name)
+      path.join(CUSTOM_COMPONENTS_PATH, dirent.name),
     );
     return folderPathsArray;
   } catch {
     throw new Error(
-      "Could not access component directory, check your permissions"
+      "Could not access component directory, check your permissions",
     );
   }
 }
 
 export async function getComponentConfigs(
-  generateTypesFiles: boolean
+  generateTypesFiles: boolean,
 ): Promise<{
   configs: Record<string, any>;
   hasError: boolean;
@@ -99,7 +99,7 @@ export async function getComponentConfigs(
       const config = await fs.readJSON(`${absPath}/config.json`);
       console.log(`Found component in ${absPath}`);
       return { ccpath, config };
-    } catch (e: any) {
+    } catch {
       // Noop because there is a fallback
     }
 
@@ -114,7 +114,7 @@ export async function getComponentConfigs(
       const outputDirectory = path.resolve(
         `${os.tmpdir()}/superblocks/${ccpath}/config.timestamp-${Date.now()}-${Math.random()
           .toString(16)
-          .slice(2)}`
+          .slice(2)}`,
       );
       await fs.ensureDir(outputDirectory);
       await compileTypeScript(fileName, outputDirectory);

package/src/data-types.ts

@@ -34,6 +34,6 @@ export const dataTypeDefinions: Record<DataType, TypeInfo> = {
 export function isValidDataType(input: string): input is DataType {
   return Object.prototype.hasOwnProperty.call(
     dataTypeDefinions,
-    input as DataType
+    input as DataType,
   );
 }

package/src/file-uploader.ts

@@ -4,7 +4,7 @@ export const COMPONENT_EVENT_HEADER = "x-superblocks-component-event";
 
 // retrieves bucketeer base URL given the superblocks server base URL
 export const getBucketeerUrlFromSuperblocksUrl = (
-  superblocksBaseUrl: string
+  superblocksBaseUrl: string,
 ): string => {
   // if superblocks base URL is an EE, return bucketeer's dev URL
   if (!isEmpty(superblocksBaseUrl.match(new RegExp("pr-.*.superblocks.dev")))) {

package/src/generate-component-types.ts

@@ -14,7 +14,7 @@ function renderInputTypeAsTS(
   name: string,
   type: DataType,
   trailingChars: string,
-  indentSpaces: number
+  indentSpaces: number,
 ) {
   let { tsType } = dataTypeDefinions[type];
   if (["number", "string"].includes(type)) {

package/src/login.ts

@@ -46,7 +46,7 @@ export async function getLocalTokenWithUrl(): Promise<
 > {
   try {
     const tokenConfig: TokenWithBaseUrl = await fs.readJSON(
-      join(homedir(), TOKEN_CONFIG_PATH)
+      process.env.SUPERBLOCKS_AUTH_FILE || join(homedir(), TOKEN_CONFIG_PATH),
     );
     if (tokenConfig.token) {
       // user logged in

package/src/resource-configs.ts

@@ -13,26 +13,43 @@ export type VersionedResourceConfig = {
   resourceType: SuperblocksResourceType;
 };
 
+export type SuperblocksResourceConfigMetadata = {
+  fileVersion?: string;
+};
+
 export type SuperblocksResourceConfig = {
   id: string;
+  metadata?: SuperblocksResourceConfigMetadata;
 };
 
-export type SuperblocksBackendConfig = SuperblocksResourceConfig & {
-  configType: "BACKEND";
-};
+export type SuperblocksBackendConfig = SuperblocksResourceConfig &
+  SourceFilesContanier & {
+    configType: "BACKEND";
+  };
 
 export type SuperblocksApplicationConfig = SuperblocksResourceConfig & {
   configType: "APPLICATION";
   defaultPageId?: string;
-  apis: Record<string, string>;
-  pages?: Record<
-    string,
-    {
-      id: string;
-      name: string;
-      apis: Record<string, string>;
-    }
-  >;
+  // @deprecated use pageApis appApis for new format
+  apis?: Record<string, string>; // used for pre-0.2.0 format
+  appApis?: Record<string, ApiInfo>; // used for 0.2.0+ format
+  pages?: Record<string, PageInfo>;
+};
+
+export type PageInfo = {
+  id: string;
+  name: string;
+  // @deprecated use pageApis instead
+  apis?: Record<string, string>; // used for pre-0.2.0 format
+  pageApis?: Record<string, ApiInfo>; // used for 0.2.0+ format
+};
+
+export type SourceFilesContanier = {
+  sourceFiles?: string[];
+};
+
+export type ApiInfo = SourceFilesContanier & {
+  name: string;
 };
 
 export type SuperblocksMonorepoConfig = {
@@ -52,7 +69,7 @@ export type SuperblocksConfig =
  */
 export async function getSuperblocksMonorepoConfigJson(
   checkParentDir = false,
-  pathPrefix = ""
+  pathPrefix = "",
 ): Promise<[SuperblocksMonorepoConfig, string]> {
   const absolutePath = path.resolve(pathPrefix);
 
@@ -70,7 +87,7 @@ export async function getSuperblocksMonorepoConfigJson(
   ) {
     throw new Error(
       "No Superblocks config file found in current directory hierarchy " +
-        pathPrefix
+        pathPrefix,
     );
   }
 
@@ -85,7 +102,8 @@ export async function getSuperblocksMonorepoConfigJson(
     if (!checkParentDir) {
       // no superblocks config file found
       throw new Error(
-        "No Superblocks config file found in current directory " + attemptedPath
+        "No Superblocks config file found in current directory " +
+          attemptedPath,
       );
     }
     return getSuperblocksMonorepoConfigJson(true, "../" + pathPrefix);
@@ -93,7 +111,7 @@ export async function getSuperblocksMonorepoConfigJson(
 }
 
 export async function getSuperblocksApplicationConfigJson(
-  applicationPath?: string
+  applicationPath?: string,
 ): Promise<SuperblocksApplicationConfig> {
   let superblocksConfig;
   try {
@@ -104,13 +122,13 @@ export async function getSuperblocksApplicationConfigJson(
   } catch {
     // no superblocks config file found
     throw new Error(
-      "This command must be run within a Superblocks app directory."
+      "This command must be run within a Superblocks app directory.",
     );
   }
 
   if (superblocksConfig.configType !== "APPLICATION") {
     throw new Error(
-      "Please execute this command within a Superblocks application directory."
+      "Please execute this command within a Superblocks application directory.",
     );
   }
 
@@ -118,7 +136,7 @@ export async function getSuperblocksApplicationConfigJson(
 }
 
 export async function getSuperblocksApplicationConfigIfExists(
-  applicationPath: string
+  applicationPath: string,
 ): Promise<SuperblocksApplicationConfig | undefined> {
   let superblocksConfig: SuperblocksApplicationConfig | undefined;
   try {
@@ -137,6 +155,26 @@ export async function getSuperblocksApplicationConfigIfExists(
   return superblocksConfig as SuperblocksApplicationConfig;
 }
 
+export async function getSuperblocksBackendConfigIfExists(
+  backendPath: string,
+): Promise<SuperblocksBackendConfig | undefined> {
+  let superblocksConfig: SuperblocksBackendConfig | undefined;
+  try {
+    const configPath = backendPath
+      ? path.join(backendPath, RESOURCE_CONFIG_PATH)
+      : RESOURCE_CONFIG_PATH;
+    superblocksConfig = await fs.readJSON(configPath);
+  } catch {
+    // no superblocks config file found
+  }
+
+  if (superblocksConfig?.configType !== "BACKEND") {
+    return undefined;
+  }
+
+  return superblocksConfig as SuperblocksBackendConfig;
+}
+
 export async function getSuperblocksBackendConfigJson(): Promise<SuperblocksBackendConfig> {
   let superblocksConfig;
   try {
@@ -144,13 +182,13 @@ export async function getSuperblocksBackendConfigJson(): Promise<SuperblocksBack
   } catch {
     // no superblocks config file found
     throw new Error(
-      "This command must be run within a Superblocks backend resource (workflow/job) directory."
+      "This command must be run within a Superblocks backend resource (workflow/job) directory.",
     );
   }
 
   if (superblocksConfig.configType !== "BACKEND") {
     throw new Error(
-      "Please execute this command within a Superblocks backend resource (workflow/job) directory."
+      "Please execute this command within a Superblocks backend resource (workflow/job) directory.",
     );
   }
 

package/src/types.ts

@@ -53,8 +53,8 @@ interface PropertiesPanelDisplay<T extends DataType> {
   defaultValue?: T extends "number"
     ? number
     : T extends "boolean"
-    ? boolean
-    : string;
+      ? boolean
+      : string;
 }
 
 export interface PropertyForData<T extends DataType> {

package/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["./src/component-configs.ts","./src/constants.ts","./src/data-types.ts","./src/events.ts","./src/file-uploader.ts","./src/generate-component-types.ts","./src/identifiers.ts","./src/index.ts","./src/localGitRepoState.ts","./src/login.ts","./src/resource-configs.ts","./src/types.ts","./src/unreachable.ts","./src/validation.ts"],"version":"5.7.3"}

package/.eslintrc.json

@@ -1,51 +0,0 @@
-{
-  "parser": "@typescript-eslint/parser",
-  "plugins": [
-    "@typescript-eslint",
-    "prettier",
-    "import",
-    "unicorn"
-  ],
-  "extends": [
-    "eslint:recommended",
-    "plugin:@typescript-eslint/recommended",
-    "plugin:prettier/recommended",
-    "prettier",
-    "plugin:import/typescript"
-  ],
-  "parserOptions": {
-    "ecmaVersion": 2020,
-    "sourceType": "module",
-    "project": true
-  },
-  "rules": {
-    "@typescript-eslint/explicit-module-boundary-types": "off",
-    "@typescript-eslint/no-explicit-any": "off",
-    "@typescript-eslint/no-unused-vars": "error",
-    "@typescript-eslint/no-var-requires": "off",
-    "@typescript-eslint/no-unsafe-return": "off",
-    "@typescript-eslint/no-unsafe-assignment": "off",
-    "@typescript-eslint/no-unsafe-member-access": "off",
-    "import/order": [
-      "error",
-      {
-        "alphabetize": { "order": "asc" },
-        "groups": [
-          "builtin",
-          "external",
-          "internal",
-          "parent",
-          "sibling",
-          "index",
-          "object",
-          "type"
-        ]
-      }
-    ],
-    "import/no-cycle": "error",
-    "no-template-curly-in-string": "off",
-    "no-useless-escape": "off",
-    "no-void": ["error", { "allowAsStatement": true }]
-  },
-  "ignorePatterns": ["public", "build", "node_modules", "dist", "tsup.config.ts"]
-}