@company-semantics/contracts 53.0.0 → 54.0.0

package/package.json

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

package/src/api/generated-spec-hash.ts

@@ -1,3 +1,3 @@
 // AUTO-GENERATED — do not edit. Run pnpm generate:spec-hash to regenerate.
-export const SPEC_HASH = 'b8fe0a02c492' as const;
-export const SPEC_HASH_FULL = 'b8fe0a02c49284e732adac870b9b0ff155865b53f5cc8571aa0eb77c4af78859' as const;
+export const SPEC_HASH = '691f7bd81d0c' as const;
+export const SPEC_HASH_FULL = '691f7bd81d0c34aebd47c457a170dd48443a3f9eb007312fa97af00d9a4ccf30' as const;

package/src/api/generated.ts

@@ -4130,6 +4130,7 @@ export interface components {
                 email: string;
                 avatarUrl?: string | null;
                 jobTitle: string | null;
+                seatPositionId: string | null;
                 role: ("owner" | "unit_owner" | "delegate" | "admin") | null;
                 roleNames: string[];
                 joinedAt: string;
@@ -4327,6 +4328,7 @@ export interface components {
             email: string;
             avatarUrl?: string | null;
             jobTitle: string | null;
+            seatPositionId: string | null;
             role: ("owner" | "unit_owner" | "delegate" | "admin") | null;
             roleNames: string[];
             joinedAt: string;

package/src/integrations/schemas.ts

@@ -28,15 +28,31 @@ import { z } from "zod";
 export const HrConnectionStatusSchema = z
   .object({
     connected: z.boolean().meta({
-      description: "Whether an HR provider is currently connected.",
+      description:
+        "Whether an HR provider is currently connected AND usable. False " +
+        "whenever the integration cannot sync — read `credentialState` to " +
+        "tell a never-connected integration from one whose grant died.",
+    }),
+    credentialState: z.enum(["usable", "unusable", "absent"]).meta({
+      description:
+        "Why the integration is or is not working. 'usable' — a connection " +
+        "exists and its credential works (`connected` is true). 'unusable' " +
+        "— a connection exists but its credential cannot be used (expired " +
+        "or revoked grant); previously synced data remains, and the user " +
+        "must reconnect. 'absent' — no connection at all. Distinguishing " +
+        "'unusable' from 'absent' is the whole point: both leave " +
+        "`connected` false, but only one of them is the user's fault to fix " +
+        "by connecting for the first time.",
     }),
     connectionId: z
       .string()
       .nullable()
       .meta({
         description:
-          "Stable id of the active connection — the handle the app passes to " +
-          "`integration.disconnect`. Null when not connected.",
+          "Stable id of the connection row — the handle the app passes to " +
+          "`integration.disconnect`. Present whenever a connection exists, " +
+          "including when `credentialState` is 'unusable', so a dead " +
+          "integration can still be disconnected. Null only when 'absent'.",
       }),
     employeeCount: z.number().int().nonnegative().nullable().meta({
       description:

package/src/message-parts/preview.ts

@@ -42,8 +42,13 @@ export type IntegrationProvider = "slack" | "google" | "zoom";
  * - 'google_drive' → provider='google', service='drive'
  * - 'google_meet' → provider='google', service='meet'
  * - 'zoom' → provider='zoom', service=''
+ * - 'bamboohr' → provider='bamboohr', service=''
+ *
+ * This union is the single definition of the vocabulary; the backend's
+ * `providers/integration-key.ts` must mirror it exactly.
  */
-export type IntegrationKey = "slack" | "google_drive" | "google_meet" | "zoom";
+export type IntegrationKey =
+  "slack" | "google_drive" | "google_meet" | "zoom" | "bamboohr";
 
 /**
  * Content structure for integration artifacts.