@company-semantics/contracts 0.47.2 → 0.48.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "0.47.2",
+  "version": "0.48.0",
   "private": false,
   "repository": {
     "type": "git",
@@ -67,6 +67,8 @@
     "guard:version-tag:json": "npx tsx scripts/ci/version-tag-guard.ts --json",
     "guard:decisions-deprecation": "npx tsx scripts/ci/decisions-deprecation-guard.ts",
     "guard:decisions-deprecation:json": "npx tsx scripts/ci/decisions-deprecation-guard.ts --json",
+    "guard:quick": "pnpm guard:export && pnpm guard:vocabulary && pnpm guard:scripts-deps",
+    "guard": "pnpm guard:export && pnpm guard:vocabulary && pnpm guard:scripts-deps && pnpm guard:decision && pnpm guard:decisions-deprecation",
     "guard:test": "vitest run scripts/ci/__tests__",
     "release": "npx tsx scripts/release.ts",
     "prepublishOnly": "echo 'ERROR: Publishing is CI-only via tag push. Use pnpm release instead.' && exit 1",

package/src/index.ts

@@ -346,3 +346,8 @@ export type {
 
 // Ralph constants (cross-repo support)
 export { REPO_PRECEDENCE } from './ralph/index'
+
+// Rate limit domain types
+// @see PRD-00013 for contracts integration
+export type { RateLimitConfig, RateLimitResult } from './rate-limit/index'
+export { RateLimitTier } from './rate-limit/index'

package/src/rate-limit/README.md

@@ -0,0 +1,51 @@
+# Rate Limit Domain
+
+Shared vocabulary types for rate limiting across Company Semantics codebases.
+
+## Types
+
+### RateLimitTier
+
+Enum defining the rate limit tiers available to users:
+
+- `FREE` - Default tier for free users
+- `PRO` - Elevated limits for pro subscribers
+- `ENTERPRISE` - Custom limits for enterprise customers
+
+### RateLimitConfig
+
+Configuration for rate limit windows:
+
+```typescript
+interface RateLimitConfig {
+  maxRequests: number;  // Maximum requests allowed in window
+  windowMs: number;     // Window duration in milliseconds
+}
+```
+
+### RateLimitResult
+
+Result of a rate limit check:
+
+```typescript
+interface RateLimitResult {
+  allowed: boolean;  // true = permitted, false = rate limited
+  remaining: number; // Requests remaining in current window
+  resetAt: number;   // Unix timestamp when window resets
+}
+```
+
+## Semantic Convention
+
+This domain uses `allowed: boolean` where `true` means the request is permitted.
+This is the canonical semantic across all Company Semantics repos.
+
+## Consumers
+
+- `company-semantics-edge` - Rate limiter implementation
+- `company-semantics-backend` - Rate limit service
+
+## See Also
+
+- PRD-00012: Foundational rate limiting implementation
+- PRD-00013: Contracts integration (this promotion)

package/src/rate-limit/index.ts

@@ -0,0 +1,23 @@
+/**
+ * Rate limiting vocabulary types.
+ * @see PRD-00012 for foundational implementation
+ * @see PRD-00013 for contracts integration
+ */
+
+export enum RateLimitTier {
+  FREE = 'free',
+  PRO = 'pro',
+  ENTERPRISE = 'enterprise',
+}
+
+export interface RateLimitConfig {
+  maxRequests: number;
+  windowMs: number;
+}
+
+export interface RateLimitResult {
+  /** Whether the request is allowed (true = permitted, false = rate limited) */
+  allowed: boolean;
+  remaining: number;
+  resetAt: number;
+}