@company-semantics/contracts 0.55.0 → 0.57.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "0.55.0",
+  "version": "0.57.0",
   "private": false,
   "repository": {
     "type": "git",

package/src/billing/index.ts

@@ -0,0 +1 @@
+export type { OrgPlanStatus, OrgBillingInfo } from './types';

package/src/billing/types.ts

@@ -0,0 +1,32 @@
+/**
+ * Organization Billing Types (v1)
+ *
+ * Read-only billing DTO types for the org billing surface.
+ * v1 constraint: billingOwnerUserId MUST equal org.ownerUserId.
+ *
+ * @see PRD-00121 for design rationale
+ */
+
+/**
+ * Organization plan status.
+ */
+export type OrgPlanStatus = 'active' | 'trialing' | 'past_due' | 'canceled';
+
+/**
+ * Read-only billing information for an organization.
+ *
+ * @invariant billingOwnerUserId === org.ownerUserId in v1 (no separate billing owner)
+ * @invariant This DTO is read-only — no mutations in v1
+ */
+export interface OrgBillingInfo {
+  planName: string;
+  planStatus: OrgPlanStatus;
+  billingCadence: string;
+  seatCount: number;
+  seatLimit: number;
+  /**
+   * Must equal org.ownerUserId in v1.
+   * No separate billing owner concept yet.
+   */
+  billingOwnerUserId: string;
+}

package/src/index.ts

@@ -362,3 +362,7 @@ export type {
 // @see PRD-00013 for contracts integration
 export type { RateLimitConfig, RateLimitResult } from './rate-limit/index'
 export { RateLimitTier } from './rate-limit/index'
+
+// Billing domain types (v1 — read-only)
+// @see PRD-00121 for design rationale
+export type { OrgPlanStatus, OrgBillingInfo } from './billing/index'

package/src/org/types.ts

@@ -57,7 +57,7 @@ export interface OwnershipTransferStatus {
  * Display role for workspace members.
  * Presentation-layer simplification of the internal RBAC roles.
  */
-export type WorkspaceRole = 'owner' | 'admin' | 'member';
+export type WorkspaceRole = 'owner' | 'admin' | 'member' | 'auditor';
 
 /**
  * RBAC → UI role mapping (presentation only).
@@ -66,6 +66,7 @@ export type WorkspaceRole = 'owner' | 'admin' | 'member';
 export const ROLE_DISPLAY_MAP = {
   org_owner: 'owner',
   org_admin: 'admin',
+  org_auditor: 'auditor',
   // All other roles → 'member'
 } as const satisfies Partial<Record<string, WorkspaceRole>>;
 
@@ -77,6 +78,8 @@ export interface WorkspaceOverview {
   id: string;
   name: string;
   type: OrgType;
+  /** Square logo URL for the workspace. Null if no logo has been set. */
+  logoUrl: string | null;
   owner: {
     id: string;
     name: string;