@company-semantics/contracts 0.32.0 → 0.34.0

package/package.json

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

package/src/auth/index.ts

@@ -0,0 +1,18 @@
+/**
+ * Auth domain contracts
+ *
+ * Shared types for authentication flows across Company Semantics codebases.
+ */
+
+/**
+ * OTP verification error codes.
+ *
+ * Returned by the backend in the `errorCode` field of OTP verification errors.
+ * Frontend uses these to provide specific user messaging (e.g., expired vs invalid).
+ */
+export enum OTPErrorCode {
+  InvalidCode = 'invalid_code',
+  Expired = 'expired',
+  AlreadyUsed = 'already_used',
+  NotFound = 'not_found',
+}

package/src/index.ts

@@ -109,6 +109,19 @@ export type { Compatibility, Deprecation } from './compatibility'
 export type { ISODateString, UserIdentity } from './identity/index'
 export { deriveFullName, resolveDisplayName } from './identity/index'
 
+// Auth domain types
+export { OTPErrorCode } from './auth/index'
+
+// Organization domain types
+// @see ADR-BE-XXX for design rationale (Personal vs Shared Organization Model)
+export type {
+  OrgType,
+  ExecutionScope,
+  OrganizationInfo,
+  OwnershipTransferRequest,
+  OwnershipTransferStatus,
+} from './org/index'
+
 // MCP tool discovery types
 // @see company-semantics-backend/src/interfaces/mcp/ for implementation
 export type {

package/src/org/README.md

@@ -0,0 +1,25 @@
+# org/
+
+Organization domain vocabulary types for the personal → shared organization model.
+
+## Purpose
+
+Shared type vocabulary for organization ownership, type classification, and transfer workflows.
+
+## Invariants
+
+- `OrgType` and `ExecutionScope` are exhaustive union types (no 'unknown' or catch-all)
+- All types are vocabulary-only (no runtime behavior, no business logic)
+- Structural details (like `ownerUserId`) remain in backend; only public-facing fields here
+
+## Public API
+
+- `OrgType` - 'personal' | 'shared' organization classification
+- `ExecutionScope` - 'self' | 'org' execution identity scope
+- `OrganizationInfo` - Public organization details for API responses
+- `OwnershipTransferRequest` - Transfer initiation payload
+- `OwnershipTransferStatus` - Pending transfer status
+
+## Dependencies
+
+None. This is a leaf vocabulary module.

package/src/org/index.ts

@@ -0,0 +1,14 @@
+/**
+ * Organization Types Barrel
+ *
+ * Re-exports organization vocabulary types.
+ * Import from '@company-semantics/contracts' (root).
+ */
+
+export type {
+  OrgType,
+  ExecutionScope,
+  OrganizationInfo,
+  OwnershipTransferRequest,
+  OwnershipTransferStatus,
+} from './types';

package/src/org/types.ts

@@ -0,0 +1,49 @@
+/**
+ * Organization Types
+ *
+ * Vocabulary types for the personal → shared organization model.
+ * @see ADR-BE-XXX (Personal vs Shared Organization Model)
+ */
+
+/**
+ * Organization type distinguishes personal workspaces from shared organizations.
+ * - 'personal': Single-user workspace, owned by creator, claimable
+ * - 'shared': Multi-user organization, owned by one user, not claimable
+ */
+export type OrgType = 'personal' | 'shared';
+
+/**
+ * Execution scope determines whose identity is used when executing actions.
+ * - 'self': Actions execute under the connecting user's identity only
+ * - 'org': Actions execute on behalf of the organization (shared access)
+ */
+export type ExecutionScope = 'self' | 'org';
+
+/**
+ * Public organization information suitable for API responses.
+ * Does not include sensitive fields like ownerUserId.
+ */
+export interface OrganizationInfo {
+  id: string;
+  name: string;
+  slug: string;
+  type: OrgType;
+  claimable: boolean;
+}
+
+/**
+ * Request payload for initiating ownership transfer.
+ */
+export interface OwnershipTransferRequest {
+  newOwnerEmail: string;
+}
+
+/**
+ * Status of pending ownership transfer for an organization.
+ */
+export interface OwnershipTransferStatus {
+  pending: boolean;
+  newOwnerEmail?: string;
+  requestedAt?: string;
+  expiresAt?: string;
+}