@superblocksteam/sdk-api 2.0.115-next.0 → 2.0.115-next.2

package/dist/integrations/documentation.js

@@ -0,0 +1,277 @@
+import { readFile } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+const INTEGRATIONS_DIR = dirname(fileURLToPath(import.meta.url));
+const DOC_DIRECTORY_ALIASES = {
+    graphqlintegration: "graphql",
+};
+function hasDocDirectoryAlias(pluginId) {
+    return pluginId in DOC_DIRECTORY_ALIASES;
+}
+function getDocDirectoryForPlugin(pluginId) {
+    if (hasDocDirectoryAlias(pluginId)) {
+        return DOC_DIRECTORY_ALIASES[pluginId];
+    }
+    return pluginId;
+}
+async function parseDocumentationManifest(manifestPath) {
+    let raw;
+    try {
+        raw = await readFile(manifestPath, "utf8");
+    }
+    catch (error) {
+        if (error instanceof Error &&
+            "code" in error &&
+            error.code === "ENOENT") {
+            return null;
+        }
+        throw error;
+    }
+    const parsed = JSON.parse(raw);
+    if (!Array.isArray(parsed.overlays)) {
+        throw new Error(`Invalid documentation manifest at ${manifestPath}: "overlays" must be an array.`);
+    }
+    const overlays = parsed.overlays.map((overlay, index) => {
+        if (typeof overlay !== "object" ||
+            overlay === null ||
+            !("file" in overlay) ||
+            !("versionRange" in overlay)) {
+            throw new Error(`Invalid overlay entry at index ${index} in ${manifestPath}.`);
+        }
+        const { file, versionRange } = overlay;
+        if (typeof file !== "string" || file.trim().length === 0) {
+            throw new Error(`Invalid "file" for overlay index ${index} in ${manifestPath}.`);
+        }
+        if (typeof versionRange !== "string" ||
+            versionRange.trim().length === 0) {
+            throw new Error(`Invalid "versionRange" for overlay index ${index} in ${manifestPath}.`);
+        }
+        return {
+            file,
+            versionRange,
+        };
+    });
+    const base = typeof parsed.base === "string" && parsed.base.trim().length > 0
+        ? parsed.base
+        : undefined;
+    return { base, overlays };
+}
+function appendOverlay(baseDocumentation, overlayDocumentation) {
+    if (overlayDocumentation.trim().length === 0) {
+        return baseDocumentation;
+    }
+    const normalizedBase = baseDocumentation.replace(/\s+$/, "");
+    const normalizedOverlay = overlayDocumentation.replace(/^\s+/, "");
+    return `${normalizedBase}\n\n${normalizedOverlay}`;
+}
+function trimNewlinePadding(content) {
+    return content.replace(/^\n+/, "").replace(/\n+$/, "");
+}
+function parseOverlayOperations(overlayDocumentation) {
+    const lines = overlayDocumentation.split("\n");
+    const operations = [];
+    const appendBuffer = [];
+    const flushAppendBuffer = () => {
+        const appendedContent = appendBuffer.join("\n");
+        appendBuffer.length = 0;
+        if (appendedContent.trim().length === 0) {
+            return;
+        }
+        operations.push({
+            type: "append",
+            content: appendedContent,
+        });
+    };
+    for (let index = 0; index < lines.length; index += 1) {
+        const line = lines[index];
+        const replaceDirectiveMatch = line.match(/^#{1,6}\s+@replace:\s*(.+?)\s*$/);
+        if (!replaceDirectiveMatch) {
+            appendBuffer.push(line);
+            continue;
+        }
+        flushAppendBuffer();
+        const sectionTitle = replaceDirectiveMatch[1]?.trim();
+        if (!sectionTitle) {
+            throw new Error(`Invalid @replace directive: missing section title.`);
+        }
+        const replaceBodyLines = [];
+        index += 1;
+        while (index < lines.length) {
+            const nextLine = lines[index];
+            if (/^#{1,6}\s+@replace:\s*(.+?)\s*$/.test(nextLine)) {
+                index -= 1;
+                break;
+            }
+            replaceBodyLines.push(nextLine);
+            index += 1;
+        }
+        operations.push({
+            type: "replace",
+            sectionTitle,
+            content: trimNewlinePadding(replaceBodyLines.join("\n")),
+        });
+    }
+    flushAppendBuffer();
+    return operations;
+}
+function parseHeading(line) {
+    const headingMatch = line.match(/^(#{1,6})\s+(.*?)\s*$/);
+    if (!headingMatch) {
+        return null;
+    }
+    return {
+        level: headingMatch[1].length,
+        title: headingMatch[2].trim(),
+    };
+}
+function replaceMarkdownSection(documentation, sectionTitle, replacementContent) {
+    const lines = documentation.split("\n");
+    let startIndex = -1;
+    let headingLevel = -1;
+    for (let index = 0; index < lines.length; index += 1) {
+        const heading = parseHeading(lines[index]);
+        if (!heading) {
+            continue;
+        }
+        if (heading.title === sectionTitle) {
+            startIndex = index;
+            headingLevel = heading.level;
+            break;
+        }
+    }
+    if (startIndex < 0) {
+        throw new Error(`Overlay could not find section "${sectionTitle}" to replace.`);
+    }
+    let endIndex = lines.length;
+    for (let index = startIndex + 1; index < lines.length; index += 1) {
+        const heading = parseHeading(lines[index]);
+        if (!heading) {
+            continue;
+        }
+        if (heading.level <= headingLevel) {
+            endIndex = index;
+            break;
+        }
+    }
+    const headingLine = lines[startIndex];
+    const replacementLines = [headingLine];
+    if (replacementContent.length > 0) {
+        replacementLines.push(...replacementContent.split("\n"));
+    }
+    const nextLines = [
+        ...lines.slice(0, startIndex),
+        ...replacementLines,
+        ...lines.slice(endIndex),
+    ];
+    return nextLines.join("\n");
+}
+function applyOverlay(baseDocumentation, overlayDocumentation) {
+    const operations = parseOverlayOperations(overlayDocumentation);
+    if (operations.length === 0) {
+        return baseDocumentation;
+    }
+    let nextDocumentation = baseDocumentation;
+    for (const operation of operations) {
+        if (operation.type === "append") {
+            nextDocumentation = appendOverlay(nextDocumentation, operation.content);
+            continue;
+        }
+        nextDocumentation = replaceMarkdownSection(nextDocumentation, operation.sectionTitle, operation.content);
+    }
+    return nextDocumentation;
+}
+function splitComparators(versionRange) {
+    const pattern = /(>=|<=|>|<|=)?\s*(\d+\.\d+\.\d+)/g;
+    const comparators = [];
+    let match;
+    while ((match = pattern.exec(versionRange)) !== null) {
+        comparators.push(`${match[1] ?? "="}${match[2]}`);
+    }
+    return comparators;
+}
+function parseSemVer(version) {
+    const match = version.match(/^(\d+)\.(\d+)\.(\d+)$/);
+    if (!match) {
+        throw new Error(`Invalid semver: "${version}"`);
+    }
+    return [
+        Number.parseInt(match[1], 10),
+        Number.parseInt(match[2], 10),
+        Number.parseInt(match[3], 10),
+    ];
+}
+function compareSemVer(left, right) {
+    const leftParts = parseSemVer(left);
+    const rightParts = parseSemVer(right);
+    for (let index = 0; index < leftParts.length; index += 1) {
+        if (leftParts[index] > rightParts[index]) {
+            return 1;
+        }
+        if (leftParts[index] < rightParts[index]) {
+            return -1;
+        }
+    }
+    return 0;
+}
+function satisfiesComparator(version, comparator) {
+    const match = comparator.match(/^(>=|<=|>|<|=)?(.+)$/);
+    if (!match) {
+        throw new Error(`Invalid version comparator: "${comparator}"`);
+    }
+    const operator = match[1] ?? "=";
+    const comparedVersion = match[2]?.trim();
+    if (!comparedVersion) {
+        throw new Error(`Invalid version comparator: "${comparator}"`);
+    }
+    const comparison = compareSemVer(version, comparedVersion);
+    switch (operator) {
+        case ">":
+            return comparison > 0;
+        case ">=":
+            return comparison >= 0;
+        case "<":
+            return comparison < 0;
+        case "<=":
+            return comparison <= 0;
+        case "=":
+            return comparison === 0;
+        default:
+            throw new Error(`Unsupported version operator: "${operator}"`);
+    }
+}
+function versionMatchesRange(version, versionRange) {
+    const comparators = splitComparators(versionRange);
+    if (comparators.length === 0) {
+        throw new Error(`Version range must not be empty`);
+    }
+    return comparators.every((comparator) => satisfiesComparator(version, comparator));
+}
+function ensureOverlayPathIsWithinPluginDir(pluginDirectory, overlayPath) {
+    if (!overlayPath.startsWith(`${pluginDirectory}/`)) {
+        throw new Error(`Overlay path "${overlayPath}" must be inside plugin directory "${pluginDirectory}".`);
+    }
+}
+export async function resolveIntegrationDocumentation(pluginId, options = {}) {
+    const { pluginVersion, integrationsDirectory = INTEGRATIONS_DIR } = options;
+    const pluginDirectory = resolve(integrationsDirectory, getDocDirectoryForPlugin(pluginId));
+    const manifestPath = resolve(pluginDirectory, "docs.manifest.json");
+    const manifest = await parseDocumentationManifest(manifestPath);
+    const baseFileName = manifest?.base ?? "README.md";
+    const baseDocumentationPath = resolve(pluginDirectory, baseFileName);
+    const baseDocumentation = await readFile(baseDocumentationPath, "utf8");
+    if (!manifest || !pluginVersion) {
+        return baseDocumentation;
+    }
+    let resolvedDocumentation = baseDocumentation;
+    for (const overlay of manifest.overlays) {
+        if (!versionMatchesRange(pluginVersion, overlay.versionRange)) {
+            continue;
+        }
+        const overlayPath = resolve(pluginDirectory, overlay.file);
+        ensureOverlayPathIsWithinPluginDir(pluginDirectory, overlayPath);
+        const overlayDocumentation = await readFile(overlayPath, "utf8");
+        resolvedDocumentation = applyOverlay(resolvedDocumentation, overlayDocumentation);
+    }
+    return resolvedDocumentation;
+}
+//# sourceMappingURL=documentation.js.map

package/dist/integrations/documentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentation.js","sourceRoot":"","sources":["../../src/integrations/documentation.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superblocksteam/sdk-api",
-  "version": "2.0.115-next.0",
+  "version": "2.0.115-next.2",
   "description": "Superblocks SDK for TypeScript-based API definitions",
   "license": "Superblocks Community Software License",
   "files": [

package/src/index.ts

@@ -309,6 +309,10 @@ export type {
   CreateClientOptions,
 } from "./integrations/index.js";
 
+// resolveIntegrationDocumentation is intentionally NOT re-exported here.
+// It uses node:fs which is incompatible with browser bundles (Vite dev server).
+// Import directly from "@superblocksteam/sdk-api/dist/integrations/documentation.js" instead.
+
 // SDK-level error types
 export {
   RestApiValidationError,

package/src/integrations/airtable/docs.manifest.json

@@ -0,0 +1,5 @@
+{
+  "pluginId": "airtable",
+  "base": "README.md",
+  "overlays": []
+}

package/src/integrations/anthropic/docs.manifest.json

@@ -0,0 +1,5 @@
+{
+  "pluginId": "anthropic",
+  "base": "README.md",
+  "overlays": []
+}

package/src/integrations/asana/docs.manifest.json

@@ -0,0 +1,5 @@
+{
+  "pluginId": "asana",
+  "base": "README.md",
+  "overlays": []
+}

package/src/integrations/athena/docs.manifest.json

@@ -0,0 +1,5 @@
+{
+  "pluginId": "athena",
+  "base": "README.md",
+  "overlays": []
+}

package/src/integrations/bigquery/docs.manifest.json

@@ -0,0 +1,5 @@
+{
+  "pluginId": "bigquery",
+  "base": "README.md",
+  "overlays": []
+}

package/src/integrations/bitbucket/docs.manifest.json

@@ -0,0 +1,5 @@
+{
+  "pluginId": "bitbucket",
+  "base": "README.md",
+  "overlays": []
+}

package/src/integrations/box/docs.manifest.json

@@ -0,0 +1,5 @@
+{
+  "pluginId": "box",
+  "base": "README.md",
+  "overlays": []
+}

package/src/integrations/circleci/docs.manifest.json

@@ -0,0 +1,5 @@
+{
+  "pluginId": "circleci",
+  "base": "README.md",
+  "overlays": []
+}

package/src/integrations/cockroachdb/docs.manifest.json

@@ -0,0 +1,5 @@
+{
+  "pluginId": "cockroachdb",
+  "base": "README.md",
+  "overlays": []
+}

package/src/integrations/cohere/docs.manifest.json

@@ -0,0 +1,5 @@
+{
+  "pluginId": "cohere",
+  "base": "README.md",
+  "overlays": []
+}

package/src/integrations/confluence/docs.manifest.json

@@ -0,0 +1,5 @@
+{
+  "pluginId": "confluence",
+  "base": "README.md",
+  "overlays": []
+}

package/src/integrations/cosmosdb/docs.manifest.json

@@ -0,0 +1,5 @@
+{
+  "pluginId": "cosmosdb",
+  "base": "README.md",
+  "overlays": []
+}

package/src/integrations/databricks/docs.manifest.json

@@ -0,0 +1,5 @@
+{
+  "pluginId": "databricks",
+  "base": "README.md",
+  "overlays": []
+}

package/src/integrations/datadog/docs.manifest.json

@@ -0,0 +1,5 @@
+{
+  "pluginId": "datadog",
+  "base": "README.md",
+  "overlays": []
+}