@company-semantics/contracts 79.0.0 → 79.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "79.0.0",
+  "version": "79.1.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 = '554ba5a13882' as const;
-export const SPEC_HASH_FULL = '554ba5a138827be4f4959d0a9d0199be36e129c9caacce47370121ffede938bf' as const;
+export const SPEC_HASH = 'c6eea14298b3' as const;
+export const SPEC_HASH_FULL = 'c6eea14298b3f6282e821b61fac860d7c18fbb8af4b5ecf660bc09665a215d9b' as const;

package/src/api/generated.ts

@@ -4589,6 +4589,30 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/source-sync/settings": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Read whether Source Sync is on for the org
+         * @description The org switch every Source Sync route, job and sweep gates on, and who last changed it and when. Off until an admin turns it on.
+         */
+        get: operations["getSourceSyncSettings"];
+        /**
+         * Switch Source Sync on or off for the org
+         * @description On lets Source Sync search the connected Drive and propose company.md updates for review. Off pauses it: nothing is read or run, and nothing already brought in is deleted. The caller is recorded as the person who changed it.
+         */
+        put: operations["putSourceSyncSettings"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 }
 export type webhooks = Record<string, never>;
 export interface components {
@@ -9296,6 +9320,14 @@ export interface components {
             /** @constant */
             confirm: true;
         };
+        SourceSyncSettingsResponse: {
+            enabled: boolean;
+            changedAt: string | null;
+            changedByLabel: string | null;
+        };
+        SourceSyncPutSettingsRequest: {
+            enabled: boolean;
+        };
         /** @description Server-enforced collaboration size limits, published so clients can pre-check. */
         CollabSyncLimits: {
             maxUpdateBytes: number;
@@ -17248,14 +17280,7 @@ export interface operations {
                     "application/json": components["schemas"]["SourceSyncDiscoveryRunResponse"];
                 };
             };
-            /** @description Source Sync is not enabled */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
-            /** @description The org has no active Google Drive connection (SOURCE_SYNC_DRIVE_NOT_CONNECTED), or a discovery run is already running (SOURCE_DISCOVERY_ALREADY_RUNNING) */
+            /** @description Source Sync is off for this org (SOURCE_SYNC_OFF), or The org has no active Google Drive connection (SOURCE_SYNC_DRIVE_NOT_CONNECTED), or a discovery run is already running (SOURCE_DISCOVERY_ALREADY_RUNNING) */
             409: {
                 headers: {
                     [name: string]: unknown;
@@ -17282,13 +17307,20 @@ export interface operations {
                     "application/json": components["schemas"]["SourceSyncCandidateSetResponse"];
                 };
             };
-            /** @description Source Sync is not enabled, or the org has no draft candidate set */
+            /** @description The org has no draft candidate set */
             404: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content?: never;
             };
+            /** @description Source Sync is off for this org (SOURCE_SYNC_OFF) */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
         };
     };
     patchSourceCandidateItem: {
@@ -17330,14 +17362,14 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Source Sync is not enabled, or the set, item or target document is not the org’s */
+            /** @description The set, item or target document is not the org’s */
             404: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content?: never;
             };
-            /** @description The set is no longer a draft (SOURCE_SYNC_CANDIDATE_SET_NOT_DRAFT), or the item’s scope was already approved (SOURCE_SYNC_CANDIDATE_ITEM_FROZEN) */
+            /** @description Source Sync is off for this org (SOURCE_SYNC_OFF), or The set is no longer a draft (SOURCE_SYNC_CANDIDATE_SET_NOT_DRAFT), or the item’s scope was already approved (SOURCE_SYNC_CANDIDATE_ITEM_FROZEN) */
             409: {
                 headers: {
                     [name: string]: unknown;
@@ -17377,14 +17409,14 @@ export interface operations {
                     "application/json": components["schemas"]["SourceSyncCandidateSetResponse"];
                 };
             };
-            /** @description Source Sync is not enabled, or the set, the file or the target document is not the org’s */
+            /** @description The set, the file or the target document is not the org’s */
             404: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content?: never;
             };
-            /** @description No active Google Drive connection (SOURCE_SYNC_DRIVE_NOT_CONNECTED), the set is no longer a draft (SOURCE_SYNC_CANDIDATE_SET_NOT_DRAFT), or the file is already on the list for that document (SOURCE_SYNC_CANDIDATE_ALREADY_IN_SET) */
+            /** @description Source Sync is off for this org (SOURCE_SYNC_OFF), or No active Google Drive connection (SOURCE_SYNC_DRIVE_NOT_CONNECTED), the set is no longer a draft (SOURCE_SYNC_CANDIDATE_SET_NOT_DRAFT), or the file is already on the list for that document (SOURCE_SYNC_CANDIDATE_ALREADY_IN_SET) */
             409: {
                 headers: {
                     [name: string]: unknown;
@@ -17428,14 +17460,14 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Source Sync is not enabled, or the set is not the org’s */
+            /** @description The set is not the org’s */
             404: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content?: never;
             };
-            /** @description Stale revision (SOURCE_SYNC_CANDIDATE_SET_STALE), an unresolved widening (SOURCE_SYNC_TREATMENT_UNRESOLVED), a file with no document (SOURCE_SYNC_TARGET_UNRESOLVED), a scope already approved (SOURCE_SYNC_SCOPE_ALREADY_APPROVED), or a set no longer a draft (SOURCE_SYNC_CANDIDATE_SET_NOT_DRAFT) */
+            /** @description Source Sync is off for this org (SOURCE_SYNC_OFF), or Stale revision (SOURCE_SYNC_CANDIDATE_SET_STALE), an unresolved widening (SOURCE_SYNC_TREATMENT_UNRESOLVED), a file with no document (SOURCE_SYNC_TARGET_UNRESOLVED), a scope already approved (SOURCE_SYNC_SCOPE_ALREADY_APPROVED), or a set no longer a draft (SOURCE_SYNC_CANDIDATE_SET_NOT_DRAFT) */
             409: {
                 headers: {
                     [name: string]: unknown;
@@ -17462,8 +17494,8 @@ export interface operations {
                     "application/json": components["schemas"]["SourceSyncCurrentSynthesisResponse"];
                 };
             };
-            /** @description Source Sync is not enabled */
-            404: {
+            /** @description Source Sync is off for this org (SOURCE_SYNC_OFF) */
+            409: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -17491,13 +17523,20 @@ export interface operations {
                     "application/json": components["schemas"]["SourceSyncSynthesisResponse"];
                 };
             };
-            /** @description Source Sync is not enabled, or the batch is not the org’s */
+            /** @description The batch is not the org’s */
             404: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content?: never;
             };
+            /** @description Source Sync is off for this org (SOURCE_SYNC_OFF) */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
         };
     };
     applySourceSynthesis: {
@@ -17537,14 +17576,14 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Source Sync is not enabled, or the batch or an included change is not the org’s */
+            /** @description The batch or an included change is not the org’s */
             404: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content?: never;
             };
-            /** @description An included document still has an open question (SOURCE_SYNC_DOC_BLOCKED), or the review or a change is no longer open to apply (SOURCE_SYNC_SYNTHESIS_NOT_OPEN) */
+            /** @description Source Sync is off for this org (SOURCE_SYNC_OFF), or An included document still has an open question (SOURCE_SYNC_DOC_BLOCKED), or the review or a change is no longer open to apply (SOURCE_SYNC_SYNTHESIS_NOT_OPEN) */
             409: {
                 headers: {
                     [name: string]: unknown;
@@ -17571,8 +17610,8 @@ export interface operations {
                     "application/json": components["schemas"]["SourceSyncRulesResponse"];
                 };
             };
-            /** @description Source Sync is not enabled */
-            404: {
+            /** @description Source Sync is off for this org (SOURCE_SYNC_OFF) */
+            409: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -17609,14 +17648,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Source Sync is not enabled */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
-            /** @description An active rule already stands for this subject (SOURCE_SYNC_RULE_DUPLICATE); nothing changed */
+            /** @description Source Sync is off for this org (SOURCE_SYNC_OFF), or An active rule already stands for this subject (SOURCE_SYNC_RULE_DUPLICATE); nothing changed */
             409: {
                 headers: {
                     [name: string]: unknown;
@@ -17645,13 +17677,20 @@ export interface operations {
                     "application/json": components["schemas"]["SourceSyncRule"];
                 };
             };
-            /** @description Source Sync is not enabled, or the rule is not the org’s or is already retired */
+            /** @description The rule is not the org’s or is already retired */
             404: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content?: never;
             };
+            /** @description Source Sync is off for this org (SOURCE_SYNC_OFF) */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
         };
     };
     listSourceSyncFindings: {
@@ -17679,8 +17718,8 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Source Sync is not enabled */
-            404: {
+            /** @description Source Sync is off for this org (SOURCE_SYNC_OFF) */
+            409: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -17726,14 +17765,14 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Source Sync is not enabled, or the finding is not the org’s or names no source */
+            /** @description The finding is not the org’s or names no source */
             404: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content?: never;
             };
-            /** @description The finding already settled on its own (SOURCE_SYNC_FINDING_NOT_OPEN); nothing changed */
+            /** @description Source Sync is off for this org (SOURCE_SYNC_OFF), or The finding already settled on its own (SOURCE_SYNC_FINDING_NOT_OPEN); nothing changed */
             409: {
                 headers: {
                     [name: string]: unknown;
@@ -17767,8 +17806,8 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Source Sync is not enabled */
-            404: {
+            /** @description Source Sync is off for this org (SOURCE_SYNC_OFF) */
+            409: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -17814,8 +17853,8 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Source Sync is not enabled */
-            404: {
+            /** @description Source Sync is off for this org (SOURCE_SYNC_OFF) */
+            409: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -17848,8 +17887,8 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Source Sync is not enabled */
-            404: {
+            /** @description Source Sync is off for this org (SOURCE_SYNC_OFF) */
+            409: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -17893,22 +17932,80 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Source Sync is not enabled */
-            404: {
+            /** @description Source Sync is off for this org (SOURCE_SYNC_OFF), or Workspace-wide access is off or not set up, Drive is not connected or is not a Workspace account, reach is already domain, or Google did not accept the delegation */
+            409: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content?: never;
             };
-            /** @description Workspace-wide access is off or not set up, Drive is not connected or is not a Workspace account, reach is already domain, or Google did not accept the delegation */
-            409: {
+            /** @description Google could not be reached to verify the delegation */
+            502: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content?: never;
             };
-            /** @description Google could not be reached to verify the delegation */
-            502: {
+        };
+    };
+    getSourceSyncSettings: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The org’s Source Sync switch */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SourceSyncSettingsResponse"];
+                };
+            };
+            /** @description The caller may not manage integrations */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    putSourceSyncSettings: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["SourceSyncPutSettingsRequest"];
+            };
+        };
+        responses: {
+            /** @description The switch as it now stands */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SourceSyncSettingsResponse"];
+                };
+            };
+            /** @description Invalid body */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description The caller may not manage integrations */
+            403: {
                 headers: {
                     [name: string]: unknown;
                 };

package/src/generated/openapi-routes.ts

@@ -191,6 +191,7 @@ export const openApiRoutes = {
   '/api/source-sync/reach/upgrade': ['POST'],
   '/api/source-sync/rules': ['GET', 'POST'],
   '/api/source-sync/rules/{ruleId}/retire': ['POST'],
+  '/api/source-sync/settings': ['GET', 'PUT'],
   '/api/source-sync/standing-orders': ['GET'],
   '/api/source-sync/standing-orders/{scopeKey}': ['PUT'],
   '/api/source-sync/syntheses/current': ['GET'],