@wildo-ai/saas-technical-doc 1.1.1

package/dist/esm/runtime/openapi-reference-model.d.ts.map

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

package/dist/esm/runtime/openapi-reference-model.js

@@ -0,0 +1,579 @@
+/**
+ * Browser-safe projection of one generated OpenAPI document.
+ *
+ * Navigation is derived in memory from the verified OpenAPI bytes. The model
+ * deliberately persists nothing and never invents API meaning: resource tags,
+ * `operationId`, standard OpenAPI method/path fields and `x-wildo` source
+ * identity are its only inputs.
+ */
+import { ApiReferenceTargetKind, apiReferenceTargetFragment } from '../openapi/api-reference-targets.js';
+/** OpenAPI composition keywords are distinct contracts, not interchangeable labels. */
+export var ApiReferenceSchemaCompositionKind;
+(function (ApiReferenceSchemaCompositionKind) {
+    ApiReferenceSchemaCompositionKind["ONE_OF"] = "oneOf";
+    ApiReferenceSchemaCompositionKind["ANY_OF"] = "anyOf";
+    ApiReferenceSchemaCompositionKind["ALL_OF"] = "allOf";
+})(ApiReferenceSchemaCompositionKind || (ApiReferenceSchemaCompositionKind = {}));
+/** Standard Schema Object constraint keywords preserved without interpretation. */
+export var ApiReferenceSchemaConstraintKind;
+(function (ApiReferenceSchemaConstraintKind) {
+    ApiReferenceSchemaConstraintKind["MINIMUM"] = "minimum";
+    ApiReferenceSchemaConstraintKind["MAXIMUM"] = "maximum";
+    ApiReferenceSchemaConstraintKind["EXCLUSIVE_MINIMUM"] = "exclusiveMinimum";
+    ApiReferenceSchemaConstraintKind["EXCLUSIVE_MAXIMUM"] = "exclusiveMaximum";
+    ApiReferenceSchemaConstraintKind["MULTIPLE_OF"] = "multipleOf";
+    ApiReferenceSchemaConstraintKind["MIN_LENGTH"] = "minLength";
+    ApiReferenceSchemaConstraintKind["MAX_LENGTH"] = "maxLength";
+    ApiReferenceSchemaConstraintKind["PATTERN"] = "pattern";
+    ApiReferenceSchemaConstraintKind["MIN_ITEMS"] = "minItems";
+    ApiReferenceSchemaConstraintKind["MAX_ITEMS"] = "maxItems";
+    ApiReferenceSchemaConstraintKind["UNIQUE_ITEMS"] = "uniqueItems";
+    ApiReferenceSchemaConstraintKind["MIN_PROPERTIES"] = "minProperties";
+    ApiReferenceSchemaConstraintKind["MAX_PROPERTIES"] = "maxProperties";
+})(ApiReferenceSchemaConstraintKind || (ApiReferenceSchemaConstraintKind = {}));
+/**
+ * OpenAPI path-item members that describe an HTTP operation. Other members,
+ * such as path-level parameters, are not individually navigable reference
+ * entries. Every member in this vocabulary must carry Wildo identity metadata:
+ * silently ignoring one would make the rendered reference incomplete.
+ */
+const OPENAPI_HTTP_METHODS = new Set(['get', 'put', 'post', 'delete', 'options', 'head', 'patch', 'trace']);
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function documentInfo(value) {
+    if (value === undefined)
+        return { title: null, description: null };
+    if (!isRecord(value))
+        throw new Error('API reference document has malformed OpenAPI info');
+    if (value.title !== undefined && typeof value.title !== 'string')
+        throw new Error('API reference document has malformed OpenAPI info.title');
+    if (value.description !== undefined && typeof value.description !== 'string')
+        throw new Error('API reference document has malformed OpenAPI info.description');
+    return {
+        title: typeof value.title === 'string' ? value.title : null,
+        description: typeof value.description === 'string' ? value.description : null,
+    };
+}
+function documentServers(value) {
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value))
+        throw new Error('API reference document has malformed OpenAPI servers');
+    return value.map((server, index) => {
+        if (!isRecord(server) || typeof server.url !== 'string')
+            throw new Error(`API reference server at index ${index} has no URL`);
+        if (server.description !== undefined && typeof server.description !== 'string') {
+            throw new Error(`API reference server at index ${index} has a malformed description`);
+        }
+        return {
+            url: server.url,
+            description: typeof server.description === 'string' ? server.description : null,
+        };
+    });
+}
+function documentSecuritySchemes(value) {
+    if (value === undefined)
+        return [];
+    if (!isRecord(value))
+        throw new Error('API reference document has malformed OpenAPI security schemes');
+    return Object.entries(value).map(([name, scheme]) => {
+        if (!isRecord(scheme) || typeof scheme.type !== 'string')
+            throw new Error(`API reference security scheme '${name}' is malformed`);
+        for (const field of ['scheme', 'bearerFormat', 'in', 'name', 'description']) {
+            if (scheme[field] !== undefined && typeof scheme[field] !== 'string') {
+                throw new Error(`API reference security scheme '${name}' has malformed '${field}'`);
+            }
+        }
+        return {
+            name,
+            type: scheme.type,
+            scheme: typeof scheme.scheme === 'string' ? scheme.scheme : null,
+            bearerFormat: typeof scheme.bearerFormat === 'string' ? scheme.bearerFormat : null,
+            location: typeof scheme.in === 'string' ? scheme.in : null,
+            parameterName: typeof scheme.name === 'string' ? scheme.name : null,
+            description: typeof scheme.description === 'string' ? scheme.description : null,
+        };
+    }).sort((left, right) => left.name.localeCompare(right.name));
+}
+function access(value) {
+    if (!isRecord(value) || typeof value.authenticationMode !== 'string' || typeof value.authenticationSummary !== 'string' || !Array.isArray(value.roleRequirements)) {
+        throw new Error('API reference operation has no valid x-wildo access contract');
+    }
+    const roleRequirements = value.roleRequirements.map((requirement) => {
+        if (!isRecord(requirement) || typeof requirement.role !== 'string' || typeof requirement.label !== 'string') {
+            throw new Error('API reference operation has a malformed x-wildo role requirement');
+        }
+        if (requirement.businessRole !== null && requirement.businessRole !== undefined && typeof requirement.businessRole !== 'string') {
+            throw new Error('API reference operation has a malformed role business explanation');
+        }
+        if (requirement.authorityBoundary !== null && requirement.authorityBoundary !== undefined && typeof requirement.authorityBoundary !== 'string') {
+            throw new Error('API reference operation has a malformed role authority boundary');
+        }
+        return {
+            role: requirement.role,
+            label: requirement.label,
+            businessRole: typeof requirement.businessRole === 'string' ? requirement.businessRole : null,
+            authorityBoundary: typeof requirement.authorityBoundary === 'string' ? requirement.authorityBoundary : null,
+        };
+    });
+    return {
+        authenticationMode: value.authenticationMode,
+        authenticationSummary: value.authenticationSummary,
+        roleRequirements,
+    };
+}
+function componentSchemaReference(value) {
+    if (!isRecord(value) || typeof value.$ref !== 'string')
+        return null;
+    const schemaName = value.$ref.match(/^#\/components\/schemas\/([^/]+)$/)?.[1];
+    return schemaName === undefined
+        ? { name: value.$ref, anchorId: null }
+        : {
+            name: schemaName,
+            anchorId: apiReferenceTargetFragment({ kind: ApiReferenceTargetKind.COMPONENT_SCHEMA, schemaName }),
+        };
+}
+function serializeExampleJson(value) {
+    if (value === undefined)
+        return null;
+    try {
+        const serialized = JSON.stringify(value, null, 2);
+        return typeof serialized === 'string' ? serialized : null;
+    }
+    catch {
+        // A malformed external OpenAPI document must not make the reference page
+        // unusable merely because an example cannot be represented as JSON.
+        return null;
+    }
+}
+function schemaConstraint(schema, kind) {
+    const jsonValue = serializeExampleJson(schema[kind]);
+    return jsonValue === null ? null : { kind, jsonValue };
+}
+function schemaNodeOrThrow(value, owner) {
+    const schema = schemaNode(value);
+    if (schema === null)
+        throw new Error(`API reference ${owner} has a malformed OpenAPI schema`);
+    return schema;
+}
+/**
+ * Recursively projects only fields supplied by the OpenAPI Schema Object.
+ *
+ * semantic-literal-boundary: OpenAPI 3.1 Schema Object keywords are translated
+ * once at this browser boundary; React consumes the named model exclusively.
+ */
+function schemaNode(value) {
+    if (typeof value === 'boolean') {
+        return {
+            booleanSchema: value,
+            referenceName: null,
+            referenceAnchorId: null,
+            types: [],
+            description: null,
+            format: null,
+            properties: [],
+            items: null,
+            compositions: [],
+            enumValues: [],
+            constValue: null,
+            defaultValue: null,
+            constraints: [],
+            additionalProperties: null,
+        };
+    }
+    if (!isRecord(value))
+        return null;
+    const reference = componentSchemaReference(value);
+    const requiredPropertyNames = Array.isArray(value.required)
+        ? new Set(value.required.filter((propertyName) => typeof propertyName === 'string'))
+        : new Set();
+    const properties = isRecord(value.properties)
+        ? Object.entries(value.properties).map(([name, propertySchema]) => ({
+            name,
+            required: requiredPropertyNames.has(name),
+            schema: schemaNodeOrThrow(propertySchema, `property '${name}'`),
+        })).sort((left, right) => left.name.localeCompare(right.name))
+        : [];
+    const compositionSources = [
+        [ApiReferenceSchemaCompositionKind.ONE_OF, value.oneOf],
+        [ApiReferenceSchemaCompositionKind.ANY_OF, value.anyOf],
+        [ApiReferenceSchemaCompositionKind.ALL_OF, value.allOf],
+    ];
+    const compositions = compositionSources.flatMap(([kind, branches]) => {
+        if (!Array.isArray(branches))
+            return [];
+        return [{ kind, branches: branches.map((branch, index) => schemaNodeOrThrow(branch, `${kind} branch ${index}`)) }];
+    });
+    const enumDescriptions = isRecord(value['x-enum-descriptions']) ? value['x-enum-descriptions'] : {};
+    const enumValues = Array.isArray(value.enum)
+        ? value.enum.flatMap((enumValue) => {
+            const jsonValue = serializeExampleJson(enumValue);
+            if (jsonValue === null)
+                return [];
+            const description = enumDescriptions[String(enumValue)];
+            return [{ jsonValue, description: typeof description === 'string' ? description : null }];
+        })
+        : [];
+    const types = typeof value.type === 'string'
+        ? [value.type]
+        : Array.isArray(value.type)
+            ? value.type.filter((type) => typeof type === 'string')
+            : [];
+    const additionalProperties = value.additionalProperties === undefined
+        ? null
+        : typeof value.additionalProperties === 'boolean'
+            ? value.additionalProperties
+            : schemaNodeOrThrow(value.additionalProperties, 'additionalProperties');
+    return {
+        booleanSchema: null,
+        referenceName: reference?.name ?? null,
+        referenceAnchorId: reference?.anchorId ?? null,
+        types,
+        description: typeof value.description === 'string' ? value.description : null,
+        format: typeof value.format === 'string' ? value.format : null,
+        properties,
+        items: value.items === undefined ? null : schemaNodeOrThrow(value.items, 'array items'),
+        compositions,
+        enumValues,
+        constValue: serializeExampleJson(value.const),
+        defaultValue: serializeExampleJson(value.default),
+        constraints: [
+            schemaConstraint(value, ApiReferenceSchemaConstraintKind.MINIMUM),
+            schemaConstraint(value, ApiReferenceSchemaConstraintKind.MAXIMUM),
+            schemaConstraint(value, ApiReferenceSchemaConstraintKind.EXCLUSIVE_MINIMUM),
+            schemaConstraint(value, ApiReferenceSchemaConstraintKind.EXCLUSIVE_MAXIMUM),
+            schemaConstraint(value, ApiReferenceSchemaConstraintKind.MULTIPLE_OF),
+            schemaConstraint(value, ApiReferenceSchemaConstraintKind.MIN_LENGTH),
+            schemaConstraint(value, ApiReferenceSchemaConstraintKind.MAX_LENGTH),
+            schemaConstraint(value, ApiReferenceSchemaConstraintKind.PATTERN),
+            schemaConstraint(value, ApiReferenceSchemaConstraintKind.MIN_ITEMS),
+            schemaConstraint(value, ApiReferenceSchemaConstraintKind.MAX_ITEMS),
+            schemaConstraint(value, ApiReferenceSchemaConstraintKind.UNIQUE_ITEMS),
+            schemaConstraint(value, ApiReferenceSchemaConstraintKind.MIN_PROPERTIES),
+            schemaConstraint(value, ApiReferenceSchemaConstraintKind.MAX_PROPERTIES),
+        ].filter((constraint) => constraint !== null),
+        additionalProperties,
+    };
+}
+function openApiExamples(value) {
+    if (!isRecord(value))
+        return [];
+    return Object.entries(value)
+        .map(([name, example]) => {
+        if (!isRecord(example))
+            return null;
+        return {
+            name,
+            summary: typeof example.summary === 'string' ? example.summary : null,
+            description: typeof example.description === 'string' ? example.description : null,
+            jsonValue: serializeExampleJson(example.value),
+            externalValue: typeof example.externalValue === 'string' ? example.externalValue : null,
+        };
+    })
+        .filter((example) => example !== null)
+        .sort((left, right) => left.name.localeCompare(right.name));
+}
+function mediaTypes(value) {
+    if (!isRecord(value))
+        return [];
+    return Object.entries(value).map(([mediaType, representation]) => {
+        if (!isRecord(representation))
+            return { mediaType, schema: null, examples: [] };
+        const namedExamples = openApiExamples(representation.examples);
+        const inlineExample = representation.example === undefined
+            ? []
+            : [{ name: 'Example', summary: null, description: null, jsonValue: serializeExampleJson(representation.example), externalValue: null }];
+        return {
+            mediaType,
+            schema: representation.schema === undefined ? null : schemaNodeOrThrow(representation.schema, `media type '${mediaType}'`),
+            examples: [...namedExamples, ...inlineExample],
+        };
+    }).sort((a, b) => a.mediaType.localeCompare(b.mediaType));
+}
+/** Projects reusable OpenAPI components without re-authoring their schema meaning in React. */
+function componentSchemas(value) {
+    if (!isRecord(value))
+        return [];
+    return Object.entries(value).map(([name, sourceSchema]) => {
+        const schema = schemaNodeOrThrow(sourceSchema, `component schema '${name}'`);
+        return {
+            name,
+            anchorId: apiReferenceTargetFragment({ kind: ApiReferenceTargetKind.COMPONENT_SCHEMA, schemaName: name }),
+            schema,
+        };
+    }).sort((left, right) => left.name.localeCompare(right.name));
+}
+function parameter(value) {
+    if (!isRecord(value) || typeof value.name !== 'string' || typeof value.in !== 'string')
+        return null;
+    const namedExamples = openApiExamples(value.examples);
+    const inlineExample = value.example === undefined
+        ? []
+        : [{ name: 'Example', summary: null, description: null, jsonValue: serializeExampleJson(value.example), externalValue: null }];
+    return {
+        name: value.name,
+        location: value.in,
+        required: value.required === true,
+        description: typeof value.description === 'string' ? value.description : null,
+        schema: value.schema === undefined ? null : schemaNodeOrThrow(value.schema, `parameter '${value.name}'`),
+        // Parameter Object supports the same named-example and single-inline-example
+        // forms as Media Type Object. Preserve either form from external OpenAPI;
+        // source generation currently emits the named form for query inputs.
+        examples: [...namedExamples, ...inlineExample],
+    };
+}
+function requestBody(value, operationId) {
+    if (!isRecord(value))
+        return null;
+    return {
+        anchorId: apiReferenceTargetFragment({ kind: ApiReferenceTargetKind.REQUEST, operationId }),
+        required: value.required === true,
+        mediaTypes: mediaTypes(value.content),
+    };
+}
+function responses(value, operationId) {
+    if (!isRecord(value))
+        return [];
+    return Object.entries(value).map(([status, response]) => ({
+        anchorId: apiReferenceTargetFragment({ kind: ApiReferenceTargetKind.RESPONSE, operationId, status }),
+        status,
+        description: isRecord(response) && typeof response.description === 'string' ? response.description : null,
+        mediaTypes: isRecord(response) ? mediaTypes(response.content) : [],
+    })).sort((a, b) => a.status.localeCompare(b.status, undefined, { numeric: true }));
+}
+function securitySchemes(value) {
+    if (!Array.isArray(value))
+        return [];
+    return [...new Set(value.flatMap((requirement) => isRecord(requirement) ? Object.keys(requirement) : []))].sort((a, b) => a.localeCompare(b));
+}
+function resourceRelationships(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.map((relationship, index) => {
+        if (!isRecord(relationship)
+            || typeof relationship.relatedResourceName !== 'string'
+            || typeof relationship.resourceCardinality !== 'string'
+            || typeof relationship.relatedResourceCardinality !== 'string'
+            || typeof relationship.nature !== 'string'
+            || typeof relationship.lifecycleModel !== 'string') {
+            throw new Error(`API reference resource relationship at index ${index} is malformed`);
+        }
+        const parentDelete = relationship.onParentDelete;
+        if (parentDelete !== undefined && (!isRecord(parentDelete)
+            || typeof parentDelete.enabled !== 'boolean'
+            || typeof parentDelete.mode !== 'string'
+            || typeof parentDelete.strategy !== 'string'
+            || typeof parentDelete.maxDepth !== 'number')) {
+            throw new Error(`API reference resource relationship at index ${index} has malformed parent-delete lifecycle`);
+        }
+        return {
+            relatedResourceName: relationship.relatedResourceName,
+            relatedResourceLabel: relationship.relatedResourceName,
+            foreignKeyField: typeof relationship.foreignKeyField === 'string' ? relationship.foreignKeyField : null,
+            resourceCardinality: relationship.resourceCardinality,
+            relatedResourceCardinality: relationship.relatedResourceCardinality,
+            nature: relationship.nature,
+            lifecycleModel: relationship.lifecycleModel,
+            onParentDelete: isRecord(parentDelete) ? {
+                enabled: parentDelete.enabled,
+                mode: parentDelete.mode,
+                strategy: parentDelete.strategy,
+                maxDepth: parentDelete.maxDepth,
+            } : null,
+        };
+    });
+}
+/** Parses the strict category contract carried by `tags[].x-wildo.category`. */
+function resourceCategory(value) {
+    if (value === undefined)
+        return null;
+    if (!isRecord(value) || typeof value.id !== 'string' || typeof value.label !== 'string') {
+        throw new Error('API reference resource tag has malformed x-wildo category');
+    }
+    if (value.description !== undefined && typeof value.description !== 'string') {
+        throw new Error('API reference resource tag has malformed category description');
+    }
+    return {
+        id: value.id,
+        anchorId: apiReferenceTargetFragment({ kind: ApiReferenceTargetKind.CATEGORY, categoryName: value.id }),
+        label: value.label,
+        description: typeof value.description === 'string' ? value.description : null,
+    };
+}
+function operationFamilyLabel(familyRef) {
+    const identifier = familyRef.split('/operation-family/').at(-1)?.split('/').at(0) ?? familyRef;
+    return identifier.replace(/([a-z])([A-Z])/g, '$1 $2').replace(/[-_]/g, ' ').replace(/^./, (character) => character.toUpperCase());
+}
+/**
+ * Presentation-only fallback for a resource whose related tag is absent from
+ * this section (for example, a cron-only resource). It never changes the
+ * canonical resource identity; it only prevents raw camelCase identifiers from
+ * leaking into the reference when no source-authored display tag is available.
+ */
+function resourceDisplayLabel(identifier) {
+    return identifier
+        .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+        .replace(/[-_]/g, ' ')
+        .replace(/\b\w/g, (character) => character.toUpperCase());
+}
+/** Creates the two-level resource → operation-family view from OpenAPI. */
+export function createApiReferenceModel(document) {
+    if (!isRecord(document) || !isRecord(document.paths))
+        throw new Error('API reference document has no OpenAPI paths object');
+    const info = documentInfo(document.info);
+    const resourceTags = new Map();
+    if (Array.isArray(document.tags)) {
+        for (const tag of document.tags) {
+            if (isRecord(tag) && typeof tag.name === 'string') {
+                if (!isRecord(tag['x-wildo']) || typeof tag['x-wildo'].resourceRef !== 'string') {
+                    throw new Error(`API reference resource tag '${tag.name}' has no x-wildo resource identity`);
+                }
+                if (resourceTags.has(tag.name))
+                    throw new Error(`API reference resource tag is duplicated: ${tag.name}`);
+                resourceTags.set(tag.name, {
+                    resourceRef: tag['x-wildo'].resourceRef,
+                    label: typeof tag['x-displayName'] === 'string' ? tag['x-displayName'] : resourceDisplayLabel(tag.name),
+                    description: typeof tag.description === 'string' ? tag.description : null,
+                    category: resourceCategory(tag['x-wildo'].category),
+                    lifecycleRole: typeof tag['x-wildo'].lifecycleRole === 'string' ? tag['x-wildo'].lifecycleRole : null,
+                    relationships: resourceRelationships(tag['x-wildo'].relationships),
+                });
+            }
+        }
+    }
+    const resources = new Map();
+    const operationIds = new Set();
+    const operationVariantRefs = new Set();
+    for (const [path, item] of Object.entries(document.paths)) {
+        if (!isRecord(item))
+            continue;
+        for (const [method, operation] of Object.entries(item)) {
+            if (!OPENAPI_HTTP_METHODS.has(method))
+                continue;
+            if (!isRecord(operation))
+                throw new Error(`API reference ${method.toUpperCase()} ${path} operation is malformed`);
+            if (!isRecord(operation['x-wildo']))
+                throw new Error(`API reference ${method.toUpperCase()} ${path} operation has no x-wildo identity`);
+            const metadata = operation['x-wildo'];
+            if (typeof metadata.resourceRef !== 'string' || typeof metadata.operationFamilyRef !== 'string' || typeof metadata.operationVariantRef !== 'string') {
+                throw new Error('API reference operation has malformed x-wildo identity');
+            }
+            if (metadata.path !== path || metadata.httpVerb !== method.toLowerCase())
+                throw new Error('API reference operation x-wildo identity does not match its OpenAPI method/path');
+            if (typeof operation.operationId !== 'string' || operation.operationId.length === 0)
+                throw new Error('API reference operation has no operationId');
+            if (operationIds.has(operation.operationId))
+                throw new Error(`API reference operationId is duplicated: ${operation.operationId}`);
+            operationIds.add(operation.operationId);
+            if (operationVariantRefs.has(metadata.operationVariantRef))
+                throw new Error(`API reference operation variant identity is duplicated: ${metadata.operationVariantRef}`);
+            operationVariantRefs.add(metadata.operationVariantRef);
+            const resource = resources.get(metadata.resourceRef) ?? new Map();
+            const family = resource.get(metadata.operationFamilyRef) ?? [];
+            family.push({
+                variantRef: metadata.operationVariantRef,
+                anchorId: apiReferenceTargetFragment({ kind: ApiReferenceTargetKind.OPERATION, operationId: operation.operationId }),
+                operationId: operation.operationId,
+                summary: typeof operation.summary === 'string' ? operation.summary : `${method.toUpperCase()} ${path}`,
+                description: typeof operation.description === 'string' ? operation.description : null,
+                method: method.toUpperCase(),
+                path,
+                access: access(metadata.access),
+                securitySchemes: securitySchemes(operation.security),
+                parameters: Array.isArray(operation.parameters) ? operation.parameters.map(parameter).filter((item) => item !== null) : [],
+                requestBody: requestBody(operation.requestBody, operation.operationId),
+                responses: responses(operation.responses, operation.operationId),
+                idempotent: typeof operation['x-idempotent'] === 'boolean' ? operation['x-idempotent'] : null,
+            });
+            resource.set(metadata.operationFamilyRef, family);
+            resources.set(metadata.resourceRef, resource);
+        }
+    }
+    const result = [...resources.entries()].map(([resourceRef, families]) => {
+        const tagName = resourceRef.split('/').at(-1) ?? resourceRef;
+        const tag = resourceTags.get(tagName);
+        if (tag === undefined)
+            throw new Error(`API reference resource '${resourceRef}' has no generated OpenAPI tag`);
+        if (tag.resourceRef !== resourceRef)
+            throw new Error(`API reference tag '${tagName}' resource identity does not match its operation identities`);
+        return {
+            resourceRef,
+            anchorId: apiReferenceTargetFragment({ kind: ApiReferenceTargetKind.RESOURCE, resourceName: tagName }),
+            label: tag.label,
+            category: tag.category,
+            description: tag.description,
+            lifecycleRole: tag.lifecycleRole,
+            relationships: tag.relationships.map((relationship) => ({
+                ...relationship,
+                relatedResourceLabel: resourceTags.get(relationship.relatedResourceName)?.label ?? resourceDisplayLabel(relationship.relatedResourceName),
+            })),
+            families: [...families.entries()].map(([familyRef, variants]) => ({
+                familyRef,
+                anchorId: apiReferenceTargetFragment({
+                    kind: ApiReferenceTargetKind.OPERATION_FAMILY,
+                    resourceName: tagName,
+                    operationName: familyRef.split('/').at(-1) ?? familyRef,
+                }),
+                label: operationFamilyLabel(familyRef),
+                variants: variants.sort((a, b) => `${a.path}:${a.method}`.localeCompare(`${b.path}:${b.method}`)),
+            })).sort((a, b) => a.familyRef.localeCompare(b.familyRef)),
+        };
+    }).sort((a, b) => a.label.localeCompare(b.label));
+    const parsedComponentSchemas = componentSchemas(isRecord(document.components) ? document.components.schemas : undefined);
+    assertCategoryMetadataIsConsistent(result);
+    assertPublicAnchorsAreUnique(result, parsedComponentSchemas);
+    return {
+        title: info.title,
+        description: info.description,
+        servers: documentServers(document.servers),
+        securitySchemes: documentSecuritySchemes(isRecord(document.components) ? document.components.securitySchemes : undefined),
+        resources: result,
+        componentSchemas: parsedComponentSchemas,
+        operationCount: result.flatMap((resource) => resource.families).reduce((count, family) => count + family.variants.length, 0),
+    };
+}
+/** A category id has one source-owned label and description throughout one document. */
+function assertCategoryMetadataIsConsistent(resources) {
+    const categories = new Map();
+    for (const resource of resources) {
+        if (resource.category === null)
+            continue;
+        const prior = categories.get(resource.category.id);
+        if (prior !== undefined && (prior.label !== resource.category.label || prior.description !== resource.category.description)) {
+            throw new Error(`API reference category '${resource.category.id}' has inconsistent source metadata`);
+        }
+        categories.set(resource.category.id, resource.category);
+    }
+}
+/**
+ * Public fragments must remain readable, but readability cannot excuse a
+ * collision. Rejecting a collision keeps copied links deterministic and makes
+ * the source identity that needs refinement visible to the generator owner.
+ */
+function assertPublicAnchorsAreUnique(resources, schemas) {
+    const ownerByAnchor = new Map();
+    const claim = (anchorId, owner) => {
+        const existingOwner = ownerByAnchor.get(anchorId);
+        if (existingOwner !== undefined) {
+            throw new Error(`API reference public fragment '${anchorId}' collides between ${existingOwner} and ${owner}`);
+        }
+        ownerByAnchor.set(anchorId, owner);
+    };
+    const categories = new Map(resources.flatMap((resource) => resource.category === null ? [] : [[resource.category.id, resource.category]]));
+    categories.forEach((category) => claim(category.anchorId, `category '${category.id}'`));
+    resources.forEach((resource) => {
+        claim(resource.anchorId, resource.resourceRef);
+        resource.families.forEach((family) => {
+            claim(family.anchorId, family.familyRef);
+            family.variants.forEach((variant) => {
+                claim(variant.anchorId, variant.variantRef);
+                if (variant.requestBody !== null)
+                    claim(variant.requestBody.anchorId, `${variant.variantRef}:request`);
+                variant.responses.forEach((response) => claim(response.anchorId, `${variant.variantRef}:response:${response.status}`));
+            });
+        });
+    });
+    schemas.forEach((schema) => claim(schema.anchorId, `components.schemas.${schema.name}`));
+}
+//# sourceMappingURL=openapi-reference-model.js.map