@lukoweb/apitogo 0.1.23 → 0.1.37

package/src/zuplo/enrich-with-zuplo.ts

@@ -1,256 +1,256 @@
-import type { OpenAPIV3_1 } from "openapi-types";
-import type { ProcessorArg } from "../config/validators/BuildSchema.js";
-import { objectEntries } from "../lib/util/objectEntries.js";
-import type { RecordAny } from "../lib/util/traverse.js";
-import type {
-  PoliciesConfigFile,
-  PolicyConfigurationFragment,
-} from "./policy-types.js";
-
-const API_KEY_REPLACEMENT_STRING = "YOUR_KEY_HERE";
-
-const enrichWithApiKeyData = (
-  operationObject: RecordAny,
-  apiKeyPolicies: PolicyConfigurationFragment[],
-) => {
-  if (apiKeyPolicies.length === 0) {
-    return operationObject;
-  }
-
-  const firstPolicy = apiKeyPolicies[0];
-  const authorizationHeader =
-    (firstPolicy?.handler.options?.authHeader as string) || "Authorization";
-  const authorizationScheme = (firstPolicy?.handler.options?.authScheme ??
-    "Bearer") as string;
-  const authSchemeExample =
-    authorizationScheme !== ""
-      ? `${authorizationScheme} ${API_KEY_REPLACEMENT_STRING}`
-      : API_KEY_REPLACEMENT_STRING;
-
-  // Add API key header parameter
-  const apiKeyHeader: OpenAPIV3_1.ParameterObject = {
-    name: authorizationHeader,
-    in: "header",
-    required: true,
-    example: authSchemeExample,
-    schema: {
-      type: "string",
-    },
-    description: `The \`${authorizationHeader}\` header is used to authenticate with the API using your API key. Value is of the format \`${authSchemeExample}\`.`,
-  };
-
-  const parameters = operationObject.parameters || [];
-  if (
-    !parameters.some((param: RecordAny) => param.name === authorizationHeader)
-  ) {
-    operationObject.parameters = [apiKeyHeader, ...parameters];
-  }
-
-  // Add security scheme and requirement
-  const apiSecuritySchemeId = "api_key";
-  const apiKeySecurityRequirement = { [apiSecuritySchemeId]: [] };
-
-  if (!operationObject.security) {
-    operationObject.security = [apiKeySecurityRequirement];
-  } else if (
-    !operationObject.security.some((req: RecordAny) => req[apiSecuritySchemeId])
-  ) {
-    operationObject.security = [
-      apiKeySecurityRequirement,
-      ...operationObject.security,
-    ];
-  }
-
-  return operationObject;
-};
-
-const enrichWithRateLimitData = (
-  operationObject: RecordAny,
-  rateLimitPolicies: PolicyConfigurationFragment[],
-) => {
-  if (rateLimitPolicies.length === 0) {
-    return operationObject;
-  }
-
-  const shouldIncludeHeader = rateLimitPolicies.some(
-    (policy) => policy.handler.options?.headerMode !== "none",
-  );
-
-  if (!operationObject.responses) {
-    operationObject.responses = {};
-  }
-
-  if (!operationObject.responses["429"]) {
-    operationObject.responses["429"] = {
-      $ref: shouldIncludeHeader
-        ? "#/components/responses/RateLimitWithRetryAfter"
-        : "#/components/responses/RateLimitNoRetryAfter",
-    };
-  }
-
-  return operationObject;
-};
-
-// prettier-ignore
-export const operations = [
-  "get", "put", "post", "delete",
-  "options", "head", "patch", "trace",
-];
-
-const rateLimitingResponse: OpenAPIV3_1.ResponseObject = {
-  description: "Rate Limiting Response",
-  content: {
-    "application/json": {
-      schema: {
-        type: "object",
-        required: ["type", "title", "status"],
-        examples: [
-          {
-            type: "https://httpproblems.com/http-status/429",
-            title: "Too Many Requests",
-            status: 429,
-            instance: "/foo/bar",
-          },
-        ],
-        properties: {
-          type: {
-            type: "string",
-            example: "https://httpproblems.com/http-status/429",
-            description: "A URI reference that identifies the problem.",
-          },
-          title: {
-            type: "string",
-            example: "Too Many Requests",
-            description: "A short, human-readable summary of the problem.",
-          },
-          status: {
-            type: "number",
-            example: 429,
-            description: "The HTTP status code.",
-          },
-          instance: {
-            type: "string",
-            example: "/foo/bar",
-          },
-        },
-      },
-    },
-  },
-};
-
-const rateLimitingResponseWithHeader: OpenAPIV3_1.ResponseObject = {
-  ...rateLimitingResponse,
-  headers: {
-    "retry-after": {
-      description: "The number of seconds to wait before making a new request.",
-      schema: {
-        type: "integer",
-        example: 60,
-      },
-    },
-  },
-};
-
-export const enrichWithZuploData = ({
-  policiesConfig,
-}: {
-  policiesConfig: PoliciesConfigFile;
-}) => {
-  return ({ schema }: ProcessorArg) => {
-    if (!schema.paths) return schema;
-
-    let hasRateLimitPolicies = false;
-
-    for (const [, pathItem] of objectEntries<RecordAny>(schema.paths)) {
-      for (const method of operations) {
-        const operation = pathItem[method];
-        if (!operation?.["x-zuplo-route"]) continue;
-
-        const inboundPolicies = operation[
-          "x-zuplo-route"
-        ]?.policies?.inbound?.reduce((acc: string[], policyName: string) => {
-          const policy = policiesConfig.policies?.find(
-            ({ name }) => name === policyName,
-          );
-          if (!policy) return acc;
-
-          // Handle composite policies
-          if (policy.handler.export === "CompositeInboundPolicy") {
-            const childPolicies = policy.handler.options?.policies as
-              | string[]
-              | undefined;
-            return childPolicies ? [...acc, ...childPolicies] : acc;
-          }
-
-          return [...acc, policyName];
-        }, []);
-
-        if (!inboundPolicies) continue;
-
-        // Find API key policies
-        const apiKeyPolicies =
-          policiesConfig.policies?.filter(
-            (policy) =>
-              inboundPolicies.includes(policy.name) &&
-              (policy.handler.export === "ApiAuthKeyInboundPolicy" ||
-                policy.handler.export === "ApiKeyInboundPolicy" ||
-                policy.handler.export === "MonetizationInboundPolicy") &&
-              !policy.handler.options
-                ?.disableAutomaticallyAddingKeyHeaderToOpenApi,
-          ) ?? [];
-
-        // Find rate limit policies
-        const rateLimitPolicies =
-          policiesConfig.policies?.filter(
-            (policy) =>
-              inboundPolicies.includes(policy.name) &&
-              (policy.handler.export === "RateLimitInboundPolicy" ||
-                policy.handler.export === "ComplexRateLimitInboundPolicy"),
-          ) ?? [];
-
-        if (rateLimitPolicies.length > 0) {
-          hasRateLimitPolicies = true;
-        }
-
-        // Apply enrichments directly to the operation
-        pathItem[method] = enrichWithApiKeyData(operation, apiKeyPolicies);
-        pathItem[method] = enrichWithRateLimitData(
-          pathItem[method],
-          rateLimitPolicies,
-        );
-      }
-    }
-
-    // Add security scheme if we have API key policies
-    if (
-      policiesConfig.policies?.some(
-        (policy) =>
-          policy.handler.export === "ApiAuthKeyInboundPolicy" ||
-          policy.handler.export === "ApiKeyInboundPolicy" ||
-          policy.handler.export === "MonetizationInboundPolicy",
-      )
-    ) {
-      if (!schema.components) schema.components = {};
-      if (!schema.components.securitySchemes)
-        schema.components.securitySchemes = {};
-
-      if (!schema.components.securitySchemes.api_key) {
-        schema.components.securitySchemes.api_key = {
-          type: "http",
-          scheme: "bearer",
-        };
-      }
-    }
-
-    // Add rate limiting responses only if we found rate limiting policies
-    if (hasRateLimitPolicies) {
-      if (!schema.components) schema.components = {};
-      if (!schema.components.responses) schema.components.responses = {};
-      schema.components.responses.RateLimitNoRetryAfter = rateLimitingResponse;
-      schema.components.responses.RateLimitWithRetryAfter =
-        rateLimitingResponseWithHeader;
-    }
-
-    return schema;
-  };
-};
+import type { OpenAPIV3_1 } from "openapi-types";
+import type { ProcessorArg } from "../config/validators/BuildSchema.js";
+import { objectEntries } from "../lib/util/objectEntries.js";
+import type { RecordAny } from "../lib/util/traverse.js";
+import type {
+  PoliciesConfigFile,
+  PolicyConfigurationFragment,
+} from "./policy-types.js";
+
+const API_KEY_REPLACEMENT_STRING = "YOUR_KEY_HERE";
+
+const enrichWithApiKeyData = (
+  operationObject: RecordAny,
+  apiKeyPolicies: PolicyConfigurationFragment[],
+) => {
+  if (apiKeyPolicies.length === 0) {
+    return operationObject;
+  }
+
+  const firstPolicy = apiKeyPolicies[0];
+  const authorizationHeader =
+    (firstPolicy?.handler.options?.authHeader as string) || "Authorization";
+  const authorizationScheme = (firstPolicy?.handler.options?.authScheme ??
+    "Bearer") as string;
+  const authSchemeExample =
+    authorizationScheme !== ""
+      ? `${authorizationScheme} ${API_KEY_REPLACEMENT_STRING}`
+      : API_KEY_REPLACEMENT_STRING;
+
+  // Add API key header parameter
+  const apiKeyHeader: OpenAPIV3_1.ParameterObject = {
+    name: authorizationHeader,
+    in: "header",
+    required: true,
+    example: authSchemeExample,
+    schema: {
+      type: "string",
+    },
+    description: `The \`${authorizationHeader}\` header is used to authenticate with the API using your API key. Value is of the format \`${authSchemeExample}\`.`,
+  };
+
+  const parameters = operationObject.parameters || [];
+  if (
+    !parameters.some((param: RecordAny) => param.name === authorizationHeader)
+  ) {
+    operationObject.parameters = [apiKeyHeader, ...parameters];
+  }
+
+  // Add security scheme and requirement
+  const apiSecuritySchemeId = "api_key";
+  const apiKeySecurityRequirement = { [apiSecuritySchemeId]: [] };
+
+  if (!operationObject.security) {
+    operationObject.security = [apiKeySecurityRequirement];
+  } else if (
+    !operationObject.security.some((req: RecordAny) => req[apiSecuritySchemeId])
+  ) {
+    operationObject.security = [
+      apiKeySecurityRequirement,
+      ...operationObject.security,
+    ];
+  }
+
+  return operationObject;
+};
+
+const enrichWithRateLimitData = (
+  operationObject: RecordAny,
+  rateLimitPolicies: PolicyConfigurationFragment[],
+) => {
+  if (rateLimitPolicies.length === 0) {
+    return operationObject;
+  }
+
+  const shouldIncludeHeader = rateLimitPolicies.some(
+    (policy) => policy.handler.options?.headerMode !== "none",
+  );
+
+  if (!operationObject.responses) {
+    operationObject.responses = {};
+  }
+
+  if (!operationObject.responses["429"]) {
+    operationObject.responses["429"] = {
+      $ref: shouldIncludeHeader
+        ? "#/components/responses/RateLimitWithRetryAfter"
+        : "#/components/responses/RateLimitNoRetryAfter",
+    };
+  }
+
+  return operationObject;
+};
+
+// prettier-ignore
+export const operations = [
+  "get", "put", "post", "delete",
+  "options", "head", "patch", "trace",
+];
+
+const rateLimitingResponse: OpenAPIV3_1.ResponseObject = {
+  description: "Rate Limiting Response",
+  content: {
+    "application/json": {
+      schema: {
+        type: "object",
+        required: ["type", "title", "status"],
+        examples: [
+          {
+            type: "https://httpproblems.com/http-status/429",
+            title: "Too Many Requests",
+            status: 429,
+            instance: "/foo/bar",
+          },
+        ],
+        properties: {
+          type: {
+            type: "string",
+            example: "https://httpproblems.com/http-status/429",
+            description: "A URI reference that identifies the problem.",
+          },
+          title: {
+            type: "string",
+            example: "Too Many Requests",
+            description: "A short, human-readable summary of the problem.",
+          },
+          status: {
+            type: "number",
+            example: 429,
+            description: "The HTTP status code.",
+          },
+          instance: {
+            type: "string",
+            example: "/foo/bar",
+          },
+        },
+      },
+    },
+  },
+};
+
+const rateLimitingResponseWithHeader: OpenAPIV3_1.ResponseObject = {
+  ...rateLimitingResponse,
+  headers: {
+    "retry-after": {
+      description: "The number of seconds to wait before making a new request.",
+      schema: {
+        type: "integer",
+        example: 60,
+      },
+    },
+  },
+};
+
+export const enrichWithZuploData = ({
+  policiesConfig,
+}: {
+  policiesConfig: PoliciesConfigFile;
+}) => {
+  return ({ schema }: ProcessorArg) => {
+    if (!schema.paths) return schema;
+
+    let hasRateLimitPolicies = false;
+
+    for (const [, pathItem] of objectEntries<RecordAny>(schema.paths)) {
+      for (const method of operations) {
+        const operation = pathItem[method];
+        if (!operation?.["x-zuplo-route"]) continue;
+
+        const inboundPolicies = operation[
+          "x-zuplo-route"
+        ]?.policies?.inbound?.reduce((acc: string[], policyName: string) => {
+          const policy = policiesConfig.policies?.find(
+            ({ name }) => name === policyName,
+          );
+          if (!policy) return acc;
+
+          // Handle composite policies
+          if (policy.handler.export === "CompositeInboundPolicy") {
+            const childPolicies = policy.handler.options?.policies as
+              | string[]
+              | undefined;
+            return childPolicies ? [...acc, ...childPolicies] : acc;
+          }
+
+          return [...acc, policyName];
+        }, []);
+
+        if (!inboundPolicies) continue;
+
+        // Find API key policies
+        const apiKeyPolicies =
+          policiesConfig.policies?.filter(
+            (policy) =>
+              inboundPolicies.includes(policy.name) &&
+              (policy.handler.export === "ApiAuthKeyInboundPolicy" ||
+                policy.handler.export === "ApiKeyInboundPolicy" ||
+                policy.handler.export === "MonetizationInboundPolicy") &&
+              !policy.handler.options
+                ?.disableAutomaticallyAddingKeyHeaderToOpenApi,
+          ) ?? [];
+
+        // Find rate limit policies
+        const rateLimitPolicies =
+          policiesConfig.policies?.filter(
+            (policy) =>
+              inboundPolicies.includes(policy.name) &&
+              (policy.handler.export === "RateLimitInboundPolicy" ||
+                policy.handler.export === "ComplexRateLimitInboundPolicy"),
+          ) ?? [];
+
+        if (rateLimitPolicies.length > 0) {
+          hasRateLimitPolicies = true;
+        }
+
+        // Apply enrichments directly to the operation
+        pathItem[method] = enrichWithApiKeyData(operation, apiKeyPolicies);
+        pathItem[method] = enrichWithRateLimitData(
+          pathItem[method],
+          rateLimitPolicies,
+        );
+      }
+    }
+
+    // Add security scheme if we have API key policies
+    if (
+      policiesConfig.policies?.some(
+        (policy) =>
+          policy.handler.export === "ApiAuthKeyInboundPolicy" ||
+          policy.handler.export === "ApiKeyInboundPolicy" ||
+          policy.handler.export === "MonetizationInboundPolicy",
+      )
+    ) {
+      if (!schema.components) schema.components = {};
+      if (!schema.components.securitySchemes)
+        schema.components.securitySchemes = {};
+
+      if (!schema.components.securitySchemes.api_key) {
+        schema.components.securitySchemes.api_key = {
+          type: "http",
+          scheme: "bearer",
+        };
+      }
+    }
+
+    // Add rate limiting responses only if we found rate limiting policies
+    if (hasRateLimitPolicies) {
+      if (!schema.components) schema.components = {};
+      if (!schema.components.responses) schema.components.responses = {};
+      schema.components.responses.RateLimitNoRetryAfter = rateLimitingResponse;
+      schema.components.responses.RateLimitWithRetryAfter =
+        rateLimitingResponseWithHeader;
+    }
+
+    return schema;
+  };
+};

package/src/zuplo/policy-types.ts

@@ -1,46 +1,46 @@
-/**
- * This file was automatically generated by json-schema-to-typescript.
- * DO NOT MODIFY IT BY HAND. Instead, modify the source JSONSchema file,
- * and run json-schema-to-typescript to regenerate this file.
- */
-
-export interface PoliciesConfigFile {
-  policies?: PolicyConfigurationFragment[];
-  corsPolicies?: CorsPolicyConfiguration[];
-}
-export interface PolicyConfigurationFragment {
-  name: string;
-  policyType: string;
-  handler: HandlerDefinition;
-  options?: {
-    [k: string]: unknown;
-  };
-}
-export interface HandlerDefinition {
-  module: string;
-  export: string;
-  options?: {
-    [k: string]: unknown;
-  };
-}
-export interface CorsPolicyConfiguration {
-  name: string;
-  allowCredentials?: boolean;
-  maxAge?: number;
-  allowedOrigins: string[] | string;
-  allowedMethods?:
-    | (
-        | "GET"
-        | "HEAD"
-        | "POST"
-        | "PUT"
-        | "DELETE"
-        | "CONNECT"
-        | "OPTIONS"
-        | "TRACE"
-        | "PATCH"
-      )[]
-    | string;
-  allowedHeaders?: string[] | string;
-  exposeHeaders?: string[] | string;
-}
+/**
+ * This file was automatically generated by json-schema-to-typescript.
+ * DO NOT MODIFY IT BY HAND. Instead, modify the source JSONSchema file,
+ * and run json-schema-to-typescript to regenerate this file.
+ */
+
+export interface PoliciesConfigFile {
+  policies?: PolicyConfigurationFragment[];
+  corsPolicies?: CorsPolicyConfiguration[];
+}
+export interface PolicyConfigurationFragment {
+  name: string;
+  policyType: string;
+  handler: HandlerDefinition;
+  options?: {
+    [k: string]: unknown;
+  };
+}
+export interface HandlerDefinition {
+  module: string;
+  export: string;
+  options?: {
+    [k: string]: unknown;
+  };
+}
+export interface CorsPolicyConfiguration {
+  name: string;
+  allowCredentials?: boolean;
+  maxAge?: number;
+  allowedOrigins: string[] | string;
+  allowedMethods?:
+    | (
+        | "GET"
+        | "HEAD"
+        | "POST"
+        | "PUT"
+        | "DELETE"
+        | "CONNECT"
+        | "OPTIONS"
+        | "TRACE"
+        | "PATCH"
+      )[]
+    | string;
+  allowedHeaders?: string[] | string;
+  exposeHeaders?: string[] | string;
+}