@company-semantics/contracts 0.102.1 → 0.103.1

package/src/api/index.ts

@@ -0,0 +1,9 @@
+/**
+ * API Types Barrel
+ *
+ * Re-exports OpenAPI-generated types from the backend spec.
+ * Import from '@company-semantics/contracts' (root).
+ */
+
+// OpenAPI generated types (from openapi/backend.yaml)
+export type { paths, components, operations } from './generated'

package/src/generated/openapi-routes.ts

@@ -0,0 +1,92 @@
+// AUTO-GENERATED — do not edit manually
+// Generated from openapi/backend.yaml by scripts/generate-openapi-routes.ts
+
+export const openApiRoutes = {
+  '/ai/chat': ['POST'],
+  '/api/account/cancel-deletion': ['POST'],
+  '/api/account/delete': ['POST'],
+  '/api/account/sessions': ['GET'],
+  '/api/account/sessions/{sessionId}': ['DELETE'],
+  '/api/capabilities/tools': ['GET'],
+  '/api/chats': ['GET', 'POST'],
+  '/api/chats/events': ['GET'],
+  '/api/chats/{chatId}/shares': ['GET', 'POST'],
+  '/api/chats/{id}': ['DELETE', 'GET', 'PATCH'],
+  '/api/chats/{id}/generate-title': ['POST'],
+  '/api/chats/{id}/messages': ['POST'],
+  '/api/chats/{id}/pin': ['DELETE', 'POST'],
+  '/api/departments': ['GET', 'POST'],
+  '/api/departments/{id}': ['DELETE', 'GET', 'PATCH'],
+  '/api/departments/{id}/members': ['POST'],
+  '/api/departments/{id}/members/{userId}': ['DELETE'],
+  '/api/drive/files': ['GET'],
+  '/api/drive/files/recent': ['GET'],
+  '/api/drive/files/{fileId}/content': ['GET'],
+  '/api/executions': ['GET', 'POST'],
+  '/api/executions/{executionId}/explanation': ['GET'],
+  '/api/executions/{executionId}/summary': ['GET'],
+  '/api/executions/{executionId}/timeline': ['GET'],
+  '/api/goals/docs/{slug}': ['GET'],
+  '/api/goals/docs/{slug}/content': ['PUT'],
+  '/api/goals/docs/{slug}/sharing': ['GET'],
+  '/api/goals/docs/{slug}/sharing/acl': ['POST'],
+  '/api/goals/docs/{slug}/sharing/acl/{aclId}': ['DELETE', 'PUT'],
+  '/api/goals/docs/{slug}/sharing/policy': ['PUT'],
+  '/api/goals/docs/{slug}/title': ['PUT'],
+  '/api/goals/extract': ['POST'],
+  '/api/goals/tree': ['GET'],
+  '/api/integrations/status': ['GET'],
+  '/api/me': ['GET'],
+  '/api/org/cancel-deletion': ['POST'],
+  '/api/org/delete': ['POST'],
+  '/api/org/deletion-eligibility': ['GET'],
+  '/api/org/transfer-eligibility': ['GET'],
+  '/api/org/transfer-ownership': ['DELETE', 'POST'],
+  '/api/org/transfer-ownership/accept': ['POST'],
+  '/api/org/transfer-ownership/preview': ['POST'],
+  '/api/org/transfer-ownership/status': ['GET'],
+  '/api/orgs/{orgId}/ai-usage': ['GET'],
+  '/api/orgs/{orgId}/billing': ['GET'],
+  '/api/orgs/{orgId}/budget-config': ['GET', 'PUT'],
+  '/api/shared/{token}': ['GET'],
+  '/api/shares/{shareId}': ['DELETE', 'PATCH'],
+  '/api/teams': ['GET', 'POST'],
+  '/api/teams/{teamId}': ['DELETE', 'GET', 'PUT'],
+  '/api/teams/{teamId}/members': ['POST'],
+  '/api/teams/{teamId}/members/{userId}': ['DELETE'],
+  '/api/teams/{teamId}/members/{userId}/role': ['PUT'],
+  '/api/timeline': ['GET'],
+  '/api/user/active-org': ['POST'],
+  '/api/user/orgs': ['GET'],
+  '/api/user/orgs/{orgId}/leave': ['POST'],
+  '/api/user/profile': ['PATCH'],
+  '/api/workspace': ['GET'],
+  '/api/workspace/access': ['GET'],
+  '/api/workspace/audit': ['GET'],
+  '/api/workspace/auth': ['GET'],
+  '/api/workspace/auth-policy': ['PATCH'],
+  '/api/workspace/auth-policy/test-sso': ['POST'],
+  '/api/workspace/auth-policy/test-sso/{attemptId}': ['GET'],
+  '/api/workspace/auth-policy/validate-oidc': ['POST'],
+  '/api/workspace/domains': ['GET', 'POST'],
+  '/api/workspace/domains/{id}': ['DELETE'],
+  '/api/workspace/domains/{id}/verify': ['POST'],
+  '/api/workspace/invites': ['GET', 'POST'],
+  '/api/workspace/invites/accept': ['POST'],
+  '/api/workspace/invites/{id}': ['DELETE'],
+  '/api/workspace/members': ['GET'],
+  '/api/workspace/members/{id}': ['DELETE'],
+  '/api/workspace/members/{id}/role': ['PATCH'],
+  '/auth/logout': ['POST'],
+  '/auth/me': ['GET'],
+  '/auth/sso/callback': ['GET', 'POST'],
+  '/auth/sso/{orgSlug}': ['GET'],
+  '/auth/start': ['POST'],
+  '/auth/verify': ['POST'],
+  '/connect/{provider}': ['GET'],
+  '/healthz': ['GET'],
+  '/oauth/{provider}/callback': ['GET'],
+} as const;
+
+export type OpenApiRoute = keyof typeof openApiRoutes;
+export type OpenApiMethod = (typeof openApiRoutes)[OpenApiRoute][number];

package/src/index.ts

@@ -539,3 +539,10 @@ export { resolveScope, toQueryKey, fromQueryKey, resourceRelationships, matchesR
 
 // Resource response wrapper (typed versioning for cache invalidation)
 export type { ResourceResponse } from './resource-response'
+
+// OpenAPI generated types (from openapi/backend.yaml)
+// @see src/api/README.md for codegen details
+export type { paths, components, operations } from './api/index'
+
+// OpenAPI route registry (generated from openapi/backend.yaml)
+export { openApiRoutes, type OpenApiRoute, type OpenApiMethod } from './generated/openapi-routes'

package/src/resource-keys.ts

@@ -15,7 +15,12 @@ export type ResourceKey =
   | { type: 'timeline'; orgId: string }
   // Identities (singular) — single entities
   | { type: 'member'; orgId: string; memberId: string }
+  | { type: 'team'; orgId: string; teamId: string }
+  | { type: 'department'; orgId: string; departmentId: string }
+  | { type: 'chat'; orgId: string; chatId: string }
+  | { type: 'goalDoc'; orgId: string; slug: string }
   | { type: 'workspace'; orgId: string }
+  | { type: 'workspaceDomains'; orgId: string }
   | { type: 'authSettings'; orgId: string }
   | { type: 'billing'; orgId: string }
   | { type: 'aiUsage'; orgId: string }
@@ -25,7 +30,8 @@ export type ResourceKey =
   // User-scoped
   | { type: 'dismissedBanners'; userId: string }
   | { type: 'userOrgs'; userId: string }
-  | { type: 'sessions'; userId: string };
+  | { type: 'sessions'; userId: string }
+  | { type: 'viewer'; userId: string };
 
 /**
  * Action — structured mutation key used across execution system, audit, permissions.
@@ -45,11 +51,11 @@ export function resolveScope(context: {
 /** All ResourceKey type literals for exhaustive checking. */
 const ORG_SCOPED_TYPES = [
   'members', 'departments', 'chats', 'teams', 'integrations', 'invites',
-  'auditEvents', 'timeline', 'workspace', 'authSettings', 'billing', 'aiUsage',
-  'deletionEligibility', 'transferOwnership', 'goals',
+  'auditEvents', 'timeline', 'workspace', 'workspaceDomains', 'authSettings',
+  'billing', 'aiUsage', 'deletionEligibility', 'transferOwnership', 'goals',
 ] as const;
 
-const USER_SCOPED_TYPES = ['dismissedBanners', 'userOrgs', 'sessions'] as const;
+const USER_SCOPED_TYPES = ['dismissedBanners', 'userOrgs', 'sessions', 'viewer'] as const;
 
 /**
  * Canonical ResourceKey → query key conversion.
@@ -62,14 +68,23 @@ const USER_SCOPED_TYPES = ['dismissedBanners', 'userOrgs', 'sessions'] as const;
  */
 export function toQueryKey(key: ResourceKey): readonly string[] {
   switch (key.type) {
-    // Identity with extra field
+    // Identities with extra field
     case 'member':
       return [key.type, key.orgId, key.memberId] as const;
+    case 'team':
+      return [key.type, key.orgId, key.teamId] as const;
+    case 'department':
+      return [key.type, key.orgId, key.departmentId] as const;
+    case 'chat':
+      return [key.type, key.orgId, key.chatId] as const;
+    case 'goalDoc':
+      return [key.type, key.orgId, key.slug] as const;
 
     // User-scoped
     case 'dismissedBanners':
     case 'userOrgs':
     case 'sessions':
+    case 'viewer':
       return [key.type, key.userId] as const;
 
     // Org-scoped collections and identities
@@ -82,6 +97,7 @@ export function toQueryKey(key: ResourceKey): readonly string[] {
     case 'auditEvents':
     case 'timeline':
     case 'workspace':
+    case 'workspaceDomains':
     case 'authSettings':
     case 'billing':
     case 'aiUsage':
@@ -108,12 +124,20 @@ export function fromQueryKey(queryKey: readonly string[]): ResourceKey {
     throw new Error(`Invalid query key: expected at least [type, scope], got ${JSON.stringify(queryKey)}`);
   }
 
-  // Identity with extra field
-  if (type === 'member') {
+  // Identities with extra field
+  const identityFields: Record<string, string> = {
+    member: 'memberId',
+    team: 'teamId',
+    department: 'departmentId',
+    chat: 'chatId',
+    goalDoc: 'slug',
+  };
+
+  if (type in identityFields) {
     if (rest.length !== 2) {
-      throw new Error(`Invalid query key for 'member': expected [type, orgId, memberId], got ${JSON.stringify(queryKey)}`);
+      throw new Error(`Invalid query key for '${type}': expected [type, orgId, ${identityFields[type]}], got ${JSON.stringify(queryKey)}`);
     }
-    return { type: 'member', orgId: rest[0], memberId: rest[1] };
+    return { type, orgId: rest[0], [identityFields[type]]: rest[1] } as ResourceKey;
   }
 
   // User-scoped types
@@ -143,6 +167,8 @@ export const resourceRelationships: Record<string, string[]> = {
   chat: ['chats'],
   teams: ['team'],
   team: ['teams'],
+  goals: ['goalDoc'],
+  goalDoc: ['goals'],
 };
 
 /**
@@ -167,6 +193,10 @@ export function matchesResourceKey(queryKey: readonly unknown[], targetKey: Reso
   if ('orgId' in parsed && 'orgId' in targetKey && parsed.orgId !== targetKey.orgId) return false;
   if ('userId' in parsed && 'userId' in targetKey && parsed.userId !== targetKey.userId) return false;
   if ('memberId' in parsed && 'memberId' in targetKey && parsed.memberId !== targetKey.memberId) return false;
+  if ('teamId' in parsed && 'teamId' in targetKey && parsed.teamId !== targetKey.teamId) return false;
+  if ('departmentId' in parsed && 'departmentId' in targetKey && parsed.departmentId !== targetKey.departmentId) return false;
+  if ('chatId' in parsed && 'chatId' in targetKey && parsed.chatId !== targetKey.chatId) return false;
+  if ('slug' in parsed && 'slug' in targetKey && parsed.slug !== targetKey.slug) return false;
 
   return true;
 }