zudoku 0.0.0-monetization-standalone.zada7f04c → 0.0.0-money-plugin.z605c614d

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

@@ -0,0 +1,254 @@
+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;
+};
+
+// biome-ignore format: for readability
+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.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",
+      )
+    ) {
+      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

@@ -0,0 +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;
+}

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

@@ -0,0 +1,35 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { ZuploEnv } from "../app/env.js";
+import type {
+  Processor,
+  ProcessorArg,
+} from "../config/validators/BuildSchema.js";
+import { removeExtensions } from "../lib/plugins/openapi/processors/removeExtensions.js";
+import { removeParameters } from "../lib/plugins/openapi/processors/removeParameters.js";
+import { removePaths } from "../lib/plugins/openapi/processors/removePaths.js";
+import { enrichWithZuploData } from "./enrich-with-zuplo.js";
+import { enrichWithZuploMcpServerData } from "./enrich-with-zuplo-mcp.js";
+
+export const getProcessors = async (rootDir: string): Promise<Processor[]> => {
+  const policiesConfig = JSON.parse(
+    await fs.readFile(path.join(rootDir, "../config/policies.json"), "utf-8"),
+  );
+
+  return [
+    removePaths({ shouldRemove: ({ operation }) => operation["x-internal"] }),
+    removeParameters({
+      shouldRemove: ({ parameter }) => parameter["x-internal"],
+    }),
+    enrichWithZuploData({ policiesConfig }),
+    enrichWithZuploMcpServerData({ rootDir }),
+    ({ schema }: ProcessorArg) => {
+      const url = ZuploEnv.serverUrl;
+      if (!url) return schema;
+      return { ...schema, servers: [{ url }] };
+    },
+    removeExtensions({ shouldRemove: (key) => key.startsWith("x-zuplo") }),
+  ];
+};
+
+export default getProcessors;

package/src/zuplo/with-zuplo.ts

@@ -0,0 +1,14 @@
+import type { ZudokuConfig } from "../config/validators/validate.js";
+
+/**
+ *  @deprecated `withZuplo` is no longer needed and will automatically be applied. It will be removed in a future version.
+ */
+const withZuplo = (config: ZudokuConfig): ZudokuConfig => {
+  // biome-ignore lint/suspicious/noConsole: Logging allowed here
+  console.warn(
+    "`withZuplo` is no longer needed and will automatically be applied. It will be removed in a future version.",
+  );
+  return config;
+};
+
+export default withZuplo;

package/lib/Mermaid-DEztDKFw.js

@@ -1,102 +0,0 @@
-import { j as r } from "./jsx-runtime-BzflLqGi.js";
-import { e as f } from "./useSuspenseQuery-CSB_rVek.js";
-import { useId as p } from "react";
-import { c as g } from "./index-DI5SPFK9.js";
-import { c as i } from "./cn-5-Gd1Dss.js";
-import { a as v } from "./index-Ba6RP577.js";
-import { S as x } from "./Spinner-CI6bRyZw.js";
-const h = g(
-  "relative w-full rounded-lg border px-4 py-3 text-sm grid has-[>svg]:grid-cols-[calc(var(--spacing)*4)_1fr] grid-cols-[0_1fr] has-[>svg]:gap-x-3 gap-y-0.5 items-start [&>svg]:size-4 [&>svg]:translate-y-0.5 [&>svg]:text-current",
-  {
-    variants: {
-      variant: {
-        default: "bg-card text-card-foreground",
-        destructive: "text-destructive bg-card [&>svg]:text-current *:data-[slot=alert-description]:text-destructive/90"
-      }
-    },
-    defaultVariants: {
-      variant: "default"
-    }
-  }
-);
-function w({
-  className: e,
-  variant: t,
-  ...a
-}) {
-  return /* @__PURE__ */ r.jsx(
-    "div",
-    {
-      "data-slot": "alert",
-      role: "alert",
-      className: i(h({ variant: t }), e),
-      ...a
-    }
-  );
-}
-function y({ className: e, ...t }) {
-  return /* @__PURE__ */ r.jsx(
-    "div",
-    {
-      "data-slot": "alert-title",
-      className: i(
-        "col-start-2 line-clamp-1 min-h-4 font-medium tracking-tight",
-        e
-      ),
-      ...t
-    }
-  );
-}
-function j({
-  className: e,
-  ...t
-}) {
-  return /* @__PURE__ */ r.jsx(
-    "div",
-    {
-      "data-slot": "alert-description",
-      className: i(
-        "text-muted-foreground col-start-2 grid justify-items-start gap-1 text-sm [&_p]:leading-relaxed",
-        e
-      ),
-      ...t
-    }
-  );
-}
-let s = null;
-const b = () => (s || (s = import("mermaid").then((e) => e.default).catch((e) => {
-  throw new Error(
-    "Mermaid is not installed. Please install it with: npm install mermaid",
-    { cause: e }
-  );
-})), s), P = ({ chart: e, config: t, ...a }) => {
-  const d = p(), n = v(), {
-    data: m,
-    error: o,
-    isPending: c
-  } = f({
-    queryKey: ["mermaid", e, t, n.resolvedTheme],
-    queryFn: async () => {
-      const l = await b();
-      l.initialize({
-        theme: n.resolvedTheme === "dark" ? "dark" : "base",
-        ...t
-      });
-      const { svg: u } = await l.render(d, e);
-      return u;
-    },
-    enabled: typeof window < "u",
-    retry: !1
-  });
-  return o ? /* @__PURE__ */ r.jsxs(w, { className: "flex flex-col gap-2", variant: "destructive", children: [
-    /* @__PURE__ */ r.jsx(y, { children: "Mermaid Error" }),
-    /* @__PURE__ */ r.jsx(j, { className: "overflow-auto wrap-break-word whitespace-pre-wrap font-mono text-xs", children: o.message })
-  ] }) : c ? /* @__PURE__ */ r.jsx(x, {}) : /* @__PURE__ */ r.jsx("div", { ...a, dangerouslySetInnerHTML: { __html: m } });
-};
-export {
-  w as A,
-  P as M,
-  y as a,
-  j as b
-};
-//# sourceMappingURL=Mermaid-DEztDKFw.js.map

package/lib/Mermaid-DEztDKFw.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Mermaid-DEztDKFw.js","sources":["../src/lib/ui/Alert.tsx","../src/lib/components/Mermaid.tsx"],"sourcesContent":["import { cva, type VariantProps } from \"class-variance-authority\";\nimport type * as React from \"react\";\nimport { cn } from \"../util/cn.js\";\n\nconst alertVariants = cva(\n  \"relative w-full rounded-lg border px-4 py-3 text-sm grid has-[>svg]:grid-cols-[calc(var(--spacing)*4)_1fr] grid-cols-[0_1fr] has-[>svg]:gap-x-3 gap-y-0.5 items-start [&>svg]:size-4 [&>svg]:translate-y-0.5 [&>svg]:text-current\",\n  {\n    variants: {\n      variant: {\n        default: \"bg-card text-card-foreground\",\n        destructive:\n          \"text-destructive bg-card [&>svg]:text-current *:data-[slot=alert-description]:text-destructive/90\",\n      },\n    },\n    defaultVariants: {\n      variant: \"default\",\n    },\n  },\n);\n\nfunction Alert({\n  className,\n  variant,\n  ...props\n}: React.ComponentProps<\"div\"> & VariantProps<typeof alertVariants>) {\n  return (\n    <div\n      data-slot=\"alert\"\n      role=\"alert\"\n      className={cn(alertVariants({ variant }), className)}\n      {...props}\n    />\n  );\n}\n\nfunction AlertTitle({ className, ...props }: React.ComponentProps<\"div\">) {\n  return (\n    <div\n      data-slot=\"alert-title\"\n      className={cn(\n        \"col-start-2 line-clamp-1 min-h-4 font-medium tracking-tight\",\n        className,\n      )}\n      {...props}\n    />\n  );\n}\n\nfunction AlertDescription({\n  className,\n  ...props\n}: React.ComponentProps<\"div\">) {\n  return (\n    <div\n      data-slot=\"alert-description\"\n      className={cn(\n        \"text-muted-foreground col-start-2 grid justify-items-start gap-1 text-sm [&_p]:leading-relaxed\",\n        className,\n      )}\n      {...props}\n    />\n  );\n}\n\nexport { Alert, AlertDescription, AlertTitle };\n","import { useQuery } from \"@tanstack/react-query\";\nimport type { MermaidConfig } from \"mermaid\";\nimport type { ComponentProps } from \"react\";\nimport { useId } from \"react\";\nimport { Alert, AlertDescription, AlertTitle } from \"zudoku/ui/Alert.js\";\nimport { useTheme } from \"../hooks/index.js\";\nimport { Spinner } from \"./Spinner.js\";\n\nexport type MermaidProps = {\n  chart: string;\n  config?: MermaidConfig;\n} & ComponentProps<\"div\">;\n\nlet mermaidPromise: Promise<typeof import(\"mermaid\").default> | null = null;\n\nconst loadMermaid = () => {\n  if (!mermaidPromise) {\n    mermaidPromise = import(\"mermaid\")\n      .then((mod) => mod.default)\n      .catch((error) => {\n        throw new Error(\n          \"Mermaid is not installed. Please install it with: npm install mermaid\",\n          { cause: error },\n        );\n      });\n  }\n  return mermaidPromise;\n};\n\nexport const Mermaid = ({ chart, config, ...props }: MermaidProps) => {\n  const id = useId();\n  const theme = useTheme();\n\n  const {\n    data: svg,\n    error,\n    isPending,\n  } = useQuery({\n    queryKey: [\"mermaid\", chart, config, theme.resolvedTheme],\n    queryFn: async () => {\n      const mermaid = await loadMermaid();\n      mermaid.initialize({\n        theme: theme.resolvedTheme === \"dark\" ? \"dark\" : \"base\",\n        ...config,\n      });\n\n      const { svg } = await mermaid.render(id, chart);\n      return svg;\n    },\n    enabled: typeof window !== \"undefined\",\n    retry: false,\n  });\n\n  if (error)\n    return (\n      <Alert className=\"flex flex-col gap-2\" variant=\"destructive\">\n        <AlertTitle>Mermaid Error</AlertTitle>\n        <AlertDescription className=\"overflow-auto wrap-break-word whitespace-pre-wrap font-mono text-xs\">\n          {error.message}\n        </AlertDescription>\n      </Alert>\n    );\n\n  if (isPending) return <Spinner />;\n\n  // biome-ignore lint/security/noDangerouslySetInnerHtml: Mermaid generates valid SVG\n  return <div {...props} dangerouslySetInnerHTML={{ __html: svg }} />;\n};\n"],"names":["alertVariants","cva","Alert","className","variant","props","jsx","cn","AlertTitle","AlertDescription","mermaidPromise","loadMermaid","mod","error","Mermaid","chart","config","id","useId","theme","useTheme","svg","isPending","useQuery","mermaid","jsxs","Spinner"],"mappings":";;;;;;;AAIA,MAAMA,IAAgBC;AAAA,EACpB;AAAA,EACA;AAAA,IACE,UAAU;AAAA,MACR,SAAS;AAAA,QACP,SAAS;AAAA,QACT,aACE;AAAA,MAAA;AAAA,IACJ;AAAA,IAEF,iBAAiB;AAAA,MACf,SAAS;AAAA,IAAA;AAAA,EACX;AAEJ;AAEA,SAASC,EAAM;AAAA,EACb,WAAAC;AAAA,EACA,SAAAC;AAAA,EACA,GAAGC;AACL,GAAqE;AACnE,SACEC,gBAAAA,EAAAA;AAAAA,IAAC;AAAA,IAAA;AAAA,MACC,aAAU;AAAA,MACV,MAAK;AAAA,MACL,WAAWC,EAAGP,EAAc,EAAE,SAAAI,EAAA,CAAS,GAAGD,CAAS;AAAA,MAClD,GAAGE;AAAA,IAAA;AAAA,EAAA;AAGV;AAEA,SAASG,EAAW,EAAE,WAAAL,GAAW,GAAGE,KAAsC;AACxE,SACEC,gBAAAA,EAAAA;AAAAA,IAAC;AAAA,IAAA;AAAA,MACC,aAAU;AAAA,MACV,WAAWC;AAAA,QACT;AAAA,QACAJ;AAAA,MAAA;AAAA,MAED,GAAGE;AAAA,IAAA;AAAA,EAAA;AAGV;AAEA,SAASI,EAAiB;AAAA,EACxB,WAAAN;AAAA,EACA,GAAGE;AACL,GAAgC;AAC9B,SACEC,gBAAAA,EAAAA;AAAAA,IAAC;AAAA,IAAA;AAAA,MACC,aAAU;AAAA,MACV,WAAWC;AAAA,QACT;AAAA,QACAJ;AAAA,MAAA;AAAA,MAED,GAAGE;AAAA,IAAA;AAAA,EAAA;AAGV;ACjDA,IAAIK,IAAmE;AAEvE,MAAMC,IAAc,OACbD,MACHA,IAAiB,OAAO,SAAS,EAC9B,KAAK,CAACE,MAAQA,EAAI,OAAO,EACzB,MAAM,CAACC,MAAU;AAChB,QAAM,IAAI;AAAA,IACR;AAAA,IACA,EAAE,OAAOA,EAAA;AAAA,EAAM;AAEnB,CAAC,IAEEH,IAGII,IAAU,CAAC,EAAE,OAAAC,GAAO,QAAAC,GAAQ,GAAGX,QAA0B;AACpE,QAAMY,IAAKC,EAAA,GACLC,IAAQC,EAAA,GAER;AAAA,IACJ,MAAMC;AAAA,IACN,OAAAR;AAAA,IACA,WAAAS;AAAA,EAAA,IACEC,EAAS;AAAA,IACX,UAAU,CAAC,WAAWR,GAAOC,GAAQG,EAAM,aAAa;AAAA,IACxD,SAAS,YAAY;AACnB,YAAMK,IAAU,MAAMb,EAAA;AACtB,MAAAa,EAAQ,WAAW;AAAA,QACjB,OAAOL,EAAM,kBAAkB,SAAS,SAAS;AAAA,QACjD,GAAGH;AAAA,MAAA,CACJ;AAED,YAAM,EAAE,KAAAK,EAAAA,IAAQ,MAAMG,EAAQ,OAAOP,GAAIF,CAAK;AAC9C,aAAOM;AAAAA,IACT;AAAA,IACA,SAAS,OAAO,SAAW;AAAA,IAC3B,OAAO;AAAA,EAAA,CACR;AAED,SAAIR,IAEAY,gBAAAA,EAAAA,KAACvB,GAAA,EAAM,WAAU,uBAAsB,SAAQ,eAC7C,UAAA;AAAA,IAAAI,gBAAAA,EAAAA,IAACE,KAAW,UAAA,gBAAA,CAAa;AAAA,IACzBF,gBAAAA,EAAAA,IAACG,GAAA,EAAiB,WAAU,uEACzB,YAAM,QAAA,CACT;AAAA,EAAA,GACF,IAGAa,IAAkBhB,gBAAAA,MAACoB,GAAA,CAAA,CAAQ,IAGxBpB,gBAAAA,EAAAA,IAAC,SAAK,GAAGD,GAAO,yBAAyB,EAAE,QAAQgB,KAAO;AACnE;"}