@red-hat-developer-hub/backstage-plugin-bulk-import-backend 5.0.1

package/dist/helpers/auditLogUtils.cjs.js

@@ -0,0 +1,112 @@
+'use strict';
+
+var errors = require('@backstage/errors');
+
+const EVENT_PREFIX = "BulkImport";
+const UNKNOWN_ENDPOINT_EVENT = `${EVENT_PREFIX}UnknownEndpoint`;
+async function auditLogRequestSuccess(auditLogger, openApiOperationId, req, responseStatus) {
+  if (!openApiOperationId) {
+    auditLogUnknownEndpoint(auditLogger, req);
+    return;
+  }
+  auditLogger.auditLog({
+    eventName: operationIdToEventName(openApiOperationId),
+    stage: "completion",
+    status: "succeeded",
+    level: "info",
+    request: req,
+    response: {
+      status: responseStatus
+    },
+    message: `'${req.method} ${req.path}' endpoint hit by ${await auditLogger.getActorId(req)}`
+  });
+}
+async function auditLogRequestError(auditLogger, openApiOperationId, req, error) {
+  if (!openApiOperationId) {
+    auditLogUnknownEndpoint(auditLogger, req);
+    return;
+  }
+  auditLogger.auditLog({
+    eventName: operationIdToEventName(openApiOperationId),
+    stage: "completion",
+    status: "failed",
+    level: "error",
+    request: req,
+    response: {
+      status: 500,
+      body: {
+        errors: [
+          {
+            name: error.name,
+            message: error.message || "internal server error"
+          }
+        ]
+      }
+    },
+    errors: [error],
+    message: `Error while requesting the '${req.method} ${req.path}' endpoint (request from ${await auditLogger.getActorId(req)})`
+  });
+}
+async function auditLogUnknownEndpoint(auditLogger, req) {
+  const error = new errors.NotFoundError(`'${req.method} ${req.path}' not found`);
+  auditLogger.auditLog({
+    eventName: UNKNOWN_ENDPOINT_EVENT,
+    stage: "initiation",
+    status: "failed",
+    level: "info",
+    request: req,
+    response: {
+      status: 404,
+      body: {
+        errors: [
+          {
+            name: error.name,
+            message: error.message
+          }
+        ]
+      }
+    },
+    errors: [error],
+    message: `${await auditLogger.getActorId(req)} requested the unknown '${req.method} ${req.path}' endpoint`
+  });
+}
+async function auditLogAuthError(auditLogger, openApiOperationId, req, error) {
+  if (!openApiOperationId) {
+    auditLogUnknownEndpoint(auditLogger, req);
+    return;
+  }
+  auditLogger.auditLog({
+    eventName: operationIdToEventName(openApiOperationId),
+    stage: "authorization",
+    status: "failed",
+    level: "warn",
+    request: req,
+    response: {
+      status: 403,
+      body: {
+        errors: [
+          {
+            name: error.name,
+            message: error.message
+          }
+        ]
+      }
+    },
+    errors: [error],
+    message: `${await auditLogger.getActorId(
+      req
+    )} not authorized to request the '${req.method} ${req.path}' endpoint`
+  });
+}
+function operationIdToEventName(openApiOperationId) {
+  if (openApiOperationId.length === 0) {
+    return EVENT_PREFIX;
+  }
+  return `${EVENT_PREFIX}${openApiOperationId.charAt(0).toUpperCase()}${openApiOperationId.slice(1)}`;
+}
+
+exports.auditLogAuthError = auditLogAuthError;
+exports.auditLogRequestError = auditLogRequestError;
+exports.auditLogRequestSuccess = auditLogRequestSuccess;
+exports.auditLogUnknownEndpoint = auditLogUnknownEndpoint;
+//# sourceMappingURL=auditLogUtils.cjs.js.map

package/dist/helpers/auditLogUtils.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auditLogUtils.cjs.js","sources":["../../src/helpers/auditLogUtils.ts"],"sourcesContent":["/*\n * Copyright 2024 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { NotFoundError, type NotAllowedError } from '@backstage/errors';\n\nimport type { AuditLogger } from '@janus-idp/backstage-plugin-audit-log-node';\nimport express from 'express';\n\nconst EVENT_PREFIX = 'BulkImport';\nconst UNKNOWN_ENDPOINT_EVENT = `${EVENT_PREFIX}UnknownEndpoint`;\n\nexport async function auditLogRequestSuccess(\n  auditLogger: AuditLogger,\n  openApiOperationId: string | undefined,\n  req: express.Request,\n  responseStatus: number,\n) {\n  if (!openApiOperationId) {\n    auditLogUnknownEndpoint(auditLogger, req);\n    return;\n  }\n  auditLogger.auditLog({\n    eventName: operationIdToEventName(openApiOperationId),\n    stage: 'completion',\n    status: 'succeeded',\n    level: 'info',\n    request: req,\n    response: {\n      status: responseStatus,\n    },\n    message: `'${req.method} ${\n      req.path\n    }' endpoint hit by ${await auditLogger.getActorId(req)}`,\n  });\n}\n\nexport async function auditLogRequestError(\n  auditLogger: AuditLogger,\n  openApiOperationId: string | undefined,\n  req: express.Request,\n  error: any,\n) {\n  if (!openApiOperationId) {\n    auditLogUnknownEndpoint(auditLogger, req);\n    return;\n  }\n  auditLogger.auditLog({\n    eventName: operationIdToEventName(openApiOperationId),\n    stage: 'completion',\n    status: 'failed',\n    level: 'error',\n    request: req,\n    response: {\n      status: 500,\n      body: {\n        errors: [\n          {\n            name: error.name,\n            message: error.message || 'internal server error',\n          },\n        ],\n      },\n    },\n    errors: [error],\n    message: `Error while requesting the '${req.method} ${\n      req.path\n    }' endpoint (request from ${await auditLogger.getActorId(req)})`,\n  });\n}\n\nexport async function auditLogUnknownEndpoint(\n  auditLogger: AuditLogger,\n  req: express.Request,\n) {\n  const error = new NotFoundError(`'${req.method} ${req.path}' not found`);\n  auditLogger.auditLog({\n    eventName: UNKNOWN_ENDPOINT_EVENT,\n    stage: 'initiation',\n    status: 'failed',\n    level: 'info',\n    request: req,\n    response: {\n      status: 404,\n      body: {\n        errors: [\n          {\n            name: error.name,\n            message: error.message,\n          },\n        ],\n      },\n    },\n    errors: [error],\n    message: `${await auditLogger.getActorId(req)} requested the unknown '${\n      req.method\n    } ${req.path}' endpoint`,\n  });\n}\n\nexport async function auditLogAuthError(\n  auditLogger: AuditLogger,\n  openApiOperationId: string | undefined,\n  req: express.Request,\n  error: NotAllowedError,\n) {\n  if (!openApiOperationId) {\n    auditLogUnknownEndpoint(auditLogger, req);\n    return;\n  }\n  auditLogger.auditLog({\n    eventName: operationIdToEventName(openApiOperationId),\n    stage: 'authorization',\n    status: 'failed',\n    level: 'warn',\n    request: req,\n    response: {\n      status: 403,\n      body: {\n        errors: [\n          {\n            name: error.name,\n            message: error.message,\n          },\n        ],\n      },\n    },\n    errors: [error],\n    message: `${await auditLogger.getActorId(\n      req,\n    )} not authorized to request the '${req.method} ${req.path}' endpoint`,\n  });\n}\n\nfunction operationIdToEventName(openApiOperationId: string): string {\n  if (openApiOperationId.length === 0) {\n    return EVENT_PREFIX;\n  }\n  return `${EVENT_PREFIX}${openApiOperationId\n    .charAt(0)\n    .toUpperCase()}${openApiOperationId.slice(1)}`;\n}\n"],"names":["NotFoundError"],"mappings":"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"}

package/dist/helpers/auth.cjs.js

@@ -0,0 +1,36 @@
+'use strict';
+
+var errors = require('@backstage/errors');
+var pluginPermissionCommon = require('@backstage/plugin-permission-common');
+var backstagePluginBulkImportCommon = require('@red-hat-developer-hub/backstage-plugin-bulk-import-common');
+var auditLogUtils = require('./auditLogUtils.cjs.js');
+
+async function permissionCheck(auditLogger, openApiOperationId, permissions, httpAuth, req) {
+  const decision = (await permissions.authorize(
+    [
+      {
+        permission: backstagePluginBulkImportCommon.bulkImportPermission,
+        resourceRef: backstagePluginBulkImportCommon.bulkImportPermission.resourceType
+      }
+    ],
+    {
+      credentials: await httpAuth.credentials(req)
+    }
+  ))[0];
+  if (decision.result === pluginPermissionCommon.AuthorizeResult.DENY) {
+    const err = new errors.NotAllowedError("Unauthorized");
+    auditLogUtils.auditLogAuthError(auditLogger, openApiOperationId, req, err);
+    throw err;
+  }
+}
+async function getTokenForPlugin(auth, targetPluginId) {
+  const resp = await auth.getPluginRequestToken({
+    onBehalfOf: await auth.getOwnServiceCredentials(),
+    targetPluginId
+  });
+  return resp.token;
+}
+
+exports.getTokenForPlugin = getTokenForPlugin;
+exports.permissionCheck = permissionCheck;
+//# sourceMappingURL=auth.cjs.js.map

package/dist/helpers/auth.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.cjs.js","sources":["../../src/helpers/auth.ts"],"sourcesContent":["/*\n * Copyright 2024 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type {\n  AuthService,\n  HttpAuthService,\n  PermissionsService,\n} from '@backstage/backend-plugin-api';\nimport { NotAllowedError } from '@backstage/errors';\nimport { AuthorizeResult } from '@backstage/plugin-permission-common';\n\nimport type { AuditLogger } from '@janus-idp/backstage-plugin-audit-log-node';\nimport express from 'express';\n\nimport { bulkImportPermission } from '@red-hat-developer-hub/backstage-plugin-bulk-import-common';\n\nimport { auditLogAuthError } from './auditLogUtils';\n\n/**\n * This will resolve to { result: AuthorizeResult.ALLOW } if the permission framework is disabled\n */\nexport async function permissionCheck(\n  auditLogger: AuditLogger,\n  openApiOperationId: string | undefined,\n  permissions: PermissionsService,\n  httpAuth: HttpAuthService,\n  req: express.Request,\n) {\n  const decision = (\n    await permissions.authorize(\n      [\n        {\n          permission: bulkImportPermission,\n          resourceRef: bulkImportPermission.resourceType,\n        },\n      ],\n      {\n        credentials: await httpAuth.credentials(req),\n      },\n    )\n  )[0];\n\n  if (decision.result === AuthorizeResult.DENY) {\n    const err = new NotAllowedError('Unauthorized');\n    auditLogAuthError(auditLogger, openApiOperationId, req, err);\n    throw err;\n  }\n}\n\nexport async function getTokenForPlugin(\n  auth: AuthService,\n  targetPluginId: string,\n): Promise<string> {\n  const resp = await auth.getPluginRequestToken({\n    onBehalfOf: await auth.getOwnServiceCredentials(),\n    targetPluginId,\n  });\n  return resp.token;\n}\n"],"names":["bulkImportPermission","AuthorizeResult","NotAllowedError","auditLogAuthError"],"mappings":";;;;;;;AAkCA,eAAsB,eACpB,CAAA,WAAA,EACA,kBACA,EAAA,WAAA,EACA,UACA,GACA,EAAA;AACA,EAAM,MAAA,QAAA,GAAA,CACJ,MAAM,WAAY,CAAA,SAAA;AAAA,IAChB;AAAA,MACE;AAAA,QACE,UAAY,EAAAA,oDAAA;AAAA,QACZ,aAAaA,oDAAqB,CAAA,YAAA;AAAA,OACpC;AAAA,KACF;AAAA,IACA;AAAA,MACE,WAAa,EAAA,MAAM,QAAS,CAAA,WAAA,CAAY,GAAG,CAAA;AAAA,KAC7C;AAAA,KAEF,CAAC,CAAA,CAAA;AAEH,EAAI,IAAA,QAAA,CAAS,MAAW,KAAAC,sCAAA,CAAgB,IAAM,EAAA;AAC5C,IAAM,MAAA,GAAA,GAAM,IAAIC,sBAAA,CAAgB,cAAc,CAAA,CAAA;AAC9C,IAAkBC,+BAAA,CAAA,WAAA,EAAa,kBAAoB,EAAA,GAAA,EAAK,GAAG,CAAA,CAAA;AAC3D,IAAM,MAAA,GAAA,CAAA;AAAA,GACR;AACF,CAAA;AAEsB,eAAA,iBAAA,CACpB,MACA,cACiB,EAAA;AACjB,EAAM,MAAA,IAAA,GAAO,MAAM,IAAA,CAAK,qBAAsB,CAAA;AAAA,IAC5C,UAAA,EAAY,MAAM,IAAA,CAAK,wBAAyB,EAAA;AAAA,IAChD,cAAA;AAAA,GACD,CAAA,CAAA;AACD,EAAA,OAAO,IAAK,CAAA,KAAA,CAAA;AACd;;;;;"}

package/dist/helpers/loggingUtils.cjs.js

@@ -0,0 +1,19 @@
+'use strict';
+
+var errors = require('@backstage/errors');
+
+function logErrorIfNeeded(logger, logMsg, error) {
+  if (errors.isError(error)) {
+    logger.error(logMsg, {
+      // Default Error properties:
+      name: error.name,
+      message: error.message,
+      stack: error.stack,
+      // Additional status code if available:
+      status: error.response?.status
+    });
+  }
+}
+
+exports.logErrorIfNeeded = logErrorIfNeeded;
+//# sourceMappingURL=loggingUtils.cjs.js.map

package/dist/helpers/loggingUtils.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loggingUtils.cjs.js","sources":["../../src/helpers/loggingUtils.ts"],"sourcesContent":["/*\n * Copyright 2024 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { LoggerService } from '@backstage/backend-plugin-api';\nimport { isError } from '@backstage/errors';\n\n/**\n * Logs the error specified by ensuring no sensitive internal data is disclosed.\n * @param logger the logger\n * @param logMsg the log message\n * @param error the error\n */\nexport function logErrorIfNeeded(\n  logger: LoggerService,\n  logMsg: string,\n  error: any,\n) {\n  if (isError(error)) {\n    // Ensure that we don't log any sensitive internal data:\n    logger.error(logMsg, {\n      // Default Error properties:\n      name: error.name,\n      message: error.message,\n      stack: error.stack,\n      // Additional status code if available:\n      status: (error.response as { status?: string })?.status,\n    });\n  }\n}\n"],"names":["isError"],"mappings":";;;;AAyBgB,SAAA,gBAAA,CACd,MACA,EAAA,MAAA,EACA,KACA,EAAA;AACA,EAAI,IAAAA,cAAA,CAAQ,KAAK,CAAG,EAAA;AAElB,IAAA,MAAA,CAAO,MAAM,MAAQ,EAAA;AAAA;AAAA,MAEnB,MAAM,KAAM,CAAA,IAAA;AAAA,MACZ,SAAS,KAAM,CAAA,OAAA;AAAA,MACf,OAAO,KAAM,CAAA,KAAA;AAAA;AAAA,MAEb,MAAA,EAAS,MAAM,QAAkC,EAAA,MAAA;AAAA,KAClD,CAAA,CAAA;AAAA,GACH;AACF;;;;"}

package/dist/helpers/pagination.cjs.js

@@ -0,0 +1,19 @@
+'use strict';
+
+function paginateArray(array, page, size) {
+  if (page <= 0) {
+    throw new Error(`page must be >0. Got page=${page}`);
+  }
+  if (size < 0) {
+    throw new Error(`size must be >=0. Got size=${size}`);
+  }
+  const startIndex = (page - 1) * size;
+  const endIndex = startIndex + size;
+  return {
+    result: array?.slice(startIndex, endIndex) ?? [],
+    totalCount: array?.length ?? 0
+  };
+}
+
+exports.paginateArray = paginateArray;
+//# sourceMappingURL=pagination.cjs.js.map

package/dist/helpers/pagination.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.cjs.js","sources":["../../src/helpers/pagination.ts"],"sourcesContent":["/*\n * Copyright 2024 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * Returns a paginated chunk of the specified array\n * @param array the array to paginate\n * @param page the page number\n * @param size the maximum number of elements in each page\n */\nexport function paginateArray<T>(\n  array: T[] | undefined,\n  page: number,\n  size: number,\n): { result: T[]; totalCount: number } {\n  if (page <= 0) {\n    throw new Error(`page must be >0. Got page=${page}`);\n  }\n  if (size < 0) {\n    throw new Error(`size must be >=0. Got size=${size}`);\n  }\n\n  const startIndex = (page - 1) * size;\n  const endIndex = startIndex + size;\n\n  return {\n    result: array?.slice(startIndex, endIndex) ?? [],\n    totalCount: array?.length ?? 0,\n  };\n}\n"],"names":[],"mappings":";;AAsBgB,SAAA,aAAA,CACd,KACA,EAAA,IAAA,EACA,IACqC,EAAA;AACrC,EAAA,IAAI,QAAQ,CAAG,EAAA;AACb,IAAA,MAAM,IAAI,KAAA,CAAM,CAA6B,0BAAA,EAAA,IAAI,CAAE,CAAA,CAAA,CAAA;AAAA,GACrD;AACA,EAAA,IAAI,OAAO,CAAG,EAAA;AACZ,IAAA,MAAM,IAAI,KAAA,CAAM,CAA8B,2BAAA,EAAA,IAAI,CAAE,CAAA,CAAA,CAAA;AAAA,GACtD;AAEA,EAAM,MAAA,UAAA,GAAA,CAAc,OAAO,CAAK,IAAA,IAAA,CAAA;AAChC,EAAA,MAAM,WAAW,UAAa,GAAA,IAAA,CAAA;AAE9B,EAAO,OAAA;AAAA,IACL,QAAQ,KAAO,EAAA,KAAA,CAAM,UAAY,EAAA,QAAQ,KAAK,EAAC;AAAA,IAC/C,UAAA,EAAY,OAAO,MAAU,IAAA,CAAA;AAAA,GAC/B,CAAA;AACF;;;;"}

package/dist/index.cjs.js

@@ -0,0 +1,12 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var plugin = require('./plugin.cjs.js');
+var router = require('./service/router.cjs.js');
+
+
+
+exports.default = plugin.bulkImportPlugin;
+exports.createRouter = router.createRouter;
+//# sourceMappingURL=index.cjs.js.map

package/dist/index.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;"}

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+import * as _backstage_backend_plugin_api from '@backstage/backend-plugin-api';
+import { LoggerService, CacheService, DiscoveryService, HttpAuthService, AuthService } from '@backstage/backend-plugin-api';
+import { CatalogApi } from '@backstage/catalog-client';
+import { Config } from '@backstage/config';
+import { PermissionEvaluator } from '@backstage/plugin-permission-common';
+import express from 'express';
+
+/**
+ * The bulk-import backend plugin.
+ */
+declare const bulkImportPlugin: _backstage_backend_plugin_api.BackendFeature;
+
+interface RouterOptions {
+    logger: LoggerService;
+    permissions: PermissionEvaluator;
+    config: Config;
+    cache: CacheService;
+    discovery: DiscoveryService;
+    httpAuth: HttpAuthService;
+    auth: AuthService;
+    catalogApi: CatalogApi;
+}
+declare function createRouter(options: RouterOptions): Promise<express.Router>;
+
+export { type RouterOptions, createRouter, bulkImportPlugin as default };

package/dist/plugin.cjs.js

@@ -0,0 +1,54 @@
+'use strict';
+
+var backendPluginApi = require('@backstage/backend-plugin-api');
+var alpha = require('@backstage/plugin-catalog-node/alpha');
+var router = require('./service/router.cjs.js');
+
+const bulkImportPlugin = backendPluginApi.createBackendPlugin({
+  pluginId: "bulk-import",
+  register(env) {
+    env.registerInit({
+      deps: {
+        logger: backendPluginApi.coreServices.logger,
+        config: backendPluginApi.coreServices.rootConfig,
+        http: backendPluginApi.coreServices.httpRouter,
+        cache: backendPluginApi.coreServices.cache,
+        discovery: backendPluginApi.coreServices.discovery,
+        permissions: backendPluginApi.coreServices.permissions,
+        httpAuth: backendPluginApi.coreServices.httpAuth,
+        auth: backendPluginApi.coreServices.auth,
+        catalogApi: alpha.catalogServiceRef
+      },
+      async init({
+        config,
+        logger,
+        http,
+        cache,
+        discovery,
+        permissions,
+        httpAuth,
+        auth,
+        catalogApi
+      }) {
+        const router$1 = await router.createRouter({
+          config,
+          cache,
+          discovery,
+          permissions,
+          logger,
+          httpAuth,
+          auth,
+          catalogApi
+        });
+        http.use(router$1);
+        http.addAuthPolicy({
+          path: "/ping",
+          allow: "unauthenticated"
+        });
+      }
+    });
+  }
+});
+
+exports.bulkImportPlugin = bulkImportPlugin;
+//# sourceMappingURL=plugin.cjs.js.map

package/dist/plugin.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.cjs.js","sources":["../src/plugin.ts"],"sourcesContent":["/*\n * Copyright 2024 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  coreServices,\n  createBackendPlugin,\n} from '@backstage/backend-plugin-api';\nimport { catalogServiceRef } from '@backstage/plugin-catalog-node/alpha';\n\nimport { createRouter } from './service/router';\n\n/**\n * The bulk-import backend plugin.\n */\nexport const bulkImportPlugin = createBackendPlugin({\n  pluginId: 'bulk-import',\n  register(env) {\n    env.registerInit({\n      deps: {\n        logger: coreServices.logger,\n        config: coreServices.rootConfig,\n        http: coreServices.httpRouter,\n        cache: coreServices.cache,\n        discovery: coreServices.discovery,\n        permissions: coreServices.permissions,\n        httpAuth: coreServices.httpAuth,\n        auth: coreServices.auth,\n        catalogApi: catalogServiceRef,\n      },\n      async init({\n        config,\n        logger,\n        http,\n        cache,\n        discovery,\n        permissions,\n        httpAuth,\n        auth,\n        catalogApi,\n      }) {\n        const router = await createRouter({\n          config,\n          cache,\n          discovery,\n          permissions,\n          logger,\n          httpAuth,\n          auth,\n          catalogApi,\n        });\n        http.use(router);\n        http.addAuthPolicy({\n          path: '/ping',\n          allow: 'unauthenticated',\n        });\n      },\n    });\n  },\n});\n"],"names":["createBackendPlugin","coreServices","catalogServiceRef","router","createRouter"],"mappings":";;;;;;AA2BO,MAAM,mBAAmBA,oCAAoB,CAAA;AAAA,EAClD,QAAU,EAAA,aAAA;AAAA,EACV,SAAS,GAAK,EAAA;AACZ,IAAA,GAAA,CAAI,YAAa,CAAA;AAAA,MACf,IAAM,EAAA;AAAA,QACJ,QAAQC,6BAAa,CAAA,MAAA;AAAA,QACrB,QAAQA,6BAAa,CAAA,UAAA;AAAA,QACrB,MAAMA,6BAAa,CAAA,UAAA;AAAA,QACnB,OAAOA,6BAAa,CAAA,KAAA;AAAA,QACpB,WAAWA,6BAAa,CAAA,SAAA;AAAA,QACxB,aAAaA,6BAAa,CAAA,WAAA;AAAA,QAC1B,UAAUA,6BAAa,CAAA,QAAA;AAAA,QACvB,MAAMA,6BAAa,CAAA,IAAA;AAAA,QACnB,UAAY,EAAAC,uBAAA;AAAA,OACd;AAAA,MACA,MAAM,IAAK,CAAA;AAAA,QACT,MAAA;AAAA,QACA,MAAA;AAAA,QACA,IAAA;AAAA,QACA,KAAA;AAAA,QACA,SAAA;AAAA,QACA,WAAA;AAAA,QACA,QAAA;AAAA,QACA,IAAA;AAAA,QACA,UAAA;AAAA,OACC,EAAA;AACD,QAAM,MAAAC,QAAA,GAAS,MAAMC,mBAAa,CAAA;AAAA,UAChC,MAAA;AAAA,UACA,KAAA;AAAA,UACA,SAAA;AAAA,UACA,WAAA;AAAA,UACA,MAAA;AAAA,UACA,QAAA;AAAA,UACA,IAAA;AAAA,UACA,UAAA;AAAA,SACD,CAAA,CAAA;AACD,QAAA,IAAA,CAAK,IAAID,QAAM,CAAA,CAAA;AACf,QAAA,IAAA,CAAK,aAAc,CAAA;AAAA,UACjB,IAAM,EAAA,OAAA;AAAA,UACN,KAAO,EAAA,iBAAA;AAAA,SACR,CAAA,CAAA;AAAA,OACH;AAAA,KACD,CAAA,CAAA;AAAA,GACH;AACF,CAAC;;;;"}

package/dist/service/handlers/handlers.cjs.js

@@ -0,0 +1,8 @@
+'use strict';
+
+const DefaultPageNumber = 1;
+const DefaultPageSize = 20;
+
+exports.DefaultPageNumber = DefaultPageNumber;
+exports.DefaultPageSize = DefaultPageSize;
+//# sourceMappingURL=handlers.cjs.js.map

package/dist/service/handlers/handlers.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.cjs.js","sources":["../../../src/service/handlers/handlers.ts"],"sourcesContent":["/*\n * Copyright 2024 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport const DefaultPageNumber = 1;\nexport const DefaultPageSize = 20;\n\nexport interface HandlerResponse<ResponseBody = any> {\n  statusCode: number;\n  responseBody?: ResponseBody;\n}\n"],"names":[],"mappings":";;AAgBO,MAAM,iBAAoB,GAAA,EAAA;AAC1B,MAAM,eAAkB,GAAA;;;;;"}