@pwrdrvr/microapps-router-lib 0.4.0-alpha.9 → 1.0.2

package/dist/route-app.js

@@ -0,0 +1,169 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RouteApp = void 0;
+const tslib_1 = require("tslib");
+const app_cache_1 = require("./app-cache");
+const log_1 = tslib_1.__importDefault(require("./lib/log"));
+const log = log_1.default.Instance;
+/**
+ * Lookup the version of the app to run
+ * @param event
+ * @param response
+ * @param appName
+ * @param additionalParts
+ * @param log
+ * @returns
+ */
+async function RouteApp(opts) {
+    var _a;
+    const { dbManager, event, normalizedPathPrefix = '', appName, possibleSemVerPathNextData, possibleSemVerPathAfterApp, possibleSemVerQuery, additionalParts, appNameOrRootTrailingSlash, } = opts;
+    let versionInfoToUse;
+    const appVersionCache = app_cache_1.AppVersionCache.GetInstance({ dbManager });
+    // Check if the semver placeholder is actually a defined version
+    const possibleSemVerPathAfterAppVersionInfo = possibleSemVerPathAfterApp
+        ? await appVersionCache.GetVersionInfo({
+            key: { AppName: appName, SemVer: possibleSemVerPathAfterApp },
+        })
+        : undefined;
+    const possibleSemVerPathNextDataVersionInfo = possibleSemVerPathNextData
+        ? await appVersionCache.GetVersionInfo({
+            key: { AppName: appName, SemVer: possibleSemVerPathNextData },
+        })
+        : undefined;
+    const possibleSemVerQueryVersionInfo = possibleSemVerQuery
+        ? await appVersionCache.GetVersionInfo({
+            key: { AppName: appName, SemVer: possibleSemVerQuery },
+        })
+        : undefined;
+    // If there is a version in the path, use it
+    const possibleSemVerPathVersionInfo = possibleSemVerPathAfterAppVersionInfo || possibleSemVerPathNextDataVersionInfo;
+    if (possibleSemVerPathVersionInfo) {
+        //
+        // If this is an iframe app then it's a startup request
+        // If this is a direct app then it's a regular request to send to the app
+        //
+        // This is a version, and it's in the path already, route the request to it
+        // without creating iframe
+        return {
+            statusCode: 200,
+            appName,
+            semVer: possibleSemVerPathVersionInfo.SemVer,
+            isAPIPath: additionalParts.startsWith('api/'),
+            ...((possibleSemVerPathVersionInfo === null || possibleSemVerPathVersionInfo === void 0 ? void 0 : possibleSemVerPathVersionInfo.URL) ? { url: possibleSemVerPathVersionInfo === null || possibleSemVerPathVersionInfo === void 0 ? void 0 : possibleSemVerPathVersionInfo.URL } : {}),
+            ...((possibleSemVerPathVersionInfo === null || possibleSemVerPathVersionInfo === void 0 ? void 0 : possibleSemVerPathVersionInfo.Type)
+                ? {
+                    type: (possibleSemVerPathVersionInfo === null || possibleSemVerPathVersionInfo === void 0 ? void 0 : possibleSemVerPathVersionInfo.Type) === 'lambda'
+                        ? 'apigwy'
+                        : possibleSemVerPathVersionInfo === null || possibleSemVerPathVersionInfo === void 0 ? void 0 : possibleSemVerPathVersionInfo.Type,
+                }
+                : {}),
+        };
+    }
+    else if (possibleSemVerQueryVersionInfo) {
+        // We got a version for the query string, but it's not in the path,
+        // so fall back to normal routing (create an iframe or direct route)
+        versionInfoToUse = possibleSemVerQueryVersionInfo;
+    }
+    else if (possibleSemVerQuery) {
+        // We got a version in the query string but it does not exist
+        // This needs to 404 as this is a very specific request for a specific version
+        log.error(`could not find app ${appName}, for path ${event.rawPath} - returning 404`, {
+            statusCode: 404,
+        });
+        return {
+            statusCode: 404,
+            errorMessage: `Router - Could not find app: ${event.rawPath}, ${appName}`,
+        };
+    }
+    else {
+        //
+        // TODO: Get the incoming attributes of user
+        // For logged in users, these can be: department, product type,
+        //  employee, office, division, etc.
+        // For anonymous users this can be: geo region, language,
+        // browser, IP, CIDR, ASIN, etc.
+        //
+        // The Rules can be either a version or a distribution of versions,
+        // including default, for example:
+        //     80% to 1.1.0, 20% to default (1.0.3)
+        //
+        const rules = await appVersionCache.GetRules({ key: { AppName: appName } });
+        const defaultVersion = (_a = rules === null || rules === void 0 ? void 0 : rules.RuleSet.default) === null || _a === void 0 ? void 0 : _a.SemVer;
+        if (defaultVersion == null) {
+            log.error(`could not find app ${appName}, for path ${event.rawPath} - returning 404`, {
+                statusCode: 404,
+            });
+            return {
+                statusCode: 404,
+                errorMessage: `Router - Could not find app: ${event.rawPath}, ${appName}`,
+            };
+        }
+        const defaultVersionInfo = await appVersionCache.GetVersionInfo({
+            key: { AppName: appName, SemVer: defaultVersion },
+        });
+        versionInfoToUse = defaultVersionInfo;
+    }
+    if (!versionInfoToUse) {
+        log.error(`could not find version info for app ${appName}, for path ${event.rawPath} - returning 404`, {
+            statusCode: 404,
+        });
+        return {
+            statusCode: 404,
+            errorMessage: `Router - Could not find version info for app: ${event.rawPath}, ${appName}`,
+        };
+    }
+    if ((versionInfoToUse === null || versionInfoToUse === void 0 ? void 0 : versionInfoToUse.StartupType) === 'iframe' || !(versionInfoToUse === null || versionInfoToUse === void 0 ? void 0 : versionInfoToUse.StartupType)) {
+        // Prepare the iframe contents
+        let appVersionPath;
+        if (
+        // versionInfoToUse?.Type !== 'static' &&
+        (versionInfoToUse === null || versionInfoToUse === void 0 ? void 0 : versionInfoToUse.DefaultFile) === undefined ||
+            (versionInfoToUse === null || versionInfoToUse === void 0 ? void 0 : versionInfoToUse.DefaultFile) === '' ||
+            additionalParts !== '') {
+            // KLUDGE: We're going to take a missing default file to mean that the
+            // app type is Next.js (or similar) and that it wants no trailing slash after the version
+            // TODO: Move this to an attribute of the version
+            appVersionPath = `${normalizedPathPrefix}/${appNameOrRootTrailingSlash}${versionInfoToUse.SemVer}`;
+            if (additionalParts !== '') {
+                appVersionPath += `/${additionalParts}`;
+            }
+        }
+        else {
+            // Linking to the file directly means this will be peeled off by the S3 route
+            // That means we won't have to proxy this from S3
+            appVersionPath = `${normalizedPathPrefix}/${appNameOrRootTrailingSlash}${versionInfoToUse.SemVer}/${versionInfoToUse.DefaultFile}`;
+        }
+        return {
+            statusCode: 200,
+            appName,
+            semVer: versionInfoToUse.SemVer,
+            startupType: 'iframe',
+            isAPIPath: additionalParts.startsWith('api/'),
+            ...((versionInfoToUse === null || versionInfoToUse === void 0 ? void 0 : versionInfoToUse.URL) ? { url: versionInfoToUse === null || versionInfoToUse === void 0 ? void 0 : versionInfoToUse.URL } : {}),
+            ...((versionInfoToUse === null || versionInfoToUse === void 0 ? void 0 : versionInfoToUse.Type)
+                ? { type: (versionInfoToUse === null || versionInfoToUse === void 0 ? void 0 : versionInfoToUse.Type) === 'lambda' ? 'apigwy' : versionInfoToUse === null || versionInfoToUse === void 0 ? void 0 : versionInfoToUse.Type }
+                : {}),
+            iFrameAppVersionPath: appVersionPath,
+        };
+    }
+    else {
+        // This is a direct app version, no iframe needed
+        if ((versionInfoToUse === null || versionInfoToUse === void 0 ? void 0 : versionInfoToUse.Type) === 'lambda') {
+            throw new Error('Invalid type for direct app version');
+        }
+        if (['apigwy', 'static'].includes((versionInfoToUse === null || versionInfoToUse === void 0 ? void 0 : versionInfoToUse.Type) || '')) {
+            throw new Error('Invalid type for direct app version');
+        }
+        return {
+            statusCode: 200,
+            appName,
+            semVer: versionInfoToUse.SemVer,
+            startupType: 'direct',
+            isAPIPath: additionalParts.startsWith('api/'),
+            ...((versionInfoToUse === null || versionInfoToUse === void 0 ? void 0 : versionInfoToUse.URL) ? { url: versionInfoToUse === null || versionInfoToUse === void 0 ? void 0 : versionInfoToUse.URL } : {}),
+            ...((versionInfoToUse === null || versionInfoToUse === void 0 ? void 0 : versionInfoToUse.Type) ? { type: versionInfoToUse === null || versionInfoToUse === void 0 ? void 0 : versionInfoToUse.Type } : {}),
+        };
+    }
+}
+exports.RouteApp = RouteApp;
+//# sourceMappingURL=route-app.js.map

package/dist/route-app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-app.js","sourceRoot":"","sources":["../src/route-app.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pwrdrvr/microapps-router-lib",
-  "version": "0.4.0-alpha.9",
+  "version": "1.0.2",
   "description": "Router library for the microapps framework",
   "types": "dist/index.d.ts",
   "main": "dist/index.js",
@@ -23,16 +23,18 @@
     "fs-extra": "^9.0.0",
     "lambda-log": "^3.0.0",
     "source-map-support": "^0.5.0",
-    "tslib": "^2.0.0"
+    "tslib": "^2.1.0"
   },
   "devDependencies": {
     "@aws-sdk/client-dynamodb": "3.78.0",
     "@types/aws-lambda": "8.10.110",
     "@types/lambda-log": "^2.2.0",
-    "@types/node": "16.9.2",
+    "@types/mock-fs": "4.13.1",
+    "@types/node": "^18.0.0",
     "@types/source-map-support": "0.5.6",
     "fs-extra": "^9.1.0",
     "lambda-log": "^3.1.0",
+    "mock-fs": "5.2.0",
     "source-map-support": "0.5.21",
     "tslib": "^2.1.0"
   },

package/src/get-app-info.spec.ts

@@ -0,0 +1,77 @@
+import { DBManager, Rules } from '@pwrdrvr/microapps-datalib';
+import { AppVersionCache } from './app-cache';
+import { GetAppInfo } from './get-app-info';
+
+jest.mock('@pwrdrvr/microapps-datalib');
+
+describe('GetAppInfo', () => {
+  const dbManager = {} as DBManager;
+  const getAppVersionCacheSpy = jest.spyOn(AppVersionCache, 'GetInstance');
+
+  beforeEach(() => {
+    jest.clearAllMocks();
+  });
+
+  afterEach(() => {
+    getAppVersionCacheSpy.mockReset();
+  });
+
+  const testCases = [
+    {
+      caseName: 'returns the correct app name when it exists',
+      appName: 'testApp',
+      mockRules: {
+        AppName: 'testapp',
+        Version: 1,
+        RuleSet: {
+          default: {
+            AttributeName: 'default',
+            AttributeValue: '',
+            SemVer: '1.0.0',
+          },
+        },
+      } as unknown as Rules,
+      expected: 'testApp',
+    },
+    {
+      caseName:
+        'returns undefined when the app name does not exist and there is no [root] catch-all app',
+      appName: 'nonexistent',
+      mockRules: undefined,
+      expected: undefined,
+    },
+    {
+      caseName:
+        'returns [root] when the app name does not exist but there is a [root] catch-all app',
+      appName: 'nonexistent',
+      mockRules: {
+        AppName: '[root]',
+        RuleSet: {
+          default: {
+            AttributeName: 'default',
+            AttributeValue: '',
+            SemVer: '9.0.0',
+          },
+        } as unknown as Rules,
+      },
+      expected: '[root]',
+    },
+  ];
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars
+  it.each(testCases)('$caseName', async ({ caseName, appName, mockRules, expected }) => {
+    getAppVersionCacheSpy.mockImplementation(() => {
+      return {
+        // eslint-disable-next-line @typescript-eslint/require-await
+        GetRules: async ({ key }: { key: { AppName: string } }) => {
+          if (key.AppName === appName || key.AppName === '[root]') {
+            return mockRules;
+          }
+          return undefined;
+        },
+      } as unknown as AppVersionCache;
+    });
+
+    const result = await GetAppInfo({ dbManager, appName });
+    expect(result).toEqual(expected);
+  });
+});

package/src/get-app-info.ts

@@ -0,0 +1,31 @@
+import { DBManager, Rules } from '@pwrdrvr/microapps-datalib';
+import { AppVersionCache } from './app-cache';
+
+/**
+ * Determine if we have an appname or a catch all app
+ */
+
+export async function GetAppInfo(opts: {
+  dbManager: DBManager;
+  appName: string;
+}): Promise<string | undefined> {
+  const { dbManager, appName } = opts;
+
+  let rules: Rules | undefined;
+
+  const appVersionCache = AppVersionCache.GetInstance({ dbManager });
+
+  // Check if we got a matching app name
+  rules = await appVersionCache.GetRules({ key: { AppName: appName } });
+  if (rules && rules.AppName === appName.toLowerCase()) {
+    return appName;
+  }
+
+  // Check if we have a `[root]` app that is a catch all
+  rules = await appVersionCache.GetRules({ key: { AppName: '[root]' } });
+  if (rules && rules.AppName === '[root]') {
+    return '[root]';
+  }
+
+  return undefined;
+}