@missioncontrolio/client 0.0.3

package/src/client/generated/publisher/index.ts

@@ -0,0 +1,55 @@
+/* tslint:disable */
+/* eslint-disable */
+// Generated by Microsoft Kiota
+// @ts-ignore
+import { createProblemDetailsFromDiscriminatorValue, createPublisherListResultFromDiscriminatorValue, type ProblemDetails, type PublisherListResult } from '../models/index.js';
+// @ts-ignore
+import { type BaseRequestBuilder, type Parsable, type ParsableFactory, type RequestConfiguration, type RequestInformation, type RequestsMetadata } from '@microsoft/kiota-abstractions';
+
+/**
+ * Builds and executes requests for operations under /Publisher
+ */
+export interface PublisherRequestBuilder extends BaseRequestBuilder<PublisherRequestBuilder> {
+    /**
+     * Note: This endpoint uses pagination by default, meaning it may not return all publishers in a single response if the partner has many publishers assigned. Please refer to pagination details for handling large result sets.
+     * @param requestConfiguration Configuration for the request such as headers, query parameters, and middleware options.
+     * @returns {Promise<PublisherListResult>}
+     * @throws {ProblemDetails} error when the service returns a 400 status code
+     * @throws {ProblemDetails} error when the service returns a 500 status code
+     */
+     get(requestConfiguration?: RequestConfiguration<PublisherRequestBuilderGetQueryParameters> | undefined) : Promise<PublisherListResult | undefined>;
+    /**
+     * Note: This endpoint uses pagination by default, meaning it may not return all publishers in a single response if the partner has many publishers assigned. Please refer to pagination details for handling large result sets.
+     * @param requestConfiguration Configuration for the request such as headers, query parameters, and middleware options.
+     * @returns {RequestInformation}
+     */
+     toGetRequestInformation(requestConfiguration?: RequestConfiguration<PublisherRequestBuilderGetQueryParameters> | undefined) : RequestInformation;
+}
+/**
+ * Note: This endpoint uses pagination by default, meaning it may not return all publishers in a single response if the partner has many publishers assigned. Please refer to pagination details for handling large result sets.
+ */
+export interface PublisherRequestBuilderGetQueryParameters {
+    pageIndex?: number;
+    pageSize?: number;
+}
+/**
+ * Uri template for the request builder.
+ */
+export const PublisherRequestBuilderUriTemplate = "{+baseurl}/Publisher{?pageIndex*,pageSize*}";
+/**
+ * Metadata for all the requests in the request builder.
+ */
+export const PublisherRequestBuilderRequestsMetadata: RequestsMetadata = {
+    get: {
+        uriTemplate: PublisherRequestBuilderUriTemplate,
+        responseBodyContentType: "application/json, text/plain;q=0.9",
+        errorMappings: {
+            400: createProblemDetailsFromDiscriminatorValue as ParsableFactory<Parsable>,
+            500: createProblemDetailsFromDiscriminatorValue as ParsableFactory<Parsable>,
+        },
+        adapterMethodName: "send",
+        responseBodyFactory:  createPublisherListResultFromDiscriminatorValue,
+    },
+};
+/* tslint:enable */
+/* eslint-enable */

package/src/client/generated/region/index.ts

@@ -0,0 +1,63 @@
+/* tslint:disable */
+/* eslint-disable */
+// Generated by Microsoft Kiota
+// @ts-ignore
+import { createProblemDetailsFromDiscriminatorValue, createRegionListResultFromDiscriminatorValue, type ProblemDetails, type RegionListResult } from '../models/index.js';
+// @ts-ignore
+import { type BaseRequestBuilder, type Guid, type Parsable, type ParsableFactory, type RequestConfiguration, type RequestInformation, type RequestsMetadata } from '@microsoft/kiota-abstractions';
+
+/**
+ * Builds and executes requests for operations under /Region
+ */
+export interface RegionRequestBuilder extends BaseRequestBuilder<RegionRequestBuilder> {
+    /**
+     * Note: This endpoint uses pagination by default, so not all regions may be returned in a single response. Please refer to pagination details for managing large result sets.
+     * @param requestConfiguration Configuration for the request such as headers, query parameters, and middleware options.
+     * @returns {Promise<RegionListResult>}
+     * @throws {ProblemDetails} error when the service returns a 400 status code
+     * @throws {ProblemDetails} error when the service returns a 500 status code
+     */
+     get(requestConfiguration?: RequestConfiguration<RegionRequestBuilderGetQueryParameters> | undefined) : Promise<RegionListResult | undefined>;
+    /**
+     * Note: This endpoint uses pagination by default, so not all regions may be returned in a single response. Please refer to pagination details for managing large result sets.
+     * @param requestConfiguration Configuration for the request such as headers, query parameters, and middleware options.
+     * @returns {RequestInformation}
+     */
+     toGetRequestInformation(requestConfiguration?: RequestConfiguration<RegionRequestBuilderGetQueryParameters> | undefined) : RequestInformation;
+}
+/**
+ * Note: This endpoint uses pagination by default, so not all regions may be returned in a single response. Please refer to pagination details for managing large result sets.
+ */
+export interface RegionRequestBuilderGetQueryParameters {
+    /**
+     * Specifies whether to include archived records in the result set.  If set to `true`, both archived and non-archived records will be included.  If set to `false` (default), only non-archived records will be returned.
+     */
+    includeArchived?: boolean;
+    pageIndex?: number;
+    pageSize?: number;
+    /**
+     * The ID of the publisher for which to retrieve the regions. A list of available publishers can be retrieved using the GET Publisher endpoint.
+     */
+    publisherId?: Guid;
+}
+/**
+ * Uri template for the request builder.
+ */
+export const RegionRequestBuilderUriTemplate = "{+baseurl}/Region?publisherId={publisherId}{&includeArchived*,pageIndex*,pageSize*}";
+/**
+ * Metadata for all the requests in the request builder.
+ */
+export const RegionRequestBuilderRequestsMetadata: RequestsMetadata = {
+    get: {
+        uriTemplate: RegionRequestBuilderUriTemplate,
+        responseBodyContentType: "application/json, text/plain;q=0.9",
+        errorMappings: {
+            400: createProblemDetailsFromDiscriminatorValue as ParsableFactory<Parsable>,
+            500: createProblemDetailsFromDiscriminatorValue as ParsableFactory<Parsable>,
+        },
+        adapterMethodName: "send",
+        responseBodyFactory:  createRegionListResultFromDiscriminatorValue,
+    },
+};
+/* tslint:enable */
+/* eslint-enable */

package/src/client/generated/reservation/index.ts

@@ -0,0 +1,71 @@
+/* tslint:disable */
+/* eslint-disable */
+// Generated by Microsoft Kiota
+// @ts-ignore
+import { createProblemDetailsFromDiscriminatorValue, createReservationFromDiscriminatorValue, serializeCreateReservationRequest, serializeReservation, type CreateReservationRequest, type ProblemDetails, type Reservation } from '../models/index.js';
+// @ts-ignore
+import { type WithReservationItemRequestBuilder, WithReservationItemRequestBuilderNavigationMetadata, WithReservationItemRequestBuilderRequestsMetadata } from './item/index.js';
+// @ts-ignore
+import { type BaseRequestBuilder, type Guid, type KeysToExcludeForNavigationMetadata, type NavigationMetadata, type Parsable, type ParsableFactory, type RequestConfiguration, type RequestInformation, type RequestsMetadata } from '@microsoft/kiota-abstractions';
+
+/**
+ * Builds and executes requests for operations under /Reservation
+ */
+export interface ReservationRequestBuilder extends BaseRequestBuilder<ReservationRequestBuilder> {
+    /**
+     * Gets an item from the missioncontrol.client.Reservation.item collection
+     * @param reservationId Unique identifier of the item
+     * @returns {WithReservationItemRequestBuilder}
+     */
+     byReservationId(reservationId: Guid) : WithReservationItemRequestBuilder;
+    /**
+     * Creates a reservation that later can be redeemed to create an order.Use this endpoint to temporarily reserve items before confirming them as an order.  The returned reservation can be redeemed using `POST /Order/claimReservation/{reservationId}`.
+     * @param body Request to send to create a reservation.
+     * @param requestConfiguration Configuration for the request such as headers, query parameters, and middleware options.
+     * @returns {Promise<Reservation>}
+     * @throws {ProblemDetails} error when the service returns a 400 status code
+     * @throws {ProblemDetails} error when the service returns a 500 status code
+     */
+     post(body: CreateReservationRequest, requestConfiguration?: RequestConfiguration<object> | undefined) : Promise<Reservation | undefined>;
+    /**
+     * Creates a reservation that later can be redeemed to create an order.Use this endpoint to temporarily reserve items before confirming them as an order.  The returned reservation can be redeemed using `POST /Order/claimReservation/{reservationId}`.
+     * @param body Request to send to create a reservation.
+     * @param requestConfiguration Configuration for the request such as headers, query parameters, and middleware options.
+     * @returns {RequestInformation}
+     */
+     toPostRequestInformation(body: CreateReservationRequest, requestConfiguration?: RequestConfiguration<object> | undefined) : RequestInformation;
+}
+/**
+ * Uri template for the request builder.
+ */
+export const ReservationRequestBuilderUriTemplate = "{+baseurl}/Reservation";
+/**
+ * Metadata for all the navigation properties in the request builder.
+ */
+export const ReservationRequestBuilderNavigationMetadata: Record<Exclude<keyof ReservationRequestBuilder, KeysToExcludeForNavigationMetadata>, NavigationMetadata> = {
+    byReservationId: {
+        requestsMetadata: WithReservationItemRequestBuilderRequestsMetadata,
+        navigationMetadata: WithReservationItemRequestBuilderNavigationMetadata,
+        pathParametersMappings: ["reservationId"],
+    },
+};
+/**
+ * Metadata for all the requests in the request builder.
+ */
+export const ReservationRequestBuilderRequestsMetadata: RequestsMetadata = {
+    post: {
+        uriTemplate: ReservationRequestBuilderUriTemplate,
+        responseBodyContentType: "application/json, text/plain;q=0.9",
+        errorMappings: {
+            400: createProblemDetailsFromDiscriminatorValue as ParsableFactory<Parsable>,
+            500: createProblemDetailsFromDiscriminatorValue as ParsableFactory<Parsable>,
+        },
+        adapterMethodName: "send",
+        responseBodyFactory:  createReservationFromDiscriminatorValue,
+        requestBodyContentType: "application/json",
+        requestBodySerializer: serializeCreateReservationRequest,
+        requestInformationContentSetMethod: "setContentFromParsable",
+    },
+};
+/* tslint:enable */
+/* eslint-enable */

package/src/client/generated/reservation/item/cancel/index.ts

@@ -0,0 +1,48 @@
+/* tslint:disable */
+/* eslint-disable */
+// Generated by Microsoft Kiota
+// @ts-ignore
+import { createProblemDetailsFromDiscriminatorValue, createReservationFromDiscriminatorValue, type ProblemDetails, type Reservation } from '../../../models/index.js';
+// @ts-ignore
+import { type BaseRequestBuilder, type Parsable, type ParsableFactory, type RequestConfiguration, type RequestInformation, type RequestsMetadata } from '@microsoft/kiota-abstractions';
+
+/**
+ * Builds and executes requests for operations under /Reservation/{reservationId}/cancel
+ */
+export interface CancelRequestBuilder extends BaseRequestBuilder<CancelRequestBuilder> {
+    /**
+     * Once canceled, the reservation can no longer be redeemed to create an order.  This is useful if the customer does not complete the purchase or abandons the checkout process.
+     * @param requestConfiguration Configuration for the request such as headers, query parameters, and middleware options.
+     * @returns {Promise<Reservation>}
+     * @throws {ProblemDetails} error when the service returns a 400 status code
+     * @throws {ProblemDetails} error when the service returns a 500 status code
+     */
+     post(requestConfiguration?: RequestConfiguration<object> | undefined) : Promise<Reservation | undefined>;
+    /**
+     * Once canceled, the reservation can no longer be redeemed to create an order.  This is useful if the customer does not complete the purchase or abandons the checkout process.
+     * @param requestConfiguration Configuration for the request such as headers, query parameters, and middleware options.
+     * @returns {RequestInformation}
+     */
+     toPostRequestInformation(requestConfiguration?: RequestConfiguration<object> | undefined) : RequestInformation;
+}
+/**
+ * Uri template for the request builder.
+ */
+export const CancelRequestBuilderUriTemplate = "{+baseurl}/Reservation/{reservationId}/cancel";
+/**
+ * Metadata for all the requests in the request builder.
+ */
+export const CancelRequestBuilderRequestsMetadata: RequestsMetadata = {
+    post: {
+        uriTemplate: CancelRequestBuilderUriTemplate,
+        responseBodyContentType: "application/json, text/plain;q=0.9",
+        errorMappings: {
+            400: createProblemDetailsFromDiscriminatorValue as ParsableFactory<Parsable>,
+            500: createProblemDetailsFromDiscriminatorValue as ParsableFactory<Parsable>,
+        },
+        adapterMethodName: "send",
+        responseBodyFactory:  createReservationFromDiscriminatorValue,
+    },
+};
+/* tslint:enable */
+/* eslint-enable */

package/src/client/generated/reservation/item/index.ts

@@ -0,0 +1,62 @@
+/* tslint:disable */
+/* eslint-disable */
+// Generated by Microsoft Kiota
+// @ts-ignore
+import { createProblemDetailsFromDiscriminatorValue, createReservationFromDiscriminatorValue, type ProblemDetails, type Reservation } from '../../models/index.js';
+// @ts-ignore
+import { CancelRequestBuilderRequestsMetadata, type CancelRequestBuilder } from './cancel/index.js';
+// @ts-ignore
+import { type BaseRequestBuilder, type KeysToExcludeForNavigationMetadata, type NavigationMetadata, type Parsable, type ParsableFactory, type RequestConfiguration, type RequestInformation, type RequestsMetadata } from '@microsoft/kiota-abstractions';
+
+/**
+ * Builds and executes requests for operations under /Reservation/{reservationId}
+ */
+export interface WithReservationItemRequestBuilder extends BaseRequestBuilder<WithReservationItemRequestBuilder> {
+    /**
+     * The cancel property
+     */
+    get cancel(): CancelRequestBuilder;
+    /**
+     * Gets a reservation by id
+     * @param requestConfiguration Configuration for the request such as headers, query parameters, and middleware options.
+     * @returns {Promise<Reservation>}
+     * @throws {ProblemDetails} error when the service returns a 400 status code
+     * @throws {ProblemDetails} error when the service returns a 500 status code
+     */
+     get(requestConfiguration?: RequestConfiguration<object> | undefined) : Promise<Reservation | undefined>;
+    /**
+     * Gets a reservation by id
+     * @param requestConfiguration Configuration for the request such as headers, query parameters, and middleware options.
+     * @returns {RequestInformation}
+     */
+     toGetRequestInformation(requestConfiguration?: RequestConfiguration<object> | undefined) : RequestInformation;
+}
+/**
+ * Uri template for the request builder.
+ */
+export const WithReservationItemRequestBuilderUriTemplate = "{+baseurl}/Reservation/{reservationId}";
+/**
+ * Metadata for all the navigation properties in the request builder.
+ */
+export const WithReservationItemRequestBuilderNavigationMetadata: Record<Exclude<keyof WithReservationItemRequestBuilder, KeysToExcludeForNavigationMetadata>, NavigationMetadata> = {
+    cancel: {
+        requestsMetadata: CancelRequestBuilderRequestsMetadata,
+    },
+};
+/**
+ * Metadata for all the requests in the request builder.
+ */
+export const WithReservationItemRequestBuilderRequestsMetadata: RequestsMetadata = {
+    get: {
+        uriTemplate: WithReservationItemRequestBuilderUriTemplate,
+        responseBodyContentType: "application/json, text/plain;q=0.9",
+        errorMappings: {
+            400: createProblemDetailsFromDiscriminatorValue as ParsableFactory<Parsable>,
+            500: createProblemDetailsFromDiscriminatorValue as ParsableFactory<Parsable>,
+        },
+        adapterMethodName: "send",
+        responseBodyFactory:  createReservationFromDiscriminatorValue,
+    },
+};
+/* tslint:enable */
+/* eslint-enable */

package/src/client/missionControlEnvironment.ts

@@ -0,0 +1,32 @@
+/**
+ * Represents a MissionControl API environment, encapsulating its base URL and OAuth scope.
+ */
+export enum MissionControlEnvironment {
+  /** https://api.sandbox.missioncontrol.io */
+  Sandbox = "Sandbox",
+
+  /** https://api.missioncontrol.io */
+  Production = "Production",
+}
+
+const settings: Record<
+  MissionControlEnvironment,
+  { baseUrl: string; scope: string }
+> = {
+  [MissionControlEnvironment.Sandbox]: {
+    baseUrl: "https://api.sandbox.missioncontrol.io",
+    scope: "api://38fbfaea-5648-4b51-ac09-d5d90117beff/.default",
+  },
+  [MissionControlEnvironment.Production]: {
+    baseUrl: "https://api.missioncontrol.io",
+    scope: "api://1b6f40bc-e051-4b7e-987f-47a4a19fa5ef/.default",
+  },
+};
+
+export function getBaseUrl(env: MissionControlEnvironment): string {
+  return settings[env].baseUrl;
+}
+
+export function getScope(env: MissionControlEnvironment): string {
+  return settings[env].scope;
+}

package/src/client/missionControlHandlers.ts

@@ -0,0 +1,61 @@
+import {
+  type Middleware,
+  MiddlewareFactory,
+  RetryHandler,
+  RetryHandlerOptions,
+} from "@microsoft/kiota-http-fetchlibrary";
+import { nonIdempotentPaths } from "./nonIdempotentPaths";
+import { AutoCancelOrderHandler } from "./autoCancelOrderHandler";
+import { PartnerIdHandler } from "./partnerIdHandler";
+
+function isNoRetryEndpoint(url: string): boolean {
+  try {
+    const { pathname } = new URL(url);
+    // Prefix match handles both fixed paths and parameterised ones.
+    return nonIdempotentPaths.some((prefix) =>
+      pathname.toLowerCase().startsWith(prefix.toLowerCase()),
+    );
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Builds the middleware stack for a MissionControl HTTP client.
+ *
+ * The default Kiota retry handler is replaced with a custom one that:
+ * - Never retries non-idempotent endpoints (createOrder, claimReservation, reportOrder),
+ *   since a retry could cause duplicate orders or reservations.
+ * - Retries on 429 Too Many Requests, 503 Service Unavailable, and 504 Gateway Timeout.
+ *
+ * The {@link AutoCancelOrderHandler} sits at the outermost position so it sees the final
+ * response after all retries are exhausted. Its compensating cancel request flows through
+ * the inner handlers and therefore picks up partner-id injection and retry behaviour.
+ */
+export function createHandlers(defaultPartnerId?: string): Middleware[] {
+  const retryOptions = new RetryHandlerOptions({
+    shouldRetry: (_delay, _attempt, request, _options, response) => {
+      if (isNoRetryEndpoint(request)) return false;
+      return (
+        response.status === 429 ||
+        response.status === 503 ||
+        response.status === 504
+      );
+    },
+  });
+
+  const middlewares = MiddlewareFactory.getDefaultMiddlewares();
+
+  // Replace the default RetryHandler with our custom-configured one.
+  const retryIndex = middlewares.findIndex((m) => m instanceof RetryHandler);
+  if (retryIndex !== -1) {
+    middlewares[retryIndex] = new RetryHandler(retryOptions);
+  }
+
+  if (defaultPartnerId) {
+    middlewares.unshift(new PartnerIdHandler(defaultPartnerId));
+  }
+  middlewares.unshift(new AutoCancelOrderHandler());
+
+  return middlewares;
+}

package/src/client/missionControlHeaders.ts

@@ -0,0 +1,10 @@
+/**
+ * Header names used by the MissionControl Partner API.
+ */
+export const MissionControlHeaders = {
+  /**
+   * Identifies the partner on whose behalf the request is made.
+   * This value is provided via the portal on the client credentials page.
+   */
+  PartnerId: "X-Partner-Id",
+} as const;

package/src/client/nonIdempotentPaths.ts

@@ -0,0 +1,9 @@
+/**
+ * Path prefixes for non-idempotent order-mutation endpoints.
+ * Used both to suppress retries and to trigger auto-cancel on failure.
+ */
+export const nonIdempotentPaths = [
+  "/Order/createOrder",
+  "/Order/claimReservation",
+  "/Order/reportOrder",
+] as const;

package/src/client/partnerIdHandler.ts

@@ -0,0 +1,33 @@
+import type { RequestOption } from "@microsoft/kiota-abstractions";
+import type { Middleware } from "@microsoft/kiota-http-fetchlibrary";
+import { MissionControlHeaders } from "./missionControlHeaders";
+
+/**
+ * A Kiota middleware that injects a default {@link MissionControlHeaders.PartnerId} header into
+ * every outgoing request. The header is only added when no value has already been set on the
+ * request, so a per-request override always takes precedence.
+ */
+export class PartnerIdHandler implements Middleware {
+  private readonly defaultPartnerId: string;
+  next: Middleware | undefined;
+
+  /**
+   * @param defaultPartnerId The partner ID to add to requests that do not already carry the header.
+   */
+  constructor(defaultPartnerId: string) {
+    this.defaultPartnerId = defaultPartnerId;
+  }
+
+  async execute(
+    url: string,
+    requestInit: RequestInit,
+    requestOptions?: Record<string, RequestOption>,
+  ): Promise<Response> {
+    const headers = new Headers(requestInit.headers);
+    if (!headers.has(MissionControlHeaders.PartnerId)) {
+      headers.set(MissionControlHeaders.PartnerId, this.defaultPartnerId);
+      requestInit = { ...requestInit, headers };
+    }
+    return this.next!.execute(url, requestInit, requestOptions);
+  }
+}