expediate 1.0.4 → 1.0.5

package/dist/openapi.js

@@ -0,0 +1,481 @@
+/* Copyright 2021 Fabien Bavent
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a
+ * copy of this software and associated documentation files (the "Software"),
+ * to deal in the Software without restriction, including without limitation
+ * the rights to use, copy, modify, merge, publish, distribute, sublicense,
+ * and/or sell copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included
+ * in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+ * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+ * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+ * DEALINGS IN THE SOFTWARE.
+ */
+'use strict';
+// ── YAML serialiser (zero-dependency, block-style) ────────────────────────────
+/**
+ * YAML reserved keywords that must be quoted as scalars so that YAML parsers
+ * do not interpret them as the corresponding typed values.
+ */
+const YAML_KW = new Set([
+    'true', 'false', 'yes', 'no', 'on', 'off', 'null', '~',
+]);
+/**
+ * Pattern for "safe" plain scalars: they can be represented without quoting.
+ * A scalar is safe when it:
+ * - contains only letters, digits, `_`, `-`, `.` or `/`
+ * - starts with a letter, `_`, `/`, or `$`
+ * - is not a YAML reserved keyword
+ * - does not look like a number
+ */
+const SAFE_SCALAR = /^[a-zA-Z$_/][a-zA-Z0-9$_\-./]*$/;
+/** Pattern matching integer and floating-point number strings. */
+const LOOKS_LIKE_NUMBER = /^[-+]?(\d+\.?\d*|\.\d+)([eE][+-]?\d+)?$|^0x[0-9a-fA-F]+$|^0o[0-7]+$/;
+/**
+ * Serialise a string as a YAML scalar value or key.
+ *
+ * The string is returned unquoted when it is a valid YAML plain scalar —
+ * i.e. it cannot be misinterpreted as another type and does not contain
+ * characters that would confuse a YAML parser.
+ *
+ * Otherwise the value is wrapped in double quotes with control characters,
+ * backslashes, and `"` escaped so the output is always valid YAML 1.2.
+ *
+ * @param s - The string to serialise.
+ */
+function yamlString(s) {
+    if (s === '')
+        return '""';
+    const needsQuote = 
+    // Would be misinterpreted as a YAML typed value.
+    YAML_KW.has(s.toLowerCase()) ||
+        LOOKS_LIKE_NUMBER.test(s) ||
+        // Starts with a YAML indicator that has special meaning at the start of a
+        // plain scalar (block context).
+        /^[-?:,[\]{}#&*!|>'"%@`~]/.test(s) ||
+        // Inline sequences that break block-mapping parsing.
+        s.includes(': ') ||
+        s.endsWith(':') ||
+        s.includes(' #') ||
+        // Leading / trailing whitespace.
+        s !== s.trim() ||
+        // Flow indicator characters anywhere — present in path patterns such as
+        // `/items/{id}` and must be quoted to avoid flow-collection ambiguity.
+        /[{}\[\]]/.test(s) ||
+        // Control characters.
+        /[\x00-\x1f\x7f]/.test(s);
+    if (!needsQuote)
+        return s;
+    // Double-quoted style: always valid, handles all edge cases.
+    return '"' +
+        s
+            .replace(/\\/g, '\\\\')
+            .replace(/"/g, '\\"')
+            .replace(/\n/g, '\\n')
+            .replace(/\r/g, '\\r')
+            .replace(/\t/g, '\\t')
+            .replace(/[\x00-\x08\x0b\x0c\x0e-\x1f\x7f]/g, c => `\\u${c.charCodeAt(0).toString(16).padStart(4, '0')}`)
+        + '"';
+}
+/**
+ * Serialise a mapping key as a YAML scalar.
+ *
+ * Uses the same quoting rules as {@link yamlString}.  Numbers as keys
+ * (e.g. HTTP status codes `200`, `500`) are always quoted so that YAML
+ * parsers do not interpret them as integer keys.
+ */
+function yamlKey(key) {
+    return yamlString(key);
+}
+/**
+ * Recursively serialise a JSON-compatible value into an array of YAML block
+ * notation lines.
+ *
+ * Each returned line has **no leading indentation** — it is the caller's
+ * responsibility to prefix nested lines with `'  '` (two spaces) when
+ * embedding them inside a mapping value or sequence item.
+ *
+ * @param value - The value to serialise.
+ */
+function toYamlLines(value) {
+    // ── Scalars ─────────────────────────────────────────────────────────────────
+    if (value === null || value === undefined)
+        return ['null'];
+    if (typeof value === 'boolean')
+        return [String(value)];
+    if (typeof value === 'number')
+        return [isFinite(value) ? String(value) : '.inf'];
+    if (typeof value === 'string')
+        return [yamlString(value)];
+    // ── Sequences ────────────────────────────────────────────────────────────────
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            return ['[]'];
+        const lines = [];
+        for (const item of value) {
+            const itemLines = toYamlLines(item);
+            // First line of the item goes on the same line as the dash.
+            lines.push(`- ${itemLines[0]}`);
+            // Subsequent lines are indented by two spaces (relative to the `-`).
+            for (const l of itemLines.slice(1))
+                lines.push(`  ${l}`);
+        }
+        return lines;
+    }
+    // ── Mappings ─────────────────────────────────────────────────────────────────
+    if (typeof value === 'object') {
+        const obj = value;
+        const entries = Object.entries(obj).filter(([, v]) => v !== undefined);
+        if (entries.length === 0)
+            return ['{}'];
+        const lines = [];
+        for (const [key, val] of entries) {
+            const k = yamlKey(key);
+            const valLines = toYamlLines(val);
+            // Inline only when the value is a scalar, null, or an empty collection
+            // (`{}` / `[]`).  Non-empty objects and arrays — even when they happen
+            // to serialise to a single line (e.g. `$ref: "#/..."`) — must go block
+            // style; inlining them produces ambiguous YAML like `key: $ref: "..."`.
+            const isComplex = typeof val === 'object' && val !== null;
+            const isEmptyCollection = valLines.length === 1 &&
+                (valLines[0] === '{}' || valLines[0] === '[]');
+            if (!isComplex || isEmptyCollection) {
+                // Scalar or empty collection: fits on the same line as the key.
+                lines.push(`${k}: ${valLines[0]}`);
+            }
+            else {
+                // Block style: key on its own line, value indented below.
+                lines.push(`${k}:`);
+                for (const l of valLines)
+                    lines.push(`  ${l}`);
+            }
+        }
+        return lines;
+    }
+    return [String(value)];
+}
+/**
+ * Serialise an {@link OpenApiDocument} to either JSON or YAML.
+ *
+ * - `'json'` — pretty-printed with 2-space indentation.
+ * - `'yaml'` — block-style YAML 1.2, produced by a zero-dependency serialiser
+ *   built into expediate.
+ *
+ * @param doc    - The document to serialise.
+ * @param format - Output format (`'json'` by default).
+ */
+export function serializeSpec(doc, format = 'json') {
+    if (format === 'yaml')
+        return toYamlLines(doc).join('\n') + '\n';
+    return JSON.stringify(doc, null, 2);
+}
+// ---------------------------------------------------------------------------
+// Symbol for attaching metadata to handler functions
+// ---------------------------------------------------------------------------
+/**
+ * Unique symbol used as a non-enumerable property key on handler functions
+ * that have been annotated via {@link describe}.
+ *
+ * Using a `unique symbol` (rather than a plain string key) prevents accidental
+ * collisions with user-defined properties on handler objects.
+ */
+export const DESCRIBE_META = Symbol('expediate.openapi.meta');
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Annotate a service method handler with OpenAPI operation metadata.
+ *
+ * The metadata is attached to the returned function via a non-enumerable
+ * property keyed by {@link DESCRIBE_META}.  The returned function is otherwise
+ * identical to `handler` — it can be used directly in a `ServiceDefinition`
+ * route map.
+ *
+ * ```ts
+ * GET: {
+ *   '/items/:id': describe(
+ *     function (this: TodoService, p) {
+ *       return this.findOrFail(p.id);
+ *     },
+ *     {
+ *       summary: 'Get a single item by ID',
+ *       tags: ['items'],
+ *       parameters: [{ name: 'id', in: 'path', required: true, schema: { type: 'string' } }],
+ *       responses: {
+ *         '200': { description: 'The item', content: { 'application/json': { schema: { $ref: '#/components/schemas/Item' } } } },
+ *         '404': { description: 'Not found' },
+ *       },
+ *     },
+ *   ),
+ * }
+ * ```
+ *
+ * @param handler - The service method to annotate.
+ * @param meta    - OpenAPI operation metadata.
+ * @returns The same handler function, with metadata attached.
+ */
+export function describe(handler, meta) {
+    // Wrap the handler so we have a fresh function object to attach metadata to,
+    // avoiding unexpected mutations of functions shared across route maps.
+    const described = function (ctx, body) {
+        return handler.apply(this, [ctx, body]);
+    };
+    // Attach metadata as a non-enumerable property so it is invisible to
+    // Object.keys() / JSON.stringify() and does not pollute the function's
+    // "own" enumerable surface.
+    Object.defineProperty(described, DESCRIBE_META, {
+        value: meta,
+        enumerable: false,
+        configurable: true,
+        writable: false,
+    });
+    return described;
+}
+// ---------------------------------------------------------------------------
+// Internal path-translation helpers
+// ---------------------------------------------------------------------------
+/**
+ * Convert an Express-style path pattern to an OpenAPI path pattern.
+ *
+ * - `:param` segments become `{param}`.
+ * - An optional `basePath` prefix is prepended (with duplicate-slash guards).
+ *
+ * @example
+ * ```ts
+ * toOpenApiPath('/items/:id', '/api/v1') // → '/api/v1/items/{id}'
+ * toOpenApiPath('/items',     '')         // → '/items'
+ * ```
+ */
+function toOpenApiPath(pattern, basePath) {
+    const converted = pattern.replace(/:([A-Za-z_][A-Za-z0-9_]*)/g, '{$1}');
+    if (!basePath)
+        return converted;
+    const base = basePath.replace(/\/+$/, '');
+    const path = converted.replace(/^\/+/, '/');
+    return base + (path.startsWith('/') ? path : `/${path}`);
+}
+/**
+ * Extract named path parameters from an Express-style pattern as
+ * {@link ParameterObject} entries with `in: 'path'` and `required: true`.
+ *
+ * Parameters already listed in `annotated` (by name) are skipped to avoid
+ * duplicates when the caller has provided explicit metadata for them.
+ *
+ * @param pattern   - Express-style route pattern (e.g. `/items/:id`).
+ * @param annotated - Explicit parameters provided by the caller (may be empty).
+ */
+function extractPathParams(pattern, annotated) {
+    const annotatedNames = new Set(annotated.map(p => p.name));
+    const params = [];
+    for (const match of pattern.matchAll(/:([A-Za-z_][A-Za-z0-9_]*)/g)) {
+        const name = match[1];
+        if (!annotatedNames.has(name)) {
+            params.push({
+                name,
+                in: 'path',
+                required: true,
+                schema: { type: 'string' },
+            });
+        }
+    }
+    return params;
+}
+/**
+ * Build an `operationId` string from an HTTP verb and a path pattern.
+ *
+ * The algorithm:
+ * 1. Lowercase the verb (e.g. `'GET'` → `'get'`).
+ * 2. Split the pattern on `/` and `:` (and `{` / `}` for pre-translated paths).
+ * 3. CamelCase each non-empty segment (first-letter uppercase).
+ * 4. Prefix each path-param segment with `'By'`.
+ * 5. Join everything into a single camelCase string.
+ *
+ * @example
+ * ```ts
+ * buildOperationId('GET',    '/items')     // → 'getItems'
+ * buildOperationId('GET',    '/items/:id') // → 'getItemsById'
+ * buildOperationId('DELETE', '/a/:b/:c')   // → 'deleteAByBByC'
+ * ```
+ */
+function buildOperationId(verb, pattern) {
+    const parts = pattern.split(/[/:{} ]+/).filter(Boolean);
+    let result = verb.toLowerCase();
+    for (const part of parts) {
+        const isParam = pattern.includes(`:${part}`) || pattern.includes(`{${part}}`);
+        const pascal = part.charAt(0).toUpperCase() + part.slice(1);
+        result += isParam ? `By${pascal}` : pascal;
+    }
+    return result;
+}
+/**
+ * Build the default responses for an operation when none are provided by the
+ * caller.
+ *
+ * - `POST` → `201 No Content` (successful write with no response body).
+ * - All other verbs → `200 OK` with a generic JSON response.
+ * - `500` → always added as a reference to the built-in `ApiError` component.
+ */
+function buildDefaultResponses(verb) {
+    const ok = verb === 'POST'
+        ? { description: 'Created' }
+        : { description: 'OK', content: { 'application/json': {} } };
+    return {
+        [verb === 'POST' ? '201' : '200']: ok,
+        '500': { $ref: '#/components/responses/ApiError' },
+    };
+}
+/**
+ * Convert caller-provided `responses` metadata into the OpenAPI responses
+ * map, injecting the built-in `ApiError` reference for `500` unless the
+ * caller has explicitly provided one.
+ */
+function buildAnnotatedResponses(responses) {
+    const result = { ...responses };
+    if (!result['500']) {
+        result['500'] = { $ref: '#/components/responses/ApiError' };
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Core spec generator
+// ---------------------------------------------------------------------------
+/** The five HTTP verbs supported by `apiBuilder`. */
+const VERBS = ['GET', 'POST', 'PUT', 'DELETE', 'PATCH'];
+/**
+ * Generate an OpenAPI 3.1.0 document from a {@link ServiceDefinition}.
+ *
+ * Route handlers that have been annotated with {@link describe} contribute
+ * rich operation metadata (summary, description, parameters, requestBody,
+ * responses).  Unannotated handlers receive sensible defaults automatically.
+ *
+ * The generated document always includes:
+ * - An `ApiError` schema (shape: `{ status?, message?, data? }`) in
+ *   `components.schemas`.
+ * - An `ApiError` response (`500` reference) in `components.responses`.
+ *
+ * Caller-supplied `opts.schemas` and service-level `openapi.schemas` are
+ * deep-merged on top of the built-in components (caller schemas take
+ * precedence over service schemas, which take precedence over built-ins).
+ *
+ * @param service - The service definition to document.
+ * @param opts    - Top-level spec options (title, version, basePath, …).
+ * @returns A fully-formed OpenAPI 3.1.0 document object.
+ *
+ * @example
+ * ```ts
+ * const spec = openApiSpec(todoDefinition, {
+ *   title:    'Todo API',
+ *   version:  '1.0.0',
+ *   basePath: '/api',
+ * });
+ *
+ * app.get('/openapi.json', (_req, res) => {
+ *   res.json(spec);
+ * });
+ * ```
+ */
+export function openApiSpec(service, opts) {
+    const basePath = opts.basePath ?? '';
+    const svcMeta = service.openapi;
+    const defaultTag = svcMeta?.tag;
+    // ── Components ──────────────────────────────────────────────────────────────
+    const builtinSchemas = {
+        ApiError: {
+            type: 'object',
+            properties: {
+                status: { type: 'integer', description: 'HTTP status code' },
+                message: { type: 'string', description: 'Human-readable error message' },
+                data: { description: 'Structured error payload (overrides message when present)' },
+            },
+        },
+    };
+    const builtinResponses = {
+        ApiError: {
+            description: 'API error response',
+            content: {
+                'application/json': { schema: { $ref: '#/components/schemas/ApiError' } },
+            },
+        },
+    };
+    // Merge schemas: built-ins ← service-level ← caller-level (last wins).
+    const schemas = {
+        ...builtinSchemas,
+        ...svcMeta?.schemas,
+        ...opts.schemas,
+    };
+    const responses = {
+        ...builtinResponses,
+        ...svcMeta?.responses,
+    };
+    // ── Tags ─────────────────────────────────────────────────────────────────────
+    const tags = [];
+    if (defaultTag) {
+        tags.push({ name: defaultTag, description: svcMeta?.tagDescription });
+    }
+    // ── Paths ────────────────────────────────────────────────────────────────────
+    const paths = {};
+    for (const verb of VERBS) {
+        const routeMap = service[verb];
+        if (!routeMap)
+            continue;
+        for (const [pattern, handler] of Object.entries(routeMap)) {
+            const openApiPath = toOpenApiPath(pattern, basePath);
+            if (!paths[openApiPath])
+                paths[openApiPath] = {};
+            // Retrieve attached metadata (if any).
+            const meta = handler[DESCRIBE_META];
+            // ── Parameters ─────────────────────────────────────────────────────────
+            const annotatedParams = meta?.parameters ?? [];
+            const inferredParams = extractPathParams(pattern, annotatedParams);
+            const parameters = [...annotatedParams, ...inferredParams];
+            // ── Responses ──────────────────────────────────────────────────────────
+            const operationResponses = meta?.responses
+                ? buildAnnotatedResponses(meta.responses)
+                : buildDefaultResponses(verb);
+            // ── Operation object ───────────────────────────────────────────────────
+            const operation = {
+                operationId: meta?.operationId ?? buildOperationId(verb, pattern),
+                ...(meta?.summary && { summary: meta.summary }),
+                ...(meta?.description && { description: meta.description }),
+                ...(meta?.deprecated && { deprecated: true }),
+                ...(parameters.length > 0 && { parameters }),
+                ...(meta?.requestBody && { requestBody: meta.requestBody }),
+                responses: operationResponses,
+            };
+            // Apply default tag when the operation has no explicit tags.
+            const opTags = meta?.tags ?? (defaultTag ? [defaultTag] : undefined);
+            if (opTags)
+                operation['tags'] = opTags;
+            // Carry through any vendor extensions (x-* keys).
+            if (meta) {
+                for (const [k, v] of Object.entries(meta)) {
+                    if (k.startsWith('x-'))
+                        operation[k] = v;
+                }
+            }
+            paths[openApiPath][verb.toLowerCase()] = operation;
+        }
+    }
+    // ── Assemble document ────────────────────────────────────────────────────────
+    const doc = {
+        openapi: '3.1.0',
+        info: {
+            title: opts.title,
+            version: opts.version,
+            ...(opts.description && { description: opts.description }),
+        },
+        ...(opts.servers && { servers: opts.servers }),
+        ...(tags.length > 0 && { tags }),
+        paths,
+        components: { schemas, responses },
+    };
+    return doc;
+}
+//# sourceMappingURL=openapi.js.map

package/dist/openapi.js.map

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