micro-contracts 0.9.0

package/dist/generator/typeGenerator.js

@@ -0,0 +1,395 @@
+/**
+ * TypeScript type generator from OpenAPI schemas
+ */
+import { isReference, getRefName } from '../types.js';
+/**
+ * Generate TypeScript type definitions from OpenAPI spec
+ */
+export function generateTypes(spec) {
+    const lines = [];
+    lines.push('/**');
+    lines.push(' * Auto-generated TypeScript types from OpenAPI specification');
+    lines.push(` * Generated from: ${spec.info.title} v${spec.info.version}`);
+    lines.push(' * DO NOT EDIT MANUALLY');
+    lines.push(' */');
+    lines.push('');
+    // Always include ProblemDetails (RFC 9457) for error handling
+    lines.push(generateProblemDetailsType());
+    lines.push('');
+    // Generate types from components/schemas
+    if (spec.components?.schemas) {
+        for (const [name, schema] of Object.entries(spec.components.schemas)) {
+            // Skip if already generated (e.g., ProblemDetails)
+            if (name === 'ProblemDetails')
+                continue;
+            lines.push(generateSchemaType(name, schema, spec));
+            lines.push('');
+        }
+    }
+    // Generate request/response types from paths
+    const operationTypes = generateOperationTypes(spec);
+    if (operationTypes) {
+        lines.push('// Operation-specific types');
+        lines.push(operationTypes);
+    }
+    return lines.join('\n');
+}
+/**
+ * Generate ProblemDetails type (RFC 9457)
+ * This is always included for standardized error handling
+ */
+function generateProblemDetailsType() {
+    return `/**
+ * RFC 9457 Problem Details for HTTP APIs
+ * @see https://www.rfc-editor.org/rfc/rfc9457.html
+ */
+export interface ProblemDetails {
+  /** A URI reference that identifies the problem type */
+  type: string;
+  /** A short, human-readable summary */
+  title: string;
+  /** The HTTP status code */
+  status: number;
+  /** A human-readable explanation specific to this occurrence */
+  detail?: string;
+  /** A URI reference to the specific occurrence */
+  instance?: string;
+  /** Application-specific error code (SCREAMING_SNAKE_CASE) */
+  code?: string;
+  /** Request trace ID for debugging */
+  traceId?: string;
+  /** Detailed validation errors */
+  errors?: ValidationError[];
+  /** Additional properties */
+  [key: string]: unknown;
+}
+
+/**
+ * Validation error detail
+ */
+export interface ValidationError {
+  /** JSON Pointer to the invalid field */
+  pointer: string;
+  /** Error message for this field */
+  detail: string;
+}`;
+}
+/**
+ * Generate TypeScript type for a single schema
+ */
+function generateSchemaType(name, schema, spec) {
+    if (isReference(schema)) {
+        const refName = getRefName(schema.$ref);
+        return `export type ${name} = ${refName};`;
+    }
+    // Handle allOf, oneOf, anyOf
+    if (schema.allOf) {
+        const types = schema.allOf.map(s => schemaToTypeString(s, spec)).join(' & ');
+        return `export type ${name} = ${types};`;
+    }
+    if (schema.oneOf) {
+        const types = schema.oneOf.map(s => schemaToTypeString(s, spec)).join(' | ');
+        return `export type ${name} = ${types};`;
+    }
+    if (schema.anyOf) {
+        const types = schema.anyOf.map(s => schemaToTypeString(s, spec)).join(' | ');
+        return `export type ${name} = ${types};`;
+    }
+    // Handle object type
+    if (schema.type === 'object' || schema.properties) {
+        return generateInterfaceType(name, schema, spec);
+    }
+    // Handle enum
+    if (schema.enum) {
+        const enumValues = schema.enum.map(v => typeof v === 'string' ? `'${v}'` : String(v)).join(' | ');
+        return `export type ${name} = ${enumValues};`;
+    }
+    // Handle array
+    if (schema.type === 'array' && schema.items) {
+        const itemType = schemaToTypeString(schema.items, spec);
+        return `export type ${name} = ${itemType}[];`;
+    }
+    // Handle primitive types
+    const tsType = primitiveToTsType(schema);
+    return `export type ${name} = ${tsType};`;
+}
+/**
+ * Generate interface type for object schema
+ */
+function generateInterfaceType(name, schema, spec) {
+    const lines = [];
+    const required = new Set(schema.required || []);
+    if (schema.description) {
+        lines.push(`/** ${schema.description} */`);
+    }
+    lines.push(`export interface ${name} {`);
+    if (schema.properties) {
+        for (const [propName, propSchema] of Object.entries(schema.properties)) {
+            const isRequired = required.has(propName);
+            const tsType = schemaToTypeString(propSchema, spec);
+            const optional = isRequired ? '' : '?';
+            // Add description as JSDoc if available
+            if (!isReference(propSchema) && propSchema.description) {
+                lines.push(`  /** ${propSchema.description} */`);
+            }
+            lines.push(`  ${propName}${optional}: ${tsType};`);
+        }
+    }
+    // Handle additionalProperties
+    if (schema.additionalProperties) {
+        if (typeof schema.additionalProperties === 'boolean') {
+            lines.push('  [key: string]: unknown;');
+        }
+        else {
+            const valueType = schemaToTypeString(schema.additionalProperties, spec);
+            lines.push(`  [key: string]: ${valueType};`);
+        }
+    }
+    lines.push('}');
+    return lines.join('\n');
+}
+/**
+ * Convert schema to TypeScript type string
+ */
+function schemaToTypeString(schema, spec) {
+    if (isReference(schema)) {
+        return getRefName(schema.$ref);
+    }
+    // Handle nullable
+    const nullable = schema.nullable ? ' | null' : '';
+    // Handle allOf, oneOf, anyOf
+    if (schema.allOf) {
+        const types = schema.allOf.map(s => schemaToTypeString(s, spec)).join(' & ');
+        return `(${types})${nullable}`;
+    }
+    if (schema.oneOf) {
+        const types = schema.oneOf.map(s => schemaToTypeString(s, spec)).join(' | ');
+        return `(${types})${nullable}`;
+    }
+    if (schema.anyOf) {
+        const types = schema.anyOf.map(s => schemaToTypeString(s, spec)).join(' | ');
+        return `(${types})${nullable}`;
+    }
+    // Handle enum
+    if (schema.enum) {
+        const enumValues = schema.enum.map(v => typeof v === 'string' ? `'${v}'` : String(v)).join(' | ');
+        return `(${enumValues})${nullable}`;
+    }
+    // Handle array
+    if (schema.type === 'array' && schema.items) {
+        const itemType = schemaToTypeString(schema.items, spec);
+        // Wrap item type in parentheses if it contains union types
+        const wrappedItemType = itemType.includes(' | ') || itemType.includes(' & ')
+            ? `(${itemType})`
+            : itemType;
+        return `${wrappedItemType}[]${nullable}`;
+    }
+    // Handle object with inline properties
+    if (schema.type === 'object' || schema.properties) {
+        if (!schema.properties) {
+            if (schema.additionalProperties) {
+                if (typeof schema.additionalProperties === 'boolean') {
+                    return `Record<string, unknown>${nullable}`;
+                }
+                const valueType = schemaToTypeString(schema.additionalProperties, spec);
+                return `Record<string, ${valueType}>${nullable}`;
+            }
+            return `Record<string, unknown>${nullable}`;
+        }
+        // Inline object - generate inline type
+        const props = [];
+        const required = new Set(schema.required || []);
+        for (const [propName, propSchema] of Object.entries(schema.properties)) {
+            const isRequired = required.has(propName);
+            const tsType = schemaToTypeString(propSchema, spec);
+            const optional = isRequired ? '' : '?';
+            props.push(`${propName}${optional}: ${tsType}`);
+        }
+        return `{ ${props.join('; ')} }${nullable}`;
+    }
+    // Handle primitive types
+    return primitiveToTsType(schema) + nullable;
+}
+/**
+ * Convert primitive OpenAPI type to TypeScript type
+ */
+function primitiveToTsType(schema) {
+    switch (schema.type) {
+        case 'string':
+            if (schema.format === 'date' || schema.format === 'date-time') {
+                return 'string'; // Keep as string, not Date
+            }
+            return 'string';
+        case 'integer':
+        case 'number':
+            return 'number';
+        case 'boolean':
+            return 'boolean';
+        case 'null':
+            return 'null';
+        default:
+            return 'unknown';
+    }
+}
+/**
+ * Generate a valid TypeScript identifier from domain and method
+ * e.g., "DashboardDomain" + "getSchema" -> "DashboardDomain_getSchema"
+ */
+function getOperationTypeName(operation) {
+    const domain = operation['x-micro-contracts-domain'];
+    const method = operation['x-micro-contracts-method'];
+    if (domain && method) {
+        // Use x-micro-contracts-domain + _ + x-micro-contracts-method for type name
+        return `${domain}_${method}`;
+    }
+    // Fallback: sanitize operationId (replace dots with underscores, etc.)
+    if (operation.operationId) {
+        return operation.operationId.replace(/[^a-zA-Z0-9]/g, '_');
+    }
+    return 'Unknown';
+}
+/**
+ * Generate parameter types for operations
+ */
+function generateOperationTypes(spec) {
+    const lines = [];
+    const generatedTypes = new Set();
+    for (const [path, pathItem] of Object.entries(spec.paths)) {
+        for (const method of ['get', 'post', 'put', 'patch', 'delete']) {
+            const operation = pathItem[method];
+            if (!operation)
+                continue;
+            const baseTypeName = getOperationTypeName(operation);
+            // Collect all parameters (path + query) into a single Params type
+            const allParams = (operation.parameters || []).filter((p) => !isReference(p) && (p.in === 'query' || p.in === 'path'));
+            let paramsTypeName;
+            if (allParams.length > 0) {
+                paramsTypeName = `${baseTypeName}Params`;
+                if (!generatedTypes.has(paramsTypeName)) {
+                    generatedTypes.add(paramsTypeName);
+                    lines.push(generateParamsType(paramsTypeName, allParams, spec));
+                    lines.push('');
+                }
+            }
+            // Get request body type name
+            let bodyTypeName;
+            if (operation.requestBody) {
+                if (isReference(operation.requestBody)) {
+                    // Referenced request body - extract name
+                    bodyTypeName = getRefName(operation.requestBody.$ref);
+                }
+                else {
+                    const content = operation.requestBody.content?.['application/json'];
+                    if (content?.schema) {
+                        if (isReference(content.schema)) {
+                            bodyTypeName = getRefName(content.schema.$ref);
+                        }
+                        else if (content.schema.properties || content.schema.type === 'object') {
+                            // Generate inline body type
+                            bodyTypeName = `${baseTypeName}Body`;
+                            if (!generatedTypes.has(bodyTypeName)) {
+                                generatedTypes.add(bodyTypeName);
+                                lines.push(generateRequestBodyType(bodyTypeName, content.schema, spec));
+                                lines.push('');
+                            }
+                        }
+                    }
+                }
+            }
+            // Generate Input type that combines params and body
+            // - params are flattened (path + query combined)
+            // - body becomes 'data' (not HTTP-specific)
+            // - Always generate (empty object for parameterless operations)
+            const inputTypeName = `${baseTypeName}Input`;
+            if (!generatedTypes.has(inputTypeName)) {
+                generatedTypes.add(inputTypeName);
+                lines.push(generateInputType(inputTypeName, paramsTypeName, bodyTypeName));
+                lines.push('');
+            }
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Generate Input type that combines params and body
+ * - params (path + query) are flattened (HTTP details hidden)
+ * - body is renamed to 'data' (not HTTP-specific naming)
+ * - parameterless operations get empty object type
+ *
+ * Examples:
+ *   - No params: type Input = Record<string, never>;  (empty object)
+ *   - Params only: type Input = Params;
+ *   - Body only: type Input = { data: Body };
+ *   - Params + Body: type Input = Params & { data: Body };
+ */
+function generateInputType(name, paramsType, bodyType) {
+    const parts = [];
+    // Flatten params (path + query parameters become direct properties)
+    if (paramsType) {
+        parts.push(paramsType);
+    }
+    // Body becomes 'data' property (not HTTP-specific naming)
+    if (bodyType) {
+        parts.push(`{ data: ${bodyType} }`);
+    }
+    // Generate type alias
+    if (parts.length === 0) {
+        // Parameterless operation: empty object type
+        return `export type ${name} = Record<string, never>;`;
+    }
+    else if (parts.length === 1) {
+        return `export type ${name} = ${parts[0]};`;
+    }
+    else {
+        return `export type ${name} = ${parts.join(' & ')};`;
+    }
+}
+/**
+ * Generate request body interface
+ */
+function generateRequestBodyType(name, schema, spec) {
+    const lines = [];
+    lines.push(`export interface ${name} {`);
+    if (schema.properties) {
+        const required = new Set(schema.required || []);
+        for (const [propName, propSchema] of Object.entries(schema.properties)) {
+            const isRequired = required.has(propName);
+            const optional = isRequired ? '' : '?';
+            const tsType = schemaToTypeString(propSchema, spec);
+            if (isReference(propSchema)) {
+                // No description for refs
+            }
+            else if (propSchema.description) {
+                lines.push(`  /** ${propSchema.description} */`);
+            }
+            lines.push(`  ${propName}${optional}: ${tsType};`);
+        }
+    }
+    lines.push('}');
+    return lines.join('\n');
+}
+/**
+ * Generate params interface (combines path + query parameters)
+ */
+function generateParamsType(name, params, spec) {
+    const lines = [];
+    lines.push(`export interface ${name} {`);
+    for (const param of params) {
+        const optional = param.required ? '' : '?';
+        let tsType = 'unknown';
+        if (param.schema) {
+            tsType = schemaToTypeString(param.schema, spec);
+        }
+        if (param.description) {
+            lines.push(`  /** ${param.description} */`);
+        }
+        // Use OpenAPI parameter name as-is (quoted for names with special chars)
+        lines.push(`  '${param.name}'${optional}: ${tsType};`);
+    }
+    lines.push('}');
+    return lines.join('\n');
+}
+function capitalize(str) {
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+//# sourceMappingURL=typeGenerator.js.map

package/dist/generator/typeGenerator.js.map

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

package/dist/guardrails/allowlist.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Allowlist verification for guardrails
+ *
+ * Verifies that changed files are within allowed boundaries.
+ */
+import type { GuardrailsConfig, AllowlistResult, CheckResult, CheckOptions } from './types.js';
+/**
+ * Simple glob pattern matching with negation support
+ * Patterns are evaluated top-to-bottom; last match wins.
+ * - "!pattern" → if matched, result becomes false (exclude)
+ * - "pattern"  → if matched, result becomes true (include)
+ */
+export declare function matchWithNegation(patterns: string[] | undefined, file: string): boolean;
+/**
+ * Simple glob pattern matching
+ * Supports:
+ * - * matches any characters except /
+ * - ** matches any characters including / (zero or more path segments)
+ * - ? matches single character
+ */
+export declare function matchGlob(file: string, pattern: string): boolean;
+/**
+ * Get list of changed files, filtered to a specific base directory
+ */
+export declare function getChangedFiles(options: {
+    /** Path to file containing list of changed files */
+    changedFilesPath?: string;
+    /** Base ref for git diff (default: HEAD) */
+    baseRef?: string;
+    /** Base directory to filter files (only files under this dir are returned) */
+    baseDir?: string;
+}): string[];
+/**
+ * Verify changed files against allowlist
+ */
+export declare function verifyAllowlist(changedFiles: string[], config: GuardrailsConfig): AllowlistResult;
+/**
+ * Run allowlist check
+ */
+export declare function runAllowlistCheck(options: CheckOptions): Promise<CheckResult>;
+/**
+ * Format allowlist result for CLI output
+ */
+export declare function formatAllowlistResult(result: AllowlistResult): string;
+//# sourceMappingURL=allowlist.d.ts.map

package/dist/guardrails/allowlist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"allowlist.d.ts","sourceRoot":"","sources":["../../src/guardrails/allowlist.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAsB,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAGnH;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAgBvF;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAMhE;AA8DD;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE;IACvC,oDAAoD;IACpD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,MAAM,EAAE,CA2DX;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,MAAM,EAAE,EACtB,MAAM,EAAE,gBAAgB,GACvB,eAAe,CA2BjB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAyDnF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAiBrE"}