@ironbackend/core 1.0.0

package/dist/styles/specialized.js

@@ -0,0 +1,379 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.automation = exports.readHeavy = exports.serverless = void 0;
+/**
+ * Serverless Backend Architecture
+ * Stateless functions triggered by events, managed infrastructure
+ */
+exports.serverless = {
+    id: 'serverless',
+    name: 'Serverless Backend',
+    description: 'Backend composed of stateless functions triggered by events. Infrastructure managed by cloud provider. Pay-per-use with automatic scaling.',
+    whenToUse: [
+        'Variable/unpredictable traffic patterns',
+        'Event-driven workloads (webhooks, file processing)',
+        'Minimal operational overhead desired',
+        'Pay-per-use cost model preferred',
+        'Rapid development with managed infrastructure',
+        'Prototype or MVP development'
+    ],
+    whenNotToUse: [
+        'Long-running processes (> 15 min)',
+        'Low latency critical (cold start issues)',
+        'High-frequency invocations (cost prohibitive)',
+        'Complex stateful workflows',
+        'Need full control over infrastructure',
+        'Vendor lock-in unacceptable'
+    ],
+    corePrinciples: [
+        'Functions are stateless',
+        'State stored in external managed services',
+        'Each function does one thing well',
+        'Cold start mitigation strategies required',
+        'Design for idempotency',
+        'Optimize for invocation cost and duration'
+    ],
+    folderStructure: {
+        name: 'src',
+        type: 'folder',
+        children: [
+            {
+                name: 'functions',
+                type: 'folder',
+                children: [
+                    {
+                        name: 'http',
+                        type: 'folder',
+                        description: 'API Gateway triggers',
+                        children: [
+                            {
+                                name: 'create-order',
+                                type: 'folder',
+                                children: [
+                                    { name: 'handler.ts', type: 'file', description: 'Function entry point' },
+                                    { name: 'schema.ts', type: 'file', description: 'Input validation' },
+                                    { name: 'index.ts', type: 'file', description: 'Export' }
+                                ]
+                            },
+                            { name: 'get-orders', type: 'folder' }
+                        ]
+                    },
+                    {
+                        name: 'events',
+                        type: 'folder',
+                        description: 'Event triggers (S3, SQS, SNS)',
+                        children: [
+                            { name: 'process-upload', type: 'folder' },
+                            { name: 'handle-payment', type: 'folder' }
+                        ]
+                    },
+                    {
+                        name: 'scheduled',
+                        type: 'folder',
+                        description: 'Cron triggers',
+                        children: [
+                            { name: 'daily-report', type: 'folder' },
+                            { name: 'cleanup-job', type: 'folder' }
+                        ]
+                    }
+                ]
+            },
+            {
+                name: 'shared',
+                type: 'folder',
+                description: 'Shared code across functions',
+                children: [
+                    { name: 'domain', type: 'folder', description: 'Business logic' },
+                    { name: 'utils', type: 'folder', description: 'Utilities' },
+                    { name: 'clients', type: 'folder', description: 'External service clients' }
+                ]
+            },
+            {
+                name: 'infrastructure',
+                type: 'folder',
+                description: 'IaC definitions',
+                children: [
+                    { name: 'cdk', type: 'folder', description: 'AWS CDK or' },
+                    { name: 'terraform', type: 'folder', description: 'Terraform configs' }
+                ]
+            }
+        ]
+    },
+    commonPitfalls: [
+        'Functions too large (should be < 500 lines)',
+        'Ignoring cold start latency',
+        'No local development/testing setup',
+        'Synchronous chains of functions',
+        'Over-reliance on managed services',
+        'Missing structured logging',
+        'Not monitoring costs per function'
+    ],
+    aiInstructions: `When generating code for Serverless Backend:
+
+FUNCTION DESIGN:
+- Functions must be stateless and idempotent
+- Keep function code under 500 lines
+- Separate business logic from handler boilerplate
+- One function = one responsibility
+
+CONFIGURATION:
+- Use environment variables for configuration
+- Secrets in secrets manager, not env vars
+- Configure appropriate memory/timeout
+
+COLD START:
+- Keep dependencies minimal
+- Use lazy initialization for heavy resources
+- Consider provisioned concurrency for latency-sensitive functions
+
+OBSERVABILITY:
+- Implement structured logging from start
+- Include request ID in all logs
+- Use distributed tracing (X-Ray, etc.)
+
+TESTING:
+- Unit test business logic independently
+- Integration test with local emulators (LocalStack, etc.)
+- Test handler wrapper separately`
+};
+/**
+ * Read-Heavy API Architecture
+ * Optimized for high read-to-write ratio
+ */
+exports.readHeavy = {
+    id: 'read-heavy',
+    name: 'Read-Heavy API',
+    description: 'Backend optimized for high read-to-write ratio. Aggressive caching, denormalized storage, eventual consistency for reads.',
+    whenToUse: [
+        'Read:Write ratio > 10:1',
+        'Data changes infrequently',
+        'Latency for reads critical',
+        'Can tolerate stale reads',
+        'Content delivery / catalog systems',
+        'Public-facing high-traffic APIs'
+    ],
+    whenNotToUse: [
+        'Data changes frequently',
+        'Strong consistency required for reads',
+        'Write-heavy workload',
+        'Cache invalidation complexity unacceptable',
+        'Data freshness critical (financial, real-time)'
+    ],
+    corePrinciples: [
+        'Cache everything cacheable',
+        'Denormalize data for read performance',
+        'Accept eventual consistency',
+        'Invalidate caches explicitly on writes',
+        'Multiple cache layers (CDN, app, DB)',
+        'Optimize for cache hits'
+    ],
+    folderStructure: {
+        name: 'src',
+        type: 'folder',
+        children: [
+            {
+                name: 'api',
+                type: 'folder',
+                children: [
+                    { name: 'queries', type: 'folder', description: 'Read endpoints' },
+                    { name: 'commands', type: 'folder', description: 'Write endpoints' }
+                ]
+            },
+            {
+                name: 'cache',
+                type: 'folder',
+                children: [
+                    { name: 'strategies', type: 'folder', description: 'Cache patterns' },
+                    { name: 'invalidation', type: 'folder', description: 'Cache invalidation logic' },
+                    { name: 'warming', type: 'folder', description: 'Pre-populate caches' }
+                ]
+            },
+            {
+                name: 'read-models',
+                type: 'folder',
+                description: 'Denormalized views optimized for queries'
+            },
+            {
+                name: 'projectors',
+                type: 'folder',
+                description: 'Update read models on writes'
+            },
+            { name: 'domain', type: 'folder' },
+            {
+                name: 'infrastructure',
+                type: 'folder',
+                children: [
+                    { name: 'cache', type: 'folder', description: 'Redis, Memcached' },
+                    { name: 'database', type: 'folder' }
+                ]
+            }
+        ]
+    },
+    commonPitfalls: [
+        'Cache stampede on invalidation - use locking or probabilistic expiry',
+        'Stale cache with no TTL - always set TTL',
+        'Missing cache warming strategy - cold cache = slow startup',
+        'Over-caching (wasted memory) - cache what matters',
+        'No cache hit rate monitoring - flying blind',
+        'Complex invalidation logic - simpler is better'
+    ],
+    aiInstructions: `When generating code for Read-Heavy API:
+
+CACHING:
+- Every query endpoint checks cache first
+- Cache TTL required for all cached data
+- Use cache-aside pattern as default
+- Implement multi-layer caching where appropriate
+
+INVALIDATION:
+- Write operations invalidate affected caches
+- Use cache tags for grouped invalidation
+- Consider event-driven invalidation
+- Handle cache stampede protection
+
+READ MODELS:
+- Denormalize for query patterns
+- Accept data duplication for performance
+- Update read models on writes (sync or async)
+
+MONITORING:
+- Log cache hit/miss rates
+- Alert on low hit rates
+- Monitor cache memory usage
+
+PATTERNS:
+- Cache-aside: app manages cache
+- Read-through: cache fetches on miss
+- Write-through: writes go to cache first`
+};
+/**
+ * Automation / Bot Backend Architecture
+ * Scheduled jobs, workflows, integrations
+ */
+exports.automation = {
+    id: 'automation',
+    name: 'Automation / Bot Backend',
+    description: 'Backend for scheduled jobs, workflows, integrations, and automated processes. Emphasizes reliability, retries, and observability.',
+    whenToUse: [
+        'Scheduled batch processing',
+        'Third-party integrations',
+        'Workflow orchestration',
+        'Background job processing',
+        'Data pipelines',
+        'Automated notifications / alerts'
+    ],
+    whenNotToUse: [
+        'Real-time user interactions',
+        'Low latency requirements',
+        'Simple CRUD operations',
+        'User-facing API as primary purpose'
+    ],
+    corePrinciples: [
+        'All jobs must be idempotent',
+        'Explicit retry policies with backoff',
+        'Comprehensive logging and tracing',
+        'Failure isolation between jobs',
+        'Clear timeout for every operation',
+        'Compensating transactions for failures'
+    ],
+    folderStructure: {
+        name: 'src',
+        type: 'folder',
+        children: [
+            {
+                name: 'jobs',
+                type: 'folder',
+                children: [
+                    {
+                        name: 'scheduled',
+                        type: 'folder',
+                        description: 'Cron jobs',
+                        children: [
+                            { name: 'daily-report', type: 'folder' },
+                            { name: 'cleanup', type: 'folder' },
+                            { name: 'sync-external', type: 'folder' }
+                        ]
+                    },
+                    {
+                        name: 'triggered',
+                        type: 'folder',
+                        description: 'Event-triggered jobs'
+                    },
+                    {
+                        name: 'workflows',
+                        type: 'folder',
+                        description: 'Multi-step processes'
+                    }
+                ]
+            },
+            {
+                name: 'integrations',
+                type: 'folder',
+                description: 'External API clients',
+                children: [
+                    { name: 'slack', type: 'folder' },
+                    { name: 'stripe', type: 'folder' },
+                    { name: 'sendgrid', type: 'folder' },
+                    { name: 'salesforce', type: 'folder' }
+                ]
+            },
+            {
+                name: 'shared',
+                type: 'folder',
+                children: [
+                    { name: 'retry', type: 'folder', description: 'Retry utilities' },
+                    { name: 'logging', type: 'folder', description: 'Structured logging' },
+                    { name: 'monitoring', type: 'folder', description: 'Metrics, alerts' }
+                ]
+            },
+            {
+                name: 'infrastructure',
+                type: 'folder',
+                children: [
+                    { name: 'scheduler', type: 'folder', description: 'Job scheduling' },
+                    { name: 'queue', type: 'folder', description: 'Job queues' }
+                ]
+            }
+        ]
+    },
+    commonPitfalls: [
+        'Non-idempotent jobs - re-runs cause duplicates',
+        'Missing retry logic - transient failures break everything',
+        'No dead letter handling - failed jobs disappear',
+        'Insufficient logging - debugging is impossible',
+        'Jobs without timeout - stuck jobs consume resources',
+        'No job state tracking - cannot resume or debug',
+        'Missing alerting on failures'
+    ],
+    aiInstructions: `When generating code for Automation Backend:
+
+JOBS:
+- Every job operation MUST be idempotent
+- Set explicit timeout for every job
+- Include job ID in all log entries
+- Log: job start, progress checkpoints, completion, failure
+
+RETRY:
+- Implement exponential backoff for retries
+- Configure max retry attempts
+- Use jitter to prevent thundering herd
+- Different retry strategies for different failure types
+
+INTEGRATIONS:
+- Wrap all external API calls with retry logic
+- Implement circuit breaker for unreliable APIs
+- Cache authentication tokens appropriately
+- Handle rate limiting gracefully
+
+MONITORING:
+- Track job execution duration
+- Alert on job failures
+- Monitor success/failure rates
+- Dashboard for job status overview
+
+WORKFLOWS:
+- Break into checkpointed steps
+- Each step independently resumable
+- Handle partial failures with compensation`
+};
+//# sourceMappingURL=specialized.js.map

package/dist/styles/specialized.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,143 @@
+/**
+ * IronBackend Core Types
+ * Shared type definitions for architecture styles, stacks, rules, and security
+ */
+export interface ArchitectureStyle {
+    id: string;
+    name: string;
+    description: string;
+    whenToUse: string[];
+    whenNotToUse: string[];
+    corePrinciples: string[];
+    folderStructure: FolderNode;
+    commonPitfalls: string[];
+    aiInstructions: string;
+}
+export interface FolderNode {
+    name: string;
+    type: 'folder' | 'file';
+    description?: string;
+    children?: FolderNode[];
+}
+export interface TechStack {
+    id: string;
+    name: string;
+    language: string;
+    languageVersion: string;
+    framework: string;
+    frameworkVersion: string;
+    database: DatabaseConfig;
+    messaging: MessagingConfig;
+    authentication: string;
+    logging: string;
+    testing: TestingConfig;
+    deployment: string[];
+    conventions: string[];
+}
+export interface DatabaseConfig {
+    type: string;
+    orm: string;
+    driver?: string;
+}
+export interface MessagingConfig {
+    type: string;
+    provider: string;
+}
+export interface TestingConfig {
+    unit: string;
+    integration: string;
+    e2e?: string;
+    coverageTarget: number;
+}
+export type RuleSeverity = 'ERROR' | 'WARN';
+export type RuleCategory = 'API' | 'DOMAIN' | 'ERROR_HANDLING' | 'TRANSACTIONS' | 'DATA_ACCESS' | 'NAMING' | 'VALIDATION' | 'ASYNC';
+export interface DesignRule {
+    id: string;
+    category: RuleCategory;
+    rule: string;
+    severity: RuleSeverity;
+    rationale?: string;
+    examples?: RuleExample[];
+}
+export interface RuleExample {
+    type: 'good' | 'bad';
+    code: string;
+    explanation?: string;
+}
+export type AuthStrategy = 'JWT' | 'SESSION' | 'API_KEY' | 'OAUTH2' | 'MTLS';
+export type AuthorizationModel = 'RBAC' | 'ABAC';
+export interface AuthConfig {
+    strategy: AuthStrategy;
+    useWhen: string[];
+    implementation: string[];
+}
+export interface SecurityPlaybook {
+    authentication: AuthConfig[];
+    authorization: AuthorizationDescription;
+    rateLimiting: RateLimitConfig;
+    idempotency: IdempotencyConfig;
+    retryStrategy: RetryConfig;
+    circuitBreaker: CircuitBreakerConfig;
+    auditLogging: AuditConfig;
+    failurePhilosophy: string[];
+}
+export interface AuthorizationDescription {
+    rbac: AuthModelDescription;
+    abac: AuthModelDescription;
+    decisionMatrix: Record<string, {
+        rbac: string;
+        abac: string;
+    }>;
+}
+export interface AuthModelDescription {
+    description: string;
+    checkPattern: string;
+    goodFor: string[];
+}
+export interface RateLimitConfig {
+    windowType: string;
+    defaultLimit: string;
+    anonymousLimit: string;
+    headers: string[];
+    responseCode: number;
+}
+export interface IdempotencyConfig {
+    headerName: string;
+    keyFormat: string;
+    storageDuration: string;
+    implementation: string[];
+}
+export interface RetryConfig {
+    baseDelay: string;
+    multiplier: number;
+    maxRetries: number;
+    maxDelay: string;
+    jitter: string;
+    retryOn: number[];
+    doNotRetryOn: number[];
+}
+export interface CircuitBreakerConfig {
+    states: string[];
+    failureThreshold: number;
+    successThreshold: number;
+    timeout: string;
+    monitoringWindow: string;
+}
+export interface AuditConfig {
+    requiredEvents: string[];
+    logFormat: Record<string, string>;
+}
+export interface IronBackendConfig {
+    version: string;
+    style?: string;
+    stack?: string;
+    rules: {
+        enabled: RuleCategory[];
+        overrides: Record<string, RuleSeverity>;
+    };
+    security: {
+        authStrategy?: AuthStrategy;
+        authorizationModel?: AuthorizationModel;
+    };
+}
+//# 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":"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"}

package/dist/types.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * IronBackend Core Types
+ * Shared type definitions for architecture styles, stacks, rules, and security
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@ironbackend/core",
+  "version": "1.0.0",
+  "description": "Backend architecture styles, rules, stacks, and security playbooks",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./styles": {
+      "types": "./dist/styles/index.d.ts",
+      "import": "./dist/styles/index.js"
+    },
+    "./stacks": {
+      "types": "./dist/stacks/index.d.ts",
+      "import": "./dist/stacks/index.js"
+    },
+    "./rules": {
+      "types": "./dist/rules/index.d.ts",
+      "import": "./dist/rules/index.js"
+    },
+    "./security": {
+      "types": "./dist/security/index.d.ts",
+      "import": "./dist/security/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "backend",
+    "architecture",
+    "ai",
+    "coding-assistant",
+    "patterns",
+    "design-rules"
+  ],
+  "author": "IronBackend Contributors",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ironbackend/ironbackend.git",
+    "directory": "packages/core"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "clean": "rm -rf dist"
+  }
+}