@mapples/api-import 1.5.0

package/dist/postman.js

@@ -0,0 +1,260 @@
+import { stripBodyCredentials } from './bodyCredentials.js';
+import { nameFromRoute, toRequestName, uniqueName } from './names.js';
+const isObject = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
+const METHODS = new Set(['GET', 'POST', 'PUT', 'PATCH', 'DELETE']);
+/** Header and variable names whose values are credentials. */
+const CREDENTIAL_NAME = /(token|secret|password|passwd|api[-_]?key|apikey|auth|bearer|session|cookie|private)/i;
+/** A `{{name}}` that is the whole value. */
+const WHOLE_VARIABLE = /^\{\{\s*([^}]+?)\s*\}\}$/;
+/** `apiToken` / `api-token` → `API_TOKEN`, the shape secret names take. */
+const secretName = (name) => toRequestName(name)
+    .replace(/([a-z0-9])([A-Z])/g, '$1_$2')
+    .toUpperCase();
+/** Whether the text is a Postman collection export. */
+export const looksLikePostman = (text) => /^\s*\{[\s\S]*"info"[\s\S]*"schema"\s*:\s*"[^"]*getpostman\.com\/json\/collection/.test(text);
+/** Every request in the collection, folders flattened depth-first. */
+const flatten = (items, out = []) => {
+    for (const item of items) {
+        if (!isObject(item))
+            continue;
+        if (Array.isArray(item.item)) {
+            flatten(item.item, out);
+            continue;
+        }
+        const request = typeof item.request === 'string'
+            ? { url: item.request, method: 'GET' }
+            : item.request;
+        if (!isObject(request))
+            continue;
+        out.push({
+            name: typeof item.name === 'string' ? item.name : '',
+            request,
+            response: Array.isArray(item.response) ? item.response : [],
+        });
+    }
+    return out;
+};
+const rawUrl = (url) => {
+    if (typeof url === 'string')
+        return url;
+    if (isObject(url) && typeof url.raw === 'string')
+        return url.raw;
+    throw new Error('A Postman request has no URL');
+};
+/** A collection/request `auth` block as a Mapples auth, plus the warning it costs. */
+const authFrom = (auth, where, warnings) => {
+    if (!isObject(auth) || auth.type === 'noauth')
+        return undefined;
+    const entries = Array.isArray(auth[auth.type])
+        ? auth[auth.type]
+        : [];
+    const field = (key) => {
+        const entry = entries.find((candidate) => isObject(candidate) && candidate.key === key);
+        return isObject(entry) && typeof entry.value === 'string'
+            ? entry.value
+            : undefined;
+    };
+    const secretFor = (value, fallback) => {
+        const variable = value?.match(WHOLE_VARIABLE)?.[1];
+        return secretName(variable ?? fallback);
+    };
+    if (auth.type === 'bearer') {
+        const secretRef = secretFor(field('token'), 'API_TOKEN');
+        warnings.push(`${where}: the bearer token was not imported. Store it as the secret ${secretRef}.`);
+        return { kind: 'bearer', secretRef };
+    }
+    if (auth.type === 'apikey' && field('in') !== 'query') {
+        const header = field('key') ?? 'X-API-Key';
+        const secretRef = secretFor(field('value'), 'API_KEY');
+        warnings.push(`${where}: the ${header} value was not imported. Store it as the secret ${secretRef}.`);
+        return { kind: 'header', header, secretRef };
+    }
+    warnings.push(`${where}: Postman "${String(auth.type)}" auth is not supported — set the request's auth by hand.`);
+    return undefined;
+};
+/**
+ * Splits a URL into the shared origin and the path. A leading
+ * `{{baseUrl}}`-style variable is the origin (its value becomes the
+ * environment's base URL); otherwise the scheme + host are.
+ */
+const splitUrl = (url) => {
+    const variable = url.match(/^(\{\{\s*[^}]+?\s*\}\})(.*)$/);
+    if (variable)
+        return { origin: variable[1], path: variable[2] || '/' };
+    const absolute = url.match(/^(https?:\/\/[^/?#]+)(.*)$/i);
+    if (absolute)
+        return { origin: absolute[1], path: absolute[2] || '/' };
+    throw new Error(`"${url}" is neither absolute nor starts with a {{variable}}`);
+};
+/**
+ * A Postman collection → one request per item. The most common origin
+ * becomes the environment's base URL (a `{{baseUrl}}` variable resolves to
+ * its collection value); requests on another origin keep absolute URLs.
+ * `:id` path segments become `{id}` tokens with the item's example values.
+ */
+export const importPostman = (text) => {
+    const collection = JSON.parse(text);
+    if (!isObject(collection) || !Array.isArray(collection.item)) {
+        throw new Error('The text is not a Postman collection');
+    }
+    const info = isObject(collection.info) ? collection.info : {};
+    const warnings = [];
+    const variables = {};
+    for (const entry of Array.isArray(collection.variable)
+        ? collection.variable
+        : []) {
+        if (!isObject(entry) || typeof entry.key !== 'string')
+            continue;
+        if (CREDENTIAL_NAME.test(entry.key)) {
+            warnings.push(`The collection variable "${entry.key}" looks like a credential and was not imported. Store it as the secret ${secretName(entry.key)}.`);
+            continue;
+        }
+        variables[entry.key] = entry.value === undefined ? '' : String(entry.value);
+    }
+    const items = flatten(collection.item);
+    if (items.length === 0) {
+        throw new Error('The Postman collection holds no requests');
+    }
+    const origins = new Map();
+    const parsed = items.map((item) => {
+        const split = splitUrl(rawUrl(item.request.url));
+        origins.set(split.origin, (origins.get(split.origin) ?? 0) + 1);
+        return { item, ...split };
+    });
+    const origin = [...origins.entries()].sort((a, b) => b[1] - a[1])[0][0];
+    const originVariable = origin.match(WHOLE_VARIABLE)?.[1];
+    let baseUrl = origin;
+    if (originVariable) {
+        const value = variables[originVariable];
+        if (!value) {
+            throw new Error(`The requests start with {{${originVariable}}}, which the collection gives no value — export the collection with its variables`);
+        }
+        baseUrl = value;
+        delete variables[originVariable];
+    }
+    // Resolved once: requests without their own auth inherit it.
+    const collectionAuth = authFrom(collection.auth, 'Collection', warnings);
+    const taken = new Set();
+    const credentials = [];
+    const requests = parsed.map(({ item, origin: itemOrigin, path: rawPath }, index) => {
+        const method = String(item.request.method ?? 'GET').toUpperCase();
+        if (!METHODS.has(method)) {
+            throw new Error(`"${item.name}": method ${method} is not supported`);
+        }
+        const where = `${method} ${item.name || rawPath}`;
+        const url = isObject(item.request.url) ? item.request.url : {};
+        // `:id` → `{id}`; the query string moves into params.
+        const [pathPart, queryPart] = rawPath.split('?');
+        const path = pathPart.replace(/:([A-Za-z_][A-Za-z0-9_]*)/g, '{$1}');
+        const params = {};
+        for (const entry of Array.isArray(url.variable) ? url.variable : []) {
+            if (isObject(entry) && typeof entry.key === 'string') {
+                params[entry.key] = {
+                    kind: 'static',
+                    value: entry.value === undefined ? '' : String(entry.value),
+                };
+            }
+        }
+        // A URL given as a plain string carries its query only in the text.
+        const query = Array.isArray(url.query)
+            ? url.query
+            : (queryPart ?? '')
+                .split('&')
+                .filter((pair) => pair !== '')
+                .map((pair) => {
+                const [key, ...value] = pair.split('=');
+                return {
+                    key: decodeURIComponent(key),
+                    value: decodeURIComponent(value.join('=')),
+                };
+            });
+        for (const entry of query) {
+            if (!isObject(entry) || typeof entry.key !== 'string' || entry.disabled)
+                continue;
+            if (CREDENTIAL_NAME.test(entry.key)) {
+                warnings.push(`${where}: the query parameter "${entry.key}" looks like a credential and was not imported.`);
+                continue;
+            }
+            params[entry.key] = {
+                kind: 'static',
+                value: entry.value == null ? '' : String(entry.value),
+            };
+        }
+        const headers = {};
+        for (const entry of Array.isArray(item.request.header)
+            ? item.request.header
+            : []) {
+            if (!isObject(entry) || typeof entry.key !== 'string' || entry.disabled)
+                continue;
+            if (CREDENTIAL_NAME.test(entry.key)) {
+                warnings.push(`${where}: the ${entry.key} header was not imported — it carries a credential; set the request's auth instead.`);
+                continue;
+            }
+            if (entry.key.toLowerCase() === 'content-type')
+                continue;
+            headers[entry.key] = String(entry.value ?? '');
+        }
+        let template;
+        const body = isObject(item.request.body) ? item.request.body : null;
+        if (body && body.mode === 'raw' && typeof body.raw === 'string') {
+            const raw = body.raw.trim();
+            if (raw !== '') {
+                try {
+                    template = JSON.parse(raw);
+                }
+                catch {
+                    warnings.push(`${where}: the body is not plain JSON (Postman variables inside it?) — it was not imported.`);
+                }
+            }
+        }
+        else if (body && body.mode && body.mode !== 'none') {
+            warnings.push(`${where}: a ${String(body.mode)} body is not supported — only raw JSON bodies are imported.`);
+        }
+        if (template !== undefined) {
+            const stripped = stripBodyCredentials(template, index);
+            template = stripped.template;
+            credentials.push(...stripped.credentials);
+        }
+        let responseSample;
+        for (const response of item.response) {
+            if (!isObject(response) || typeof response.body !== 'string')
+                continue;
+            const code = Number(response.code);
+            if (Number.isFinite(code) && (code < 200 || code >= 300))
+                continue;
+            try {
+                responseSample = JSON.parse(response.body);
+                break;
+            }
+            catch {
+                // A non-JSON saved response is no sample.
+            }
+        }
+        return {
+            name: uniqueName(item.name ? toRequestName(item.name) : nameFromRoute(method, path), taken),
+            method: method,
+            path: itemOrigin === origin ? path : `${itemOrigin}${path}`,
+            headers: Object.keys(headers).length > 0 ? headers : undefined,
+            params: Object.keys(params).length > 0 ? params : undefined,
+            body: template === undefined ? undefined : { kind: 'json', template },
+            // The collection's credential is for its own API: a request to
+            // another origin never inherits it.
+            auth: item.request.auth !== undefined
+                ? authFrom(item.request.auth, where, warnings)
+                : itemOrigin === origin
+                    ? collectionAuth
+                    : undefined,
+            responseSample,
+        };
+    });
+    return {
+        format: 'postman',
+        baseUrl: baseUrl.replace(/\/$/, ''),
+        environmentName: typeof info.name === 'string' ? info.name : 'API',
+        requests,
+        variables: Object.keys(variables).length > 0 ? variables : undefined,
+        warnings,
+        bodyCredentials: credentials.length > 0 ? credentials : undefined,
+    };
+};
+//# sourceMappingURL=postman.js.map

package/dist/postman.js.map

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

package/dist/swagger.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @fileoverview Swagger 2.0 → the OpenAPI 3 shape `importOpenApi` reads.
+ * Only what the importer uses is translated: the server URL, `$ref` roots,
+ * parameters (a `body` parameter becomes the request body), JSON responses
+ * and the security schemes. PostgREST (Supabase, Neon's Data API) serves
+ * this format, with most parameters shared under `#/parameters`.
+ */
+type Json = Record<string, unknown>;
+/**
+ * Translates a parsed Swagger 2.0 document. `resolveParameter` reads a
+ * shared parameter, so a `$ref`'d body parameter still becomes a body.
+ * `baseUrl` replaces `host` + `basePath` (a spec served behind a proxy
+ * often names the wrong host, or none).
+ */
+export declare const swaggerToOpenApi: (swagger: Json, baseUrl?: string) => Json;
+export {};
+//# sourceMappingURL=swagger.d.ts.map

package/dist/swagger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swagger.d.ts","sourceRoot":"","sources":["../src/swagger.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,KAAK,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAwEpC;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,SAAS,IAAI,EAAE,UAAU,MAAM,KAAG,IAsGlE,CAAC"}

package/dist/swagger.js

@@ -0,0 +1,171 @@
+/**
+ * @fileoverview Swagger 2.0 → the OpenAPI 3 shape `importOpenApi` reads.
+ * Only what the importer uses is translated: the server URL, `$ref` roots,
+ * parameters (a `body` parameter becomes the request body), JSON responses
+ * and the security schemes. PostgREST (Supabase, Neon's Data API) serves
+ * this format, with most parameters shared under `#/parameters`.
+ */
+const isObject = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
+const METHODS = ['get', 'post', 'put', 'patch', 'delete'];
+/** `#/definitions/x` → `#/components/schemas/x`, and so on, everywhere. */
+const rewriteRefs = (node) => {
+    if (Array.isArray(node))
+        return node.map(rewriteRefs);
+    if (!isObject(node))
+        return node;
+    const out = {};
+    for (const [key, value] of Object.entries(node)) {
+        out[key] =
+            key === '$ref' && typeof value === 'string'
+                ? value
+                    .replace(/^#\/definitions\//, '#/components/schemas/')
+                    .replace(/^#\/parameters\//, '#/components/parameters/')
+                    .replace(/^#\/responses\//, '#/components/responses/')
+                : rewriteRefs(value);
+    }
+    return out;
+};
+/** A Swagger 2 non-body parameter: its type fields move under `schema`. */
+const parameter3 = (parameter) => {
+    if (parameter.in === 'body' || isObject(parameter.schema))
+        return parameter;
+    const { type, format, items, enum: values, default: fallback, ...rest } = parameter;
+    const schema = {};
+    if (type !== undefined)
+        schema.type = type;
+    if (format !== undefined)
+        schema.format = format;
+    if (items !== undefined)
+        schema.items = items;
+    if (values !== undefined)
+        schema.enum = values;
+    if (fallback !== undefined)
+        schema.default = fallback;
+    return { ...rest, schema };
+};
+/** A Swagger 2 response: `schema` / `examples` move under `content`. */
+const response3 = (response) => {
+    if (!isObject(response) || typeof response.$ref === 'string')
+        return response;
+    const { schema, examples, ...rest } = response;
+    if (schema === undefined)
+        return rest;
+    const media = { schema };
+    if (isObject(examples) && 'application/json' in examples) {
+        media.example = examples['application/json'];
+    }
+    return { ...rest, content: { 'application/json': media } };
+};
+const serverUrl = (document, override) => {
+    if (override)
+        return override.replace(/\/$/, '');
+    if (typeof document.host !== 'string') {
+        throw new Error('The Swagger document has no host — the requests would have no base URL');
+    }
+    const schemes = Array.isArray(document.schemes) ? document.schemes : [];
+    const scheme = schemes.includes('https') ? 'https' : (schemes[0] ?? 'https');
+    const basePath = typeof document.basePath === 'string' ? document.basePath : '';
+    // `:443` adds nothing to an https URL and only clutters the environment.
+    const host = document.host.replace(/:443$/, '');
+    return `${String(scheme)}://${host}${basePath}`.replace(/\/$/, '');
+};
+/**
+ * Translates a parsed Swagger 2.0 document. `resolveParameter` reads a
+ * shared parameter, so a `$ref`'d body parameter still becomes a body.
+ * `baseUrl` replaces `host` + `basePath` (a spec served behind a proxy
+ * often names the wrong host, or none).
+ */
+export const swaggerToOpenApi = (swagger, baseUrl) => {
+    const document = rewriteRefs(swagger);
+    const sharedParameters = isObject(document.parameters)
+        ? document.parameters
+        : {};
+    const resolveParameter = (node) => {
+        if (!isObject(node))
+            return null;
+        if (typeof node.$ref === 'string') {
+            const name = node.$ref.replace(/^#\/components\/parameters\//, '');
+            const target = sharedParameters[name];
+            return isObject(target) ? target : null;
+        }
+        return node;
+    };
+    const paths = {};
+    for (const [path, pathNode] of Object.entries(isObject(document.paths) ? document.paths : {})) {
+        if (!isObject(pathNode))
+            continue;
+        const pathItem = { ...pathNode };
+        for (const method of METHODS) {
+            const operation = pathNode[method];
+            if (!isObject(operation))
+                continue;
+            const parameters = [];
+            let requestBody;
+            for (const node of Array.isArray(operation.parameters)
+                ? operation.parameters
+                : []) {
+                const parameter = resolveParameter(node);
+                if (parameter?.in === 'body') {
+                    requestBody = {
+                        content: { 'application/json': { schema: parameter.schema } },
+                    };
+                    continue;
+                }
+                // formData has no JSON-body equivalent; the importer skips it anyway.
+                if (parameter?.in === 'formData')
+                    continue;
+                parameters.push(isObject(node) && typeof node.$ref === 'string'
+                    ? node
+                    : parameter && parameter3(parameter));
+            }
+            const responses = isObject(operation.responses)
+                ? Object.fromEntries(Object.entries(operation.responses).map(([code, response]) => [
+                    code,
+                    response3(response),
+                ]))
+                : {};
+            pathItem[method] = {
+                ...operation,
+                parameters,
+                ...(requestBody ? { requestBody } : {}),
+                responses,
+            };
+        }
+        paths[path] = pathItem;
+    }
+    const securitySchemes = {};
+    for (const [name, scheme] of Object.entries(isObject(document.securityDefinitions) ? document.securityDefinitions : {})) {
+        if (!isObject(scheme))
+            continue;
+        // Swagger 2 has no bearer type: an `Authorization` API key is one.
+        securitySchemes[name] =
+            scheme.type === 'apiKey' &&
+                scheme.in === 'header' &&
+                typeof scheme.name === 'string' &&
+                scheme.name.toLowerCase() === 'authorization'
+                ? { type: 'http', scheme: 'bearer' }
+                : scheme;
+    }
+    return {
+        openapi: '3.0.0',
+        info: document.info,
+        servers: [{ url: serverUrl(document, baseUrl) }],
+        paths,
+        security: document.security,
+        components: {
+            schemas: document.definitions,
+            parameters: Object.fromEntries(Object.entries(sharedParameters).map(([name, parameter]) => [
+                name,
+                isObject(parameter) ? parameter3(parameter) : parameter,
+            ])),
+            responses: isObject(document.responses)
+                ? Object.fromEntries(Object.entries(document.responses).map(([name, response]) => [
+                    name,
+                    response3(response),
+                ]))
+                : undefined,
+            securitySchemes,
+        },
+    };
+};
+//# sourceMappingURL=swagger.js.map

package/dist/swagger.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,45 @@
+import type { ApiRequest, ApiValueSource } from '@mapples/types';
+/** A request as an importer produces it: no id yet, path relative to `baseUrl`. */
+export type ImportedRequest = Omit<ApiRequest, 'id'>;
+export interface ApiImportResult {
+    /** Where the source came from — shown in the import preview. */
+    format: 'curl' | 'openapi' | 'swagger' | 'postman';
+    /**
+     * The origin the requests' relative paths hang off (`https://api.acme.com/v1`).
+     * The store decides whether that becomes an environment or the paths are
+     * made absolute.
+     */
+    baseUrl: string;
+    /** A name for the environment `baseUrl` may become. */
+    environmentName: string;
+    requests: ImportedRequest[];
+    /**
+     * `{{name}}` values the requests' url/header templates read (a Postman
+     * collection's variables). They become the environment's variables; a
+     * credential-looking one is never imported, only named in `warnings`.
+     */
+    variables?: Record<string, string>;
+    /**
+     * What the import left out on purpose — above all secrets: a token found in
+     * the source is never imported, only the name of the secret to store it as.
+     */
+    warnings: string[];
+    /**
+     * Credential-like fields found in a request body (`password`, `token`, …).
+     * The requests already read them from `replacement` instead; the values
+     * are kept here only so the author can explicitly choose to keep them.
+     */
+    bodyCredentials?: BodyCredential[];
+}
+/** A credential-like body field the importer took out of a request body. */
+export interface BodyCredential {
+    /** Index into `ApiImportResult.requests`. */
+    requestIndex: number;
+    /** Where in the body template the field sits. */
+    path: string[];
+    /** The value found in the source. */
+    value: string;
+    /** What the body reads instead. */
+    replacement: ApiValueSource;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEjE,mFAAmF;AACnF,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;AAErD,MAAM,WAAW,eAAe;IAC9B,gEAAgE;IAChE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IACnD;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC;;;OAGG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB;;;;OAIG;IACH,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;CACpC;AAED,4EAA4E;AAC5E,MAAM,WAAW,cAAc;IAC7B,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,WAAW,EAAE,cAAc,CAAC;CAC7B"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@mapples/api-import",
+  "version": "1.5.0",
+  "description": "Turns cURL commands, OpenAPI 3 / Swagger 2 documents and Postman collections into Mapples API requests, and merges them into a project API document. Pure: no I/O.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsc -b tsconfig.build.json",
+    "lint": "eslint .",
+    "type-check": "tsc --noEmit",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  },
+  "author": {
+    "name": "Oleksandr Soloviov",
+    "url": "https://mapples.org/people/olek_soloviov"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mapplesorg/mapples-open-kit.git",
+    "directory": "packages/@mapples/api-import"
+  },
+  "dependencies": {
+    "@mapples/types": "^1.5.0",
+    "yaml": "^2.6.1"
+  },
+  "devDependencies": {
+    "typescript": "~6.0.3"
+  },
+  "engines": {
+    "node": ">=18.18"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "package.json"
+  ]
+}