swoop-common 2.1.49 → 2.1.50

package/dist/api/bundler.js

@@ -1,29 +1,62 @@
 import fs from "fs";
-// Super lazy bundler, just sticks models onto the end of specs and updates refs
-const bundle = (sdk) => {
-    const specs = fs.readFileSync(`./openapi/${sdk}_service.yaml`, "utf-8");
-    const models = fs.readFileSync("./openapi/models.yaml", "utf-8");
-    // Remove header of models
-    const clean = models.split("\n");
-    let reached = false;
-    let full = "";
-    for (let i = 0; i < clean.length; i++) {
-        if (!reached && clean[i].startsWith("components"))
-            reached = true;
-        // Removes tags
-        if (clean[i].startsWith("tags"))
-            break;
-        if (reached)
-            full += "\n" + clean[i];
+import yaml from "js-yaml";
+/**
+ * Merge all `components` subsections (schemas, parameters, responses, etc.)
+ */
+function mergeComponents(target, source) {
+    if (!(source === null || source === void 0 ? void 0 : source.components))
+        return;
+    if (!target.components) {
+        target.components = {};
     }
-    // Dont need to parse specs, can just look for references
-    const updatedSpecs = specs.replace(/\.\/models\.yaml/g, "") + "\n" + full;
-    // Make sure all refs are wrapped in '
-    const cleanedSpecs = updatedSpecs.split("\n").map(line => line.replace(/(\$ref:\s*)(["']?)([^"'\s]+)\2/, (_, prefix, _q, path) => {
-        return `${prefix}'${path}'`;
-    })).join("\n");
+    for (const key of Object.keys(source.components)) {
+        if (!target.components[key]) {
+            target.components[key] = {};
+        }
+        Object.assign(target.components[key], source.components[key]);
+    }
+}
+/**
+ * Fix $ref pointers from external file refs (e.g. ./models.yaml#/...)
+ * to internal refs (#/components/...)
+ */
+function fixRefs(obj) {
+    if (Array.isArray(obj)) {
+        return obj.map(fixRefs);
+    }
+    else if (obj && typeof obj === "object") {
+        for (const key of Object.keys(obj)) {
+            if (key === "$ref" && typeof obj[key] === "string") {
+                obj[key] = obj[key]
+                    .replace("./models.yaml#", "#")
+                    .replace("./error.yaml#", "#");
+            }
+            else {
+                obj[key] = fixRefs(obj[key]);
+            }
+        }
+    }
+    return obj;
+}
+function bundle(sdk) {
+    const servicePath = `./openapi/${sdk}_service.yaml`;
+    const modelsPath = "./openapi/models.yaml";
+    const errorsPath = "./openapi/error.yaml";
+    const outputPath = `./openapi/generated/${sdk}_bundled.yaml`;
+    // Load YAML files
+    const service = yaml.load(fs.readFileSync(servicePath, "utf-8"));
+    const models = yaml.load(fs.readFileSync(modelsPath, "utf-8"));
+    const errors = yaml.load(fs.readFileSync(errorsPath, "utf-8"));
+    // Merge all components
+    mergeComponents(service, models);
+    mergeComponents(service, errors);
+    // Fix refs
+    const fixed = fixRefs(service);
+    // Dump back to YAML
+    const bundled = yaml.dump(fixed, { noRefs: true, lineWidth: -1 });
     fs.mkdirSync("./openapi/generated", { recursive: true });
-    fs.writeFileSync(`./openapi/generated/${sdk}_bundled.yaml`, cleanedSpecs);
-};
+    fs.writeFileSync(outputPath, bundled);
+    console.log(`✅ Bundled ${sdk} -> ${outputPath}`);
+}
 bundle("core");
 bundle("itinerary");

package/dist/api/generated/core/exports.d.ts

@@ -39,12 +39,14 @@ export type { DTOTemplateEntity } from './index';
 export type { DTOTemplateRead } from './index';
 export type { DTOTemplateUpdate } from './index';
 export type { enquiryId } from './index';
+export type { Error } from './index';
 export type { Fee } from './index';
 export type { Field } from './index';
 export type { IBEvent } from './index';
 export type { id } from './index';
 export type { itemsPerPage } from './index';
 export type { itineraryId } from './index';
+export type { itineraryIdQuery } from './index';
 export type { Limit } from './index';
 export { Meals } from './index';
 export type { Member } from './index';

package/dist/api/generated/core/index.d.ts

@@ -41,12 +41,14 @@ export type { DTOTemplateEntity } from './models/DTOTemplateEntity';
 export type { DTOTemplateRead } from './models/DTOTemplateRead';
 export type { DTOTemplateUpdate } from './models/DTOTemplateUpdate';
 export type { enquiryId } from './models/enquiryId';
+export type { Error } from './models/Error';
 export type { Fee } from './models/Fee';
 export type { Field } from './models/Field';
 export type { IBEvent } from './models/IBEvent';
 export type { id } from './models/id';
 export type { itemsPerPage } from './models/itemsPerPage';
 export type { itineraryId } from './models/itineraryId';
+export type { itineraryIdQuery } from './models/itineraryIdQuery';
 export type { Limit } from './models/Limit';
 export { Meals } from './models/Meals';
 export type { Member } from './models/Member';

package/dist/api/generated/core/models/DTOSnapshotCreate.d.ts

@@ -1,5 +1,4 @@
 export type DTOSnapshotCreate = {
     name: string;
     itineraryId: string;
-    enquiryId: string;
 };

package/dist/api/generated/core/models/DTOSnapshotEntity.d.ts

@@ -4,5 +4,4 @@ export type DTOSnapshotEntity = {
     metadata: Metadata;
     name: string;
     itineraryId: string;
-    enquiryId: string;
 };

package/dist/api/generated/core/models/DTOSnapshotRead.d.ts

@@ -4,5 +4,4 @@ export type DTOSnapshotRead = {
     metadata: Metadata;
     name: string;
     itineraryId: string;
-    enquiryId: string;
 };

package/dist/api/generated/core/models/Error.d.ts

@@ -0,0 +1 @@
+export type Error = Record<string, any>;

package/dist/api/generated/core/models/Error.js

@@ -0,0 +1 @@
+export {};

package/dist/api/generated/core/models/itineraryIdQuery.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Itinerary Id
+ */
+export type itineraryIdQuery = string;

package/dist/api/generated/core/models/itineraryIdQuery.js

@@ -0,0 +1 @@
+export {};

package/dist/api/generated/itinerary/core/OpenAPI.js

@@ -1,6 +1,6 @@
 export const OpenAPI = {
-    BASE: 'https://placeholder.com',
-    VERSION: '1.1',
+    BASE: 'https://data-api-dev.swoop-adventures.com/itinerary-builder-service/v1',
+    VERSION: '1',
     WITH_CREDENTIALS: false,
     CREDENTIALS: 'include',
     TOKEN: undefined,

package/dist/api/generated/itinerary/index.d.ts

@@ -41,12 +41,14 @@ export type { DTOTemplateEntity } from './models/DTOTemplateEntity';
 export type { DTOTemplateRead } from './models/DTOTemplateRead';
 export type { DTOTemplateUpdate } from './models/DTOTemplateUpdate';
 export type { enquiryId } from './models/enquiryId';
+export type { Error } from './models/Error';
 export type { Fee } from './models/Fee';
 export type { Field } from './models/Field';
 export type { IBEvent } from './models/IBEvent';
 export type { id } from './models/id';
 export type { itemsPerPage } from './models/itemsPerPage';
 export type { itineraryId } from './models/itineraryId';
+export type { itineraryIdQuery } from './models/itineraryIdQuery';
 export type { Limit } from './models/Limit';
 export { Meals } from './models/Meals';
 export type { Member } from './models/Member';

package/dist/api/generated/itinerary/models/DTOSnapshotCreate.d.ts

@@ -1,5 +1,4 @@
 export type DTOSnapshotCreate = {
     name: string;
     itineraryId: string;
-    enquiryId: string;
 };

package/dist/api/generated/itinerary/models/DTOSnapshotEntity.d.ts

@@ -4,5 +4,4 @@ export type DTOSnapshotEntity = {
     metadata: Metadata;
     name: string;
     itineraryId: string;
-    enquiryId: string;
 };

package/dist/api/generated/itinerary/models/DTOSnapshotRead.d.ts

@@ -4,5 +4,4 @@ export type DTOSnapshotRead = {
     metadata: Metadata;
     name: string;
     itineraryId: string;
-    enquiryId: string;
 };

package/dist/api/generated/itinerary/models/Error.d.ts

@@ -0,0 +1 @@
+export type Error = Record<string, any>;

package/dist/api/generated/itinerary/models/Error.js

@@ -0,0 +1 @@
+export {};

package/dist/api/generated/itinerary/models/itineraryIdQuery.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Itinerary Id
+ */
+export type itineraryIdQuery = string;

package/dist/api/generated/itinerary/models/itineraryIdQuery.js

@@ -0,0 +1 @@
+export {};

package/dist/api/generated/itinerary/services/ItineraryService.d.ts

@@ -8,56 +8,60 @@ import type { DTOSnapshotRead } from '../models/DTOSnapshotRead';
 import type { Pagination } from '../models/Pagination';
 import type { CancelablePromise } from '../core/CancelablePromise';
 export declare class ItineraryService {
+    /**
+     * Audit a Copy to Clipboard
+     * Audits when a user copies something to their clipboard
+     * @param itineraryId Itinerary id
+     * @param content Base64 encoding of the copied content
+     * @returns void
+     * @throws ApiError
+     */
+    auditCopyClipboard(itineraryId: string, content: string): CancelablePromise<void>;
     /**
      * Create a Snapshot
      * Creates a new snapshot. A snapshot is a reference to a specific itinerary revision group id.
      * @param requestBody
-     * @returns DTOSnapshotRead OK
+     * @returns DTOSnapshotRead When a snapshot is created
      * @throws ApiError
      */
     snapshotCreate(requestBody: DTOSnapshotCreate): CancelablePromise<DTOSnapshotRead>;
     /**
      * List Snapshots
      * List all available snapshots
-     * @param enquiryId Enquiry Id
      * @param page Pagination, starting at page 1
      * @param limit Number of items per page
      * @param sort List of fields to sort by
-     * @returns any OK
+     * @returns any The list of all snapshots given the parameters used
      * @throws ApiError
      */
-    snapshotList(enquiryId: string, page?: number, limit?: number, sort?: any[]): CancelablePromise<{
-        data: Array<DTOSnapshotRead>;
+    snapshotList(page?: number, limit?: number, sort?: any[]): CancelablePromise<{
+        data?: Array<DTOSnapshotRead>;
         pagination?: Pagination;
     }>;
     /**
      * Get Snapshot va ID
-     * Returns the specific snapshot
+     * Returns the specific snapshot given its Id
      * @param snapshotId
      * @returns any OK
      * @throws ApiError
      */
-    snapshotGet(snapshotId: string): CancelablePromise<{
-        data: Array<DTOSnapshotRead>;
-    }>;
+    snapshotGet(snapshotId: string): CancelablePromise<any>;
     /**
      * Delete Snapshot via ID
-     * Deletes a specific snapshot
+     * Deletes a specific snapshot given its Id
      * @param snapshotId
-     * @returns any OK
+     * @returns void
      * @throws ApiError
      */
-    snapshotDelete(snapshotId: string): CancelablePromise<any>;
+    snapshotDelete(snapshotId: string): CancelablePromise<void>;
     /**
      * Restore Snapshot
      * Creates a new itinerary revision given the content the snapshot refers to
      * @param snapshotId
-     * @returns any OK
+     * @returns any When a snapshot is restored as the latest version
      * @throws ApiError
      */
-    snapshotRestore(snapshotId: string): CancelablePromise<{
-        data: Array<DTOSnapshotRead>;
-    }>;
+    snapshotRestore(snapshotId: string): CancelablePromise<any>;
     /**
      * List Itineraries
      * List all itineraries
@@ -66,18 +70,18 @@ export declare class ItineraryService {
      * @param search Search term
      * @param sort List of fields to sort by
      * @param enquiryId Filter itineraries via enquiryId
-     * @returns any OK
+     * @returns any The list of all itineraries given the parameters used
      * @throws ApiError
      */
     itineraryList(page?: number, limit?: number, search?: string, sort?: any[], enquiryId?: string): CancelablePromise<{
-        data: Array<DTOItineraryRead>;
+        data?: Array<DTOItineraryRead>;
         pagination?: Pagination;
     }>;
     /**
-     * Create Itinerary
-     * Creates an itinerary
+     * Create an Itinerary
+     * Creates a new itinerary
      * @param requestBody
-     * @returns DTOItineraryRead OK
+     * @returns DTOItineraryRead When a itinerary is created
      * @throws ApiError
      */
     itineraryCreate(requestBody: DTOItineraryCreate): CancelablePromise<DTOItineraryRead>;
@@ -85,35 +89,35 @@ export declare class ItineraryService {
      * Get Itinerary
      * Get itinerary via ID
      * @param itineraryId Itinerary id
-     * @returns DTOItineraryRead OK
+     * @returns any OK
      * @throws ApiError
      */
-    itineraryGet(itineraryId: string): CancelablePromise<DTOItineraryRead>;
+    itineraryGet(itineraryId: string): CancelablePromise<any>;
     /**
-     * Update Itinerary
+     * Update Itinerary as New Revision
      * Updates an itinerary as a new revision
      * @param itineraryId Itinerary id
      * @param requestBody
-     * @returns DTOItineraryRead OK
+     * @returns DTOItineraryRead When a new revision is created successfully
      * @throws ApiError
      */
-    itineraryUpdate(itineraryId: string, requestBody: DTOItineraryUpdate): CancelablePromise<DTOItineraryRead>;
+    itineraryUpdateAsNewRevision(itineraryId: string, requestBody: DTOItineraryUpdate): CancelablePromise<DTOItineraryRead>;
     /**
-     * Delete Itinerary
-     * Delete itinerary via ID
+     * Delete Itinerary via ID
+     * Deletes a specific itinerary given its Id
      * @param itineraryId Itinerary id
-     * @returns any OK
+     * @returns void
      * @throws ApiError
      */
-    itineraryDelete(itineraryId: string): CancelablePromise<any>;
+    itineraryDelete(itineraryId: string): CancelablePromise<void>;
     /**
      * Sync Itinerary
      * Sync an itinerary with swoop
      * @param itineraryId Itinerary id
-     * @returns DTOItineraryRead OK
+     * @returns DTOItineraryRead When an itinerary has been posted to pub/sub successfully
      * @throws ApiError
      */
-    sync(itineraryId: string): CancelablePromise<DTOItineraryRead>;
+    syncItinerary(itineraryId: string): CancelablePromise<DTOItineraryRead>;
     /**
      * List Regions
      * List all regions
@@ -124,8 +128,8 @@ export declare class ItineraryService {
      * @throws ApiError
      */
     regionList(page?: number, limit?: number, sort?: any[]): CancelablePromise<{
-        data: Array<DTORegionRead>;
-        pagination: Pagination;
+        data?: Array<DTORegionRead>;
+        pagination?: Pagination;
     }>;
     /**
      * Create Region

package/dist/api/generated/itinerary/services/ItineraryService.js

@@ -1,11 +1,35 @@
 import { OpenAPI } from '../core/OpenAPI';
 import { request as __request } from '../core/request';
 export class ItineraryService {
+    /**
+     * Audit a Copy to Clipboard
+     * Audits when a user copies something to their clipboard
+     * @param itineraryId Itinerary id
+     * @param content Base64 encoding of the copied content
+     * @returns void
+     * @throws ApiError
+     */
+    auditCopyClipboard(itineraryId, content) {
+        return __request(OpenAPI, {
+            method: 'POST',
+            url: '/audit/copyClipboard/{itineraryId}',
+            path: {
+                'itineraryId': itineraryId,
+            },
+            query: {
+                'content': content,
+            },
+            errors: {
+                400: `When the content query b64 string is invalid`,
+                401: `Unauthorized - Missing or invalid Authorization header`,
+            },
+        });
+    }
     /**
      * Create a Snapshot
      * Creates a new snapshot. A snapshot is a reference to a specific itinerary revision group id.
      * @param requestBody
-     * @returns DTOSnapshotRead OK
+     * @returns DTOSnapshotRead When a snapshot is created
      * @throws ApiError
      */
     snapshotCreate(requestBody) {
@@ -14,19 +38,24 @@ export class ItineraryService {
             url: '/snapshots',
             body: requestBody,
             mediaType: 'application/json',
+            errors: {
+                400: `If the payload is malformed`,
+                401: `Unauthorized - Missing or invalid Authorization header`,
+                500: `When an internal server error occurs when creating a snapshot entity`,
+                503: `Service Unavailable - The server is temporarily unable to handle the request`,
+            },
         });
     }
     /**
      * List Snapshots
      * List all available snapshots
-     * @param enquiryId Enquiry Id
      * @param page Pagination, starting at page 1
      * @param limit Number of items per page
      * @param sort List of fields to sort by
-     * @returns any OK
+     * @returns any The list of all snapshots given the parameters used
      * @throws ApiError
      */
-    snapshotList(enquiryId, page, limit, sort) {
+    snapshotList(page, limit, sort) {
         return __request(OpenAPI, {
             method: 'GET',
             url: '/snapshots',
@@ -34,13 +63,18 @@ export class ItineraryService {
                 'page': page,
                 'limit': limit,
                 'sort': sort,
-                'enquiryId': enquiryId,
+            },
+            errors: {
+                400: `If the filter options or query parameters contain invalid values`,
+                401: `Unauthorized - Missing or invalid Authorization header`,
+                500: `When an internal server error occurs when listing all related snapshots`,
+                503: `Service Unavailable - The server is temporarily unable to handle the request`,
             },
         });
     }
     /**
      * Get Snapshot va ID
-     * Returns the specific snapshot
+     * Returns the specific snapshot given its Id
      * @param snapshotId
      * @returns any OK
      * @throws ApiError
@@ -52,13 +86,18 @@ export class ItineraryService {
             path: {
                 'snapshotId': snapshotId,
             },
+            errors: {
+                401: `Unauthorized - Missing or invalid Authorization header`,
+                404: `If the snapshot does not exist`,
+                503: `Service Unavailable - The server is temporarily unable to handle the request`,
+            },
         });
     }
     /**
      * Delete Snapshot via ID
-     * Deletes a specific snapshot
+     * Deletes a specific snapshot given its Id
      * @param snapshotId
-     * @returns any OK
+     * @returns void
      * @throws ApiError
      */
     snapshotDelete(snapshotId) {
@@ -68,13 +107,19 @@ export class ItineraryService {
             path: {
                 'snapshotId': snapshotId,
             },
+            errors: {
+                400: `When the snapshot doesn't exist in the first place, or when a before hook fails before deleting the item`,
+                401: `Unauthorized - Missing or invalid Authorization header`,
+                500: `When the snapshot fails to delete due to an internal server error`,
+                503: `Service Unavailable - The server is temporarily unable to handle the request`,
+            },
         });
     }
     /**
      * Restore Snapshot
      * Creates a new itinerary revision given the content the snapshot refers to
      * @param snapshotId
-     * @returns any OK
+     * @returns any When a snapshot is restored as the latest version
      * @throws ApiError
      */
     snapshotRestore(snapshotId) {
@@ -84,6 +129,13 @@ export class ItineraryService {
             path: {
                 'snapshotId': snapshotId,
             },
+            errors: {
+                400: `If the payload is malformed`,
+                401: `Unauthorized - Missing or invalid Authorization header`,
+                404: `If the snapshot or itinerary to restore to does not exist`,
+                500: `When the snapshot fails to restore due to an internal server error`,
+                503: `Service Unavailable - The server is temporarily unable to handle the request`,
+            },
         });
     }
     /**
@@ -94,7 +146,7 @@ export class ItineraryService {
      * @param search Search term
      * @param sort List of fields to sort by
      * @param enquiryId Filter itineraries via enquiryId
-     * @returns any OK
+     * @returns any The list of all itineraries given the parameters used
      * @throws ApiError
      */
     itineraryList(page, limit, search, sort, enquiryId) {
@@ -108,13 +160,19 @@ export class ItineraryService {
                 'sort': sort,
                 'enquiryId': enquiryId,
             },
+            errors: {
+                400: `If the filter options or query parameters contain invalid values`,
+                401: `Unauthorized - Missing or invalid Authorization header`,
+                500: `When an internal server error occurs when listing all related itineraries`,
+                503: `Service Unavailable - The server is temporarily unable to handle the request`,
+            },
         });
     }
     /**
-     * Create Itinerary
-     * Creates an itinerary
+     * Create an Itinerary
+     * Creates a new itinerary
      * @param requestBody
-     * @returns DTOItineraryRead OK
+     * @returns DTOItineraryRead When a itinerary is created
      * @throws ApiError
      */
     itineraryCreate(requestBody) {
@@ -123,13 +181,19 @@ export class ItineraryService {
             url: '/itineraries',
             body: requestBody,
             mediaType: 'application/json',
+            errors: {
+                400: `If the payload is malformed`,
+                401: `Unauthorized - Missing or invalid Authorization header`,
+                500: `When an internal server error occurs when creating a itinerary entity`,
+                503: `Service Unavailable - The server is temporarily unable to handle the request`,
+            },
         });
     }
     /**
      * Get Itinerary
      * Get itinerary via ID
      * @param itineraryId Itinerary id
-     * @returns DTOItineraryRead OK
+     * @returns any OK
      * @throws ApiError
      */
     itineraryGet(itineraryId) {
@@ -139,17 +203,22 @@ export class ItineraryService {
             path: {
                 'itineraryId': itineraryId,
             },
+            errors: {
+                401: `Unauthorized - Missing or invalid Authorization header`,
+                404: `If the itinerary does not exist`,
+                503: `Service Unavailable - The server is temporarily unable to handle the request`,
+            },
         });
     }
     /**
-     * Update Itinerary
+     * Update Itinerary as New Revision
      * Updates an itinerary as a new revision
      * @param itineraryId Itinerary id
      * @param requestBody
-     * @returns DTOItineraryRead OK
+     * @returns DTOItineraryRead When a new revision is created successfully
      * @throws ApiError
      */
-    itineraryUpdate(itineraryId, requestBody) {
+    itineraryUpdateAsNewRevision(itineraryId, requestBody) {
         return __request(OpenAPI, {
             method: 'PATCH',
             url: '/itineraries/{itineraryId}',
@@ -158,13 +227,20 @@ export class ItineraryService {
             },
             body: requestBody,
             mediaType: 'application/json',
+            errors: {
+                400: `If the payload is malformed`,
+                401: `Unauthorized - Missing or invalid Authorization header`,
+                404: `When the itinerary id to create a new revision from is not found`,
+                500: `When an internal server error occurs updating an itinerary as a new revision`,
+                503: `Service Unavailable - The server is temporarily unable to handle the request`,
+            },
         });
     }
     /**
-     * Delete Itinerary
-     * Delete itinerary via ID
+     * Delete Itinerary via ID
+     * Deletes a specific itinerary given its Id
      * @param itineraryId Itinerary id
-     * @returns any OK
+     * @returns void
      * @throws ApiError
      */
     itineraryDelete(itineraryId) {
@@ -174,22 +250,35 @@ export class ItineraryService {
             path: {
                 'itineraryId': itineraryId,
             },
+            errors: {
+                400: `When the itinerary doesn't exist in the first place, or when a before hook fails before deleting the item`,
+                401: `Unauthorized - Missing or invalid Authorization header`,
+                500: `When the itinerary fails to delete due to an internal server error`,
+                503: `Service Unavailable - The server is temporarily unable to handle the request`,
+            },
         });
     }
     /**
      * Sync Itinerary
      * Sync an itinerary with swoop
      * @param itineraryId Itinerary id
-     * @returns DTOItineraryRead OK
+     * @returns DTOItineraryRead When an itinerary has been posted to pub/sub successfully
      * @throws ApiError
      */
-    sync(itineraryId) {
+    syncItinerary(itineraryId) {
         return __request(OpenAPI, {
             method: 'POST',
             url: '/sync/{itineraryId}',
             path: {
                 'itineraryId': itineraryId,
             },
+            errors: {
+                400: `When the itinerary to sync does not exist`,
+                401: `Unauthorized - Missing or invalid Authorization header`,
+                404: `Related entity not found`,
+                500: `When an internal server error occurs whilst syncing`,
+                503: `Service Unavailable - The server is temporarily unable to handle the request`,
+            },
         });
     }
     /**
@@ -210,6 +299,12 @@ export class ItineraryService {
                 'limit': limit,
                 'sort': sort,
             },
+            errors: {
+                400: `If the filter options or query parameters contain invalid values`,
+                401: `Unauthorized - Missing or invalid Authorization header`,
+                500: `When an internal server error occurs when listing all related regions`,
+                503: `Service Unavailable - The server is temporarily unable to handle the request`,
+            },
         });
     }
     /**
@@ -225,6 +320,12 @@ export class ItineraryService {
             url: '/regions',
             body: requestBody,
             mediaType: 'application/json',
+            errors: {
+                400: `If the payload is malformed`,
+                401: `Unauthorized - Missing or invalid Authorization header`,
+                500: `When an internal server error occurs when creating a region entity`,
+                503: `Service Unavailable - The server is temporarily unable to handle the request`,
+            },
         });
     }
 }

package/dist/rendering/components/ComponentPicker.d.ts

@@ -7,5 +7,5 @@ interface ComponentPickerModalProps {
     selectedComponent?: DTOComponentRead | null;
     parentIdsFilter?: Array<string>;
 }
-export default function ComponentPickerModal({ open, onClose, onSelect, selectedComponent, parentIdsFilter }: ComponentPickerModalProps): React.JSX.Element;
+export default function ComponentPickerModal({ open, onClose, onSelect, selectedComponent, parentIdsFilter, }: ComponentPickerModalProps): React.JSX.Element;
 export {};

package/dist/rendering/components/ComponentPicker.js

@@ -13,7 +13,7 @@ import { Search as SearchIcon, Clear as ClearIcon, FilterList as FilterIcon, } f
 import { PARTNER_REGION_READABLE } from "../consts/region";
 import { fetchComponents, getAllPartners } from "../util/api";
 import { InternalServices } from "../../api/init";
-export default function ComponentPickerModal({ open, onClose, onSelect, selectedComponent, parentIdsFilter }) {
+export default function ComponentPickerModal({ open, onClose, onSelect, selectedComponent, parentIdsFilter, }) {
     const [searchTerm, setSearchTerm] = useState("");
     const [selectedRegion, setSelectedRegion] = useState("");
     const [selectedPartner, setSelectedPartner] = useState("");
@@ -43,7 +43,14 @@ export default function ComponentPickerModal({ open, onClose, onSelect, selected
         if (open) {
             fetchFilteredComponents();
         }
-    }, [open, debouncedSearchTerm, selectedRegion, selectedPartner, selectedTemplate, page]);
+    }, [
+        open,
+        debouncedSearchTerm,
+        selectedRegion,
+        selectedPartner,
+        selectedTemplate,
+        page,
+    ]);
     useEffect(() => {
         if (open) {
             setPage(1);
@@ -67,7 +74,7 @@ export default function ComponentPickerModal({ open, onClose, onSelect, selected
             ]);
             setTemplates(templatesData.data);
             setPartners(partnersData);
-            setRegions(regionsData.data);
+            setRegions((regionsData.data || []));
         }
         catch (error) {
             console.error("Error loading initial data:", error);
@@ -121,9 +128,9 @@ export default function ComponentPickerModal({ open, onClose, onSelect, selected
         onClose();
     };
     const getComponentDetails = (component) => {
-        const template = templates.find(t => t.id === component.templateId);
-        const componentPartners = partners.filter(p => { var _a; return p.id && ((_a = component.partners) === null || _a === void 0 ? void 0 : _a.includes(p.id)); });
-        const componentRegions = regions.filter(r => { var _a; return (_a = component.regions) === null || _a === void 0 ? void 0 : _a.includes(r.id); });
+        const template = templates.find((t) => t.id === component.templateId);
+        const componentPartners = partners.filter((p) => { var _a; return p.id && ((_a = component.partners) === null || _a === void 0 ? void 0 : _a.includes(p.id)); });
+        const componentRegions = regions.filter((r) => { var _a; return (_a = component.regions) === null || _a === void 0 ? void 0 : _a.includes(r.id); });
         return { template, partners: componentPartners, regions: componentRegions };
     };
     const hasActiveFilters = selectedRegion || selectedPartner || selectedTemplate;
@@ -141,24 +148,23 @@ export default function ComponentPickerModal({ open, onClose, onSelect, selected
                 hasActiveFilters && (React.createElement(Button, { size: "small", startIcon: React.createElement(ClearIcon, null), onClick: handleClearFilters }, "Clear Filters")))),
         React.createElement(DialogContent, { dividers: true },
             React.createElement(TextField, { fullWidth: true, placeholder: "Search components...", value: searchTerm, onChange: (e) => setSearchTerm(e.target.value), InputProps: {
-                    startAdornment: React.createElement(InputAdornment, { position: "start" },
-                        React.createElement(SearchIcon, null)),
+                    startAdornment: (React.createElement(InputAdornment, { position: "start" },
+                        React.createElement(SearchIcon, null))),
                     endAdornment: searchTerm && (React.createElement(InputAdornment, { position: "end" },
                         React.createElement(IconButton, { size: "small", onClick: handleClearSearch },
                             React.createElement(ClearIcon, null)))),
                 }, sx: { mb: 2 } }),
             React.createElement(Box, { display: "flex", gap: 2, mb: 2, flexWrap: "wrap" },
-                React.createElement(Autocomplete, { size: "small", options: usedRegions, getOptionLabel: (option) => option.name, value: usedRegions.find(r => r.id === selectedRegion) || null, onChange: (_, newValue) => setSelectedRegion((newValue === null || newValue === void 0 ? void 0 : newValue.id) || ""), renderInput: (params) => React.createElement(TextField, Object.assign({}, params, { label: "Region" })), sx: { minWidth: 160 }, isOptionEqualToValue: (option, value) => option.id === value.id }),
+                React.createElement(Autocomplete, { size: "small", options: usedRegions, getOptionLabel: (option) => option.name, value: usedRegions.find((r) => r.id === selectedRegion) || null, onChange: (_, newValue) => setSelectedRegion((newValue === null || newValue === void 0 ? void 0 : newValue.id) || ""), renderInput: (params) => React.createElement(TextField, Object.assign({}, params, { label: "Region" })), sx: { minWidth: 160 }, isOptionEqualToValue: (option, value) => option.id === value.id }),
                 React.createElement(TextField, { select: true, size: "small", label: "Partner", value: selectedPartner, onChange: (e) => setSelectedPartner(e.target.value), sx: { minWidth: 160 } },
                     React.createElement(MenuItem, { value: "" }, "All Partners"),
                     usedPartners.map((partner) => (React.createElement(MenuItem, { key: partner.id, value: partner.id }, partner.name)))),
-                !(parentIdsFilter === null || parentIdsFilter === void 0 ? void 0 : parentIdsFilter.length) &&
-                    React.createElement(TextField, { select: true, size: "small", label: "Type", value: selectedTemplate, onChange: (e) => setSelectedTemplate(e.target.value), sx: { minWidth: 160 } },
-                        React.createElement(MenuItem, { value: "" }, "All Types"),
-                        usedTemplates.map((template) => (React.createElement(MenuItem, { key: template.id, value: template.id },
-                            template.name,
-                            " v",
-                            template.revision))))),
+                !(parentIdsFilter === null || parentIdsFilter === void 0 ? void 0 : parentIdsFilter.length) && (React.createElement(TextField, { select: true, size: "small", label: "Type", value: selectedTemplate, onChange: (e) => setSelectedTemplate(e.target.value), sx: { minWidth: 160 } },
+                    React.createElement(MenuItem, { value: "" }, "All Types"),
+                    usedTemplates.map((template) => (React.createElement(MenuItem, { key: template.id, value: template.id },
+                        template.name,
+                        " v",
+                        template.revision)))))),
             React.createElement(Box, { display: "flex", alignItems: "center", gap: 2, mb: 1 },
                 React.createElement(Typography, { variant: "body2", color: "text.secondary" },
                     totalCount,
@@ -166,7 +172,12 @@ export default function ComponentPickerModal({ open, onClose, onSelect, selected
                     totalCount !== 1 ? "s" : "",
                     " found"),
                 loading && React.createElement(CircularProgress, { size: 16 })),
-            React.createElement(List, { sx: { display: "flex", flexDirection: "column", flex: 1, overflow: "auto" } }, loading && components.length === 0 ? (React.createElement(Box, { display: "flex", flexDirection: "column", alignItems: "center", justifyContent: "center", py: 4 },
+            React.createElement(List, { sx: {
+                    display: "flex",
+                    flexDirection: "column",
+                    flex: 1,
+                    overflow: "auto",
+                } }, loading && components.length === 0 ? (React.createElement(Box, { display: "flex", flexDirection: "column", alignItems: "center", justifyContent: "center", py: 4 },
                 React.createElement(CircularProgress, { size: 48, sx: { mb: 2 } }),
                 React.createElement(Typography, { variant: "body1", color: "text.secondary" }, "Loading components..."))) : components.length === 0 ? (React.createElement(Box, { display: "flex", flexDirection: "column", alignItems: "center", justifyContent: "center", py: 4 },
                 React.createElement(FilterIcon, { sx: { fontSize: 48, color: "text.secondary", mb: 2 } }),
@@ -193,10 +204,12 @@ export default function ComponentPickerModal({ open, onClose, onSelect, selected
                                             details.template.name)),
                                         details.regions.length > 0 && (React.createElement(Box, { display: "flex", alignItems: "center", gap: 1, mt: 0.5 },
                                             React.createElement(Typography, { variant: "body2", color: "text.secondary" }, "Regions:"),
-                                            details.regions.map(region => (React.createElement(Chip, { key: region.id, label: region.name, size: "small", variant: "outlined" }))))),
+                                            details.regions.map((region) => (React.createElement(Chip, { key: region.id, label: region.name, size: "small", variant: "outlined" }))))),
                                         details.partners.length > 0 && (React.createElement(Box, { display: "flex", alignItems: "center", gap: 1, mt: 0.5 },
                                             React.createElement(Typography, { variant: "body2", color: "text.secondary" }, "Partners:"),
-                                            details.partners.slice(0, 3).map(partner => (React.createElement(Chip, { key: partner.id, label: `${partner.name} - ${PARTNER_REGION_READABLE[partner.id || "".split("-")[0]]}`, size: "small", variant: "outlined", color: "secondary" }))),
+                                            details.partners
+                                                .slice(0, 3)
+                                                .map((partner) => (React.createElement(Chip, { key: partner.id, label: `${partner.name} - ${PARTNER_REGION_READABLE[partner.id || "".split("-")[0]]}`, size: "small", variant: "outlined", color: "secondary" }))),
                                             details.partners.length > 3 && (React.createElement(Typography, { variant: "body2", color: "text.secondary" },
                                                 "+",
                                                 details.partners.length - 3,

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "swoop-common",
-    "version": "2.1.49",
+    "version": "2.1.50",
     "main": "dist/api/index.js",
     "types": "dist/api/index.d.ts",
     "exports": {
@@ -42,6 +42,7 @@
         "@jsonforms/react": "^3.5.1",
         "ajv": "^8.17.1",
         "js-yaml": "^4.1.0",
+        "lodash.merge": "^4.6.2",
         "openapi-ts": "^0.3.4",
         "react": "^19.0.0",
         "rimraf": "^6.0.1"
@@ -49,6 +50,8 @@
     "devDependencies": {
         "@apidevtools/swagger-cli": "^4.0.4",
         "@hey-api/openapi-ts": "^0.80.2",
+        "@types/js-yaml": "^4.0.9",
+        "@types/lodash.merge": "^4.6.9",
         "@types/node": "^24.0.14",
         "@types/react": "^19",
         "openapi-typescript-codegen": "^0.29.0",