OpenAPI JSON and YAML per dynamic entity

simonredfern · simonredfern · commit 401b7208dc3e · 2025-12-20T13:44:16.000+01:00
diff --git a/src/routes/(protected)/dynamic-entities/system/[id]/+page.svelte b/src/routes/(protected)/dynamic-entities/system/[id]/+page.svelte
@@ -236,44 +236,50 @@
           </svg>
           Manage Data (CRUD)
         </a>
-        <button
-          type="button"
-          onclick={exportDefinition}
-          class="inline-flex items-center rounded-lg border border-green-300 bg-white px-4 py-2 text-sm font-medium text-green-700 hover:bg-green-50 dark:border-green-600 dark:bg-gray-800 dark:text-green-400 dark:hover:bg-green-900/20"
-          title="Copy definition to clipboard"
+        <a
+          href="/dynamic-entities/system/openapi-json?tags={entityName}"
+          target="_blank"
+          rel="noopener noreferrer"
+          class="inline-flex items-center rounded-lg border border-gray-300 bg-white px-4 py-2 text-sm font-medium text-gray-700 hover:bg-gray-50 dark:border-gray-600 dark:bg-gray-800 dark:text-gray-300 dark:hover:bg-gray-700"
+          title="View OpenAPI JSON"
         >
-          {#if exportCopied}
-            <svg
-              class="mr-2 h-4 w-4"
-              fill="none"
-              stroke="currentColor"
-              viewBox="0 0 24 24"
-            >
-              <path
-                stroke-linecap="round"
-                stroke-linejoin="round"
-                stroke-width="2"
-                d="M5 13l4 4L19 7"
-              />
-            </svg>
-            Copied!
-          {:else}
-            <svg
-              class="mr-2 h-4 w-4"
-              fill="none"
-              stroke="currentColor"
-              viewBox="0 0 24 24"
-            >
-              <path
-                stroke-linecap="round"
-                stroke-linejoin="round"
-                stroke-width="2"
-                d="M8 16H6a2 2 0 01-2-2V6a2 2 0 012-2h8a2 2 0 012 2v2m-6 12h8a2 2 0 002-2v-8a2 2 0 00-2-2h-8a2 2 0 00-2 2v8a2 2 0 002 2z"
-              />
-            </svg>
-            Copy Definition
-          {/if}
-        </button>
+          <svg
+            class="mr-2 h-4 w-4"
+            fill="none"
+            stroke="currentColor"
+            viewBox="0 0 24 24"
+          >
+            <path
+              stroke-linecap="round"
+              stroke-linejoin="round"
+              stroke-width="2"
+              d="M9 12h6m-6 4h6m2 5H7a2 2 0 01-2-2V5a2 2 0 012-2h5.586a1 1 0 01.707.293l5.414 5.414a1 1 0 01.293.707V19a2 2 0 01-2 2z"
+            />
+          </svg>
+          OpenAPI JSON
+        </a>
+        <a
+          href="/dynamic-entities/system/openapi-yaml?tags={entityName}"
+          target="_blank"
+          rel="noopener noreferrer"
+          class="inline-flex items-center rounded-lg border border-gray-300 bg-white px-4 py-2 text-sm font-medium text-gray-700 hover:bg-gray-50 dark:border-gray-600 dark:bg-gray-800 dark:text-gray-300 dark:hover:bg-gray-700"
+          title="View OpenAPI YAML"
+        >
+          <svg
+            class="mr-2 h-4 w-4"
+            fill="none"
+            stroke="currentColor"
+            viewBox="0 0 24 24"
+          >
+            <path
+              stroke-linecap="round"
+              stroke-linejoin="round"
+              stroke-width="2"
+              d="M9 12h6m-6 4h6m2 5H7a2 2 0 01-2-2V5a2 2 0 012-2h5.586a1 1 0 01.707.293l5.414 5.414a1 1 0 01.293.707V19a2 2 0 01-2 2z"
+            />
+          </svg>
+          OpenAPI YAML
+        </a>
       </div>
     </div>
   </div>
@@ -494,6 +500,44 @@
 
   <!-- Action Buttons -->
   <div class="mt-6 flex justify-end gap-2">
+    <button
+      type="button"
+      onclick={exportDefinition}
+      class="inline-flex items-center rounded-lg border border-green-300 bg-white px-4 py-2 text-sm font-medium text-green-700 hover:bg-green-50 dark:border-green-600 dark:bg-gray-800 dark:text-green-400 dark:hover:bg-green-900/20"
+      title="Copy definition to clipboard"
+    >
+      {#if exportCopied}
+        <svg
+          class="mr-2 h-4 w-4"
+          fill="none"
+          stroke="currentColor"
+          viewBox="0 0 24 24"
+        >
+          <path
+            stroke-linecap="round"
+            stroke-linejoin="round"
+            stroke-width="2"
+            d="M5 13l4 4L19 7"
+          />
+        </svg>
+        Copied!
+      {:else}
+        <svg
+          class="mr-2 h-4 w-4"
+          fill="none"
+          stroke="currentColor"
+          viewBox="0 0 24 24"
+        >
+          <path
+            stroke-linecap="round"
+            stroke-linejoin="round"
+            stroke-width="2"
+            d="M8 16H6a2 2 0 01-2-2V6a2 2 0 012-2h8a2 2 0 012 2v2m-6 12h8a2 2 0 002-2v-8a2 2 0 00-2-2h-8a2 2 0 00-2 2v8a2 2 0 002 2z"
+          />
+        </svg>
+        Copy Definition
+      {/if}
+    </button>
     <button
       type="button"
       onclick={downloadDefinition}
diff --git a/src/routes/(protected)/dynamic-entities/system/openapi-json/+page.server.ts b/src/routes/(protected)/dynamic-entities/system/openapi-json/+page.server.ts
@@ -6,9 +6,12 @@ import { OBP_API_URL } from "$lib/config";
 
 const logger = createLogger("OpenAPIJSONPageServer");
 
-export const load: PageServerLoad = async ({ locals }) => {
+export const load: PageServerLoad = async ({ locals, url }) => {
   const session = locals.session;
 
+  // Get tags parameter from URL
+  const tags = url.searchParams.get("tags");
+
   if (!session?.data?.user) {
     throw error(401, "Unauthorized");
   }
@@ -22,10 +25,14 @@ export const load: PageServerLoad = async ({ locals }) => {
 
   try {
     logger.info("=== FETCHING DYNAMIC ENTITY OPENAPI JSON ===");
-    const url = `${OBP_API_URL}/resource-docs/OBPv6.0.0/openapi?content=dynamic`;
-    logger.info(`Request: ${url}`);
+    let apiUrl = `${OBP_API_URL}/resource-docs/OBPv6.0.0/openapi?content=dynamic`;
+    if (tags) {
+      apiUrl += `&tags=${encodeURIComponent(tags)}`;
+      logger.info(`Filtering by tags: ${tags}`);
+    }
+    logger.info(`Request: ${apiUrl}`);
 
-    const response = await fetch(url, {
+    const response = await fetch(apiUrl, {
       headers: {
         Authorization: `Bearer ${accessToken}`,
       },
diff --git a/src/routes/(protected)/dynamic-entities/system/openapi-yaml/+page.server.ts b/src/routes/(protected)/dynamic-entities/system/openapi-yaml/+page.server.ts
@@ -6,9 +6,12 @@ import { OBP_API_URL } from "$lib/config";
 
 const logger = createLogger("OpenAPIYAMLPageServer");
 
-export const load: PageServerLoad = async ({ locals }) => {
+export const load: PageServerLoad = async ({ locals, url }) => {
   const session = locals.session;
 
+  // Get tags parameter from URL
+  const tags = url.searchParams.get("tags");
+
   if (!session?.data?.user) {
     throw error(401, "Unauthorized");
   }
@@ -22,10 +25,14 @@ export const load: PageServerLoad = async ({ locals }) => {
 
   try {
     logger.info("=== FETCHING DYNAMIC ENTITY OPENAPI YAML ===");
-    const url = `${OBP_API_URL}/resource-docs/OBPv6.0.0/openapi.yaml?content=dynamic`;
-    logger.info(`Request: ${url}`);
+    let apiUrl = `${OBP_API_URL}/resource-docs/OBPv6.0.0/openapi.yaml?content=dynamic`;
+    if (tags) {
+      apiUrl += `&tags=${encodeURIComponent(tags)}`;
+      logger.info(`Filtering by tags: ${tags}`);
+    }
+    logger.info(`Request: ${apiUrl}`);
 
-    const response = await fetch(url, {
+    const response = await fetch(apiUrl, {
       headers: {
         Authorization: `Bearer ${accessToken}`,
       },
