@company-semantics/contracts 1.8.0 → 1.9.0

package/package.json

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

package/src/org/index.ts

@@ -204,7 +204,9 @@ export type {
   OrgUnitMembershipStatus,
   OrgUnitMembershipSource,
   OrgUnitErrorCode,
+  OrgTreeResponse,
 } from './org-units';
+export { ORG_UNITS_ROUTES } from './org-units';
 export {
   OrgUnitClassificationSchema,
   OrgUnitSyncModeSchema,

package/src/org/org-units.ts

@@ -45,6 +45,48 @@ export type OrgUnitMembershipStatus = 'active' | 'pending' | 'removed';
 /** External directory origin of a membership row. */
 export type OrgUnitMembershipSource = 'manual' | 'google_groups' | 'scim' | 'hris';
 
+/**
+ * Canonical route path constants for the `/api/org-units` surface.
+ *
+ * Consumers (backend route handlers, app hooks, typed clients) MUST import
+ * these rather than inlining path literals so a single rename stays
+ * consistent across the system. Parameterised paths are exposed as
+ * functions so callers cannot forget to interpolate the id.
+ *
+ * `tree` returns an `OrgTreeResponse` (alias for `OrgUnitTreeResponse`,
+ * shape `{ nodes, levelConfig }` — see `./schemas`).
+ *
+ * Used by PRD-00511 to consolidate the legacy `/api/org-tree` handler
+ * into `/api/org-units/tree` without changing the response shape.
+ */
+export const ORG_UNITS_ROUTES = {
+  list: '/api/org-units',
+  tree: '/api/org-units/tree',
+  byId: (unitId: string) => `/api/org-units/${unitId}`,
+  children: (unitId: string) => `/api/org-units/${unitId}/children`,
+  ancestors: (unitId: string) => `/api/org-units/${unitId}/ancestors`,
+  descendants: (unitId: string) => `/api/org-units/${unitId}/descendants`,
+  archive: (unitId: string) => `/api/org-units/${unitId}/archive`,
+  reparent: (unitId: string) => `/api/org-units/${unitId}/reparent`,
+  reorder: (unitId: string) => `/api/org-units/${unitId}/reorder`,
+  relationships: (unitId: string) => `/api/org-units/${unitId}/relationships`,
+  memberships: (unitId: string) => `/api/org-units/${unitId}/memberships`,
+  membershipByUser: (unitId: string, userId: string) =>
+    `/api/org-units/${unitId}/memberships/${userId}`,
+  membershipRole: (unitId: string, userId: string) =>
+    `/api/org-units/${unitId}/memberships/${userId}/role`,
+  permissions: (unitId: string) => `/api/org-units/${unitId}/permissions`,
+} as const;
+
+/**
+ * Domain-level alias for the tree endpoint response type.
+ *
+ * The canonical schema lives in `./schemas` as `OrgUnitTreeResponseSchema`
+ * / `OrgUnitTreeResponse`. This alias gives consumers the shorter
+ * `OrgTreeResponse` name used by `GET /api/org-units/tree`.
+ */
+export type { OrgUnitTreeResponse as OrgTreeResponse } from './schemas';
+
 /**
  * Error codes returned by `POST /api/org-units/:id/reparent` and related
  * mutation endpoints. Clients must handle these explicitly.