@forge/teamwork-graph 3.0.0-next.2 → 3.0.0-next.3

package/out/__test__/entity-operations.test.js

@@ -175,58 +175,6 @@ describe('TeamWorkGraphClient - setObjects', () => {
         expect(mockFetch).toHaveBeenCalledWith((0, endpoints_1.getFullPath)(endpoints_1.ENDPOINTS.OBJECTS.BULK), expect.objectContaining({ method: 'POST' }));
         expect(result).toEqual(expected);
     });
-    it('posts organisation entities to /api/v1/entities/bulk and returns response', async () => {
-        const organisationObject = {
-            schemaVersion: '2.0',
-            id: 'org-1',
-            updateSequenceNumber: 2,
-            displayName: 'pos 2',
-            url: 'https://workday.atlassian.com/path-to-org',
-            createdAt: '2024-07-09T14:27:37.000Z',
-            lastUpdatedAt: '2024-07-09T14:27:37.000Z',
-            permissions: [
-                {
-                    accessControls: [
-                        {
-                            principals: [
-                                {
-                                    type: 'EVERYONE'
-                                }
-                            ]
-                        }
-                    ]
-                }
-            ],
-            parentKey: {
-                type: 'atlassian:organisation',
-                value: {
-                    entityId: 'id of the parent org of this org'
-                }
-            },
-            'atlassian:organisation': {}
-        };
-        const req = { objects: [organisationObject] };
-        const backendResponse = {
-            accepted: [
-                {
-                    entityType: 'atlassian:organisation',
-                    entityId: { id: 'org-1' },
-                    thirdPartyAri: 'ari:third-party:test::organisation/org-1'
-                }
-            ]
-        };
-        const expected = {
-            success: true,
-            results: { accepted: backendResponse.accepted, rejected: undefined, validEntities: undefined }
-        };
-        mockFetch.mockResolvedValueOnce({
-            ok: true,
-            json: () => Promise.resolve(backendResponse)
-        });
-        const result = await graphClient.setObjects(req);
-        expect(mockFetch).toHaveBeenCalledWith((0, endpoints_1.getFullPath)(endpoints_1.ENDPOINTS.OBJECTS.BULK), expect.objectContaining({ method: 'POST' }));
-        expect(result).toEqual(expected);
-    });
     it('throws if objects is not an array', async () => {
         const req = { objects: null };
         await expect(graphClient.setObjects(req)).rejects.toThrow('objects must be an array');
@@ -1338,71 +1286,6 @@ describe('TeamWorkGraphClient - bulk entities', () => {
         expect(mockFetch).toHaveBeenCalledWith((0, endpoints_1.getFullPath)(endpoints_1.ENDPOINTS.OBJECTS.BULK), expect.objectContaining({ method: 'POST' }));
         expect(result).toEqual(expected);
     });
-    it('posts position entities to /api/v1/entities/bulk and returns response', async () => {
-        const positionObject = {
-            schemaVersion: '2.0',
-            id: 'position-1',
-            updateSequenceNumber: 1,
-            displayName: 'Senior Software Engineer - Backend',
-            url: 'https://hr.example.com/positions/senior-backend-engineer',
-            createdAt: '2024-07-09T14:27:37.000Z',
-            lastUpdatedAt: '2024-07-09T14:27:37.000Z',
-            permissions: [
-                {
-                    accessControls: [
-                        {
-                            principals: [
-                                {
-                                    type: 'EVERYONE'
-                                }
-                            ]
-                        }
-                    ]
-                }
-            ],
-            parentKey: {
-                type: 'atlassian:organisation',
-                value: {
-                    entityId: 'org-tech-company-123'
-                }
-            },
-            associations: {
-                lastUpdatedAt: '2024-07-09T14:27:37.000Z',
-                set: [
-                    {
-                        associationType: 'atlassian:worker',
-                        values: ['worker-alice-johnson-456']
-                    }
-                ]
-            },
-            'atlassian:position': {
-                customAndSensitiveData: 'Salary range: $120,000-$150,000. Remote work eligible.',
-                status: 'Open',
-                jobTitle: 'Senior Software Engineer - Backend'
-            }
-        };
-        const req = { objects: [positionObject] };
-        const backendResponse = {
-            accepted: [
-                {
-                    entityType: 'atlassian:position',
-                    entityId: { id: 'position-1' },
-                    thirdPartyAri: 'ari:third-party:test::position/position-1'
-                }
-            ]
-        };
-        const expected = {
-            success: true,
-            results: { accepted: backendResponse.accepted, rejected: undefined, validEntities: undefined }
-        };
-        mockFetch.mockResolvedValueOnce({
-            ok: true,
-            json: () => Promise.resolve(backendResponse)
-        });
-        const result = await graphClient.setObjects(req);
-        expect(mockFetch).toHaveBeenCalledWith((0, endpoints_1.getFullPath)(endpoints_1.ENDPOINTS.OBJECTS.BULK), expect.objectContaining({ method: 'POST' }));
-        expect(result).toEqual(expected);
-    });
     it('posts project entities to /api/v1/entities/bulk and returns response', async () => {
         const projectObject = {
             schemaVersion: '2.0',
@@ -1978,7 +1861,6 @@ describe('TeamWorkGraphClient - bulk entities', () => {
                 ],
                 exceedsMaxCollaborators: false,
                 status: 'In Progress',
-                subtype: 'Development Task',
                 attachments: [
                     {
                         url: 'https://files.example.com/auth-api-spec.pdf',
@@ -2020,60 +1902,6 @@ describe('TeamWorkGraphClient - bulk entities', () => {
         expect(mockFetch).toHaveBeenCalledWith((0, endpoints_1.getFullPath)(endpoints_1.ENDPOINTS.OBJECTS.BULK), expect.objectContaining({ method: 'POST' }));
         expect(result).toEqual(expected);
     });
-    it('posts worker entities to /api/v1/entities/bulk and returns response', async () => {
-        const workerObject = {
-            schemaVersion: '2.0',
-            id: 'worker-1',
-            updateSequenceNumber: 1,
-            displayName: 'Sarah Johnson - Senior Software Engineer',
-            url: 'https://hr.example.com/employees/sarah-johnson',
-            createdAt: '2024-07-09T14:27:37.000Z',
-            lastUpdatedAt: '2024-07-09T14:27:37.000Z',
-            permissions: [
-                {
-                    accessControls: [
-                        {
-                            principals: [
-                                {
-                                    type: 'EVERYONE'
-                                }
-                            ]
-                        }
-                    ]
-                }
-            ],
-            'atlassian:worker': {
-                hiredAt: '2022-03-15T09:00:00.000Z',
-                workerUser: {
-                    accountId: 'worker-sarah-123',
-                    externalId: 'emp-sarah-456',
-                    email: 'sarah.johnson@example.com'
-                },
-                customAndSensitiveData: 'Employee ID: EMP001234, Department: Engineering, Salary Grade: L5, Manager: Alex Rodriguez, Office Location: San Francisco HQ'
-            }
-        };
-        const req = { objects: [workerObject] };
-        const backendResponse = {
-            accepted: [
-                {
-                    entityType: 'atlassian:worker',
-                    entityId: { id: 'worker-1' },
-                    thirdPartyAri: 'ari:third-party:test::worker/worker-1'
-                }
-            ]
-        };
-        const expected = {
-            success: true,
-            results: { accepted: backendResponse.accepted, rejected: undefined, validEntities: undefined }
-        };
-        mockFetch.mockResolvedValueOnce({
-            ok: true,
-            json: () => Promise.resolve(backendResponse)
-        });
-        const result = await graphClient.setObjects(req);
-        expect(mockFetch).toHaveBeenCalledWith((0, endpoints_1.getFullPath)(endpoints_1.ENDPOINTS.OBJECTS.BULK), expect.objectContaining({ method: 'POST' }));
-        expect(result).toEqual(expected);
-    });
     it('posts dashboard entities to /api/v1/entities/bulk and returns response', async () => {
         const dashboardObject = {
             schemaVersion: '2.0',

package/out/__test__/error-handling.test.js

@@ -47,4 +47,99 @@ describe('TeamWorkGraphClient - Error Handling Functions', () => {
             expect(deleteResult.originalError).toBe(error);
         });
     });
+    describe('handleResponseError', () => {
+        test('should extract trace ID from atl-traceid header and include it in error message', async () => {
+            const mockResponse = {
+                ok: false,
+                status: 500,
+                statusText: 'Internal Server Error',
+                headers: {
+                    get: jest.fn((headerName) => {
+                        if (headerName === 'atl-traceid') {
+                            return 'trace-12345-abcdef';
+                        }
+                        return null;
+                    })
+                },
+                json: jest.fn().mockResolvedValue({
+                    message: 'Something went wrong',
+                    code: 'INTERNAL_ERROR'
+                })
+            };
+            try {
+                await (0, error_handling_1.handleResponseError)(mockResponse, 'API request failed');
+            }
+            catch (error) {
+                expect(error).toBeInstanceOf(errors_1.ForgeTeamWorkGraphAPIError);
+                expect(error.message).toContain('Internal Server Error - Something went wrong');
+                expect(error.message).toContain('(Trace ID: trace-12345-abcdef)');
+                expect(error.traceId).toBe('trace-12345-abcdef');
+            }
+        });
+        test('should handle response without trace ID', async () => {
+            const mockResponse = {
+                ok: false,
+                status: 404,
+                statusText: 'Not Found',
+                headers: {
+                    get: jest.fn(() => null)
+                },
+                json: jest.fn().mockResolvedValue({
+                    message: 'Resource not found'
+                })
+            };
+            try {
+                await (0, error_handling_1.handleResponseError)(mockResponse, 'API request failed');
+            }
+            catch (error) {
+                expect(error).toBeInstanceOf(errors_1.ForgeTeamWorkGraphAPIError);
+                expect(error.message).toContain('Not Found - Resource not found');
+                expect(error.message).not.toContain('Trace ID:');
+                expect(error.traceId).toBeUndefined();
+            }
+        });
+        test('should handle response with unparseable JSON and trace ID', async () => {
+            const mockResponse = {
+                ok: false,
+                status: 502,
+                statusText: 'Bad Gateway',
+                headers: {
+                    get: jest.fn((headerName) => {
+                        if (headerName === 'atl-traceid') {
+                            return 'trace-99999-xyz';
+                        }
+                        return null;
+                    })
+                },
+                json: jest.fn().mockRejectedValue(new Error('Invalid JSON'))
+            };
+            try {
+                await (0, error_handling_1.handleResponseError)(mockResponse, 'API request failed');
+            }
+            catch (error) {
+                expect(error).toBeInstanceOf(errors_1.ForgeTeamWorkGraphAPIError);
+                expect(error.message).toContain('Bad Gateway - API request failed: HTTP 502 - Bad Gateway');
+                expect(error.message).toContain('(Trace ID: trace-99999-xyz)');
+                expect(error.traceId).toBe('trace-99999-xyz');
+            }
+        });
+    });
+    describe('ForgeTeamWorkGraphAPIError with trace ID', () => {
+        test('should create API error with trace ID', () => {
+            const error = new errors_1.ForgeTeamWorkGraphAPIError('Test error message', 500, { details: 'Some details' }, 'trace-12345');
+            expect(error.message).toBe('Test error message');
+            expect(error.status).toBe(500);
+            expect(error.responseBody).toEqual({ details: 'Some details' });
+            expect(error.traceId).toBe('trace-12345');
+            expect(error.code).toBe('API_ERROR');
+        });
+        test('should create API error without trace ID', () => {
+            const error = new errors_1.ForgeTeamWorkGraphAPIError('Test error message', 400, { details: 'Some details' });
+            expect(error.message).toBe('Test error message');
+            expect(error.status).toBe(400);
+            expect(error.responseBody).toEqual({ details: 'Some details' });
+            expect(error.traceId).toBeUndefined();
+            expect(error.code).toBe('API_ERROR');
+        });
+    });
 });

package/out/types/objects/index.d.ts

@@ -11,8 +11,6 @@ import { DeploymentObject } from './deployment';
 import { DesignObject } from './design';
 import { DocumentObject } from './document';
 import { MessageObject } from './message';
-import { OrganisationObject } from './organisation';
-import { PositionObject } from './position';
 import { ProjectObject } from './project';
 import { PullRequestObject } from './pull-request';
 import { RemoteLinkObject } from './remote-link';
@@ -25,7 +23,6 @@ import { TestPlanObject } from './test-plan';
 import { TestRunObject } from './test-run';
 import { VideoObject } from './video';
 import { WorkItemObject } from './work-item';
-import { WorkerObject } from './worker';
-export { BranchObject, BuildObject, CalendarEventObject, CommentObject, CommitObject, ConversationObject, CustomerOrgObject, DashboardObject, DealObject, DeploymentObject, DesignObject, DocumentObject, MessageObject, OrganisationObject, PositionObject, ProjectObject, PullRequestObject, RemoteLinkObject, RepositoryObject, SoftwareServiceObject, SpaceObject, TestObject, TestExecutionObject, TestPlanObject, TestRunObject, VideoObject, WorkItemObject, WorkerObject };
-export declare type Object = BranchObject | BuildObject | CalendarEventObject | CommentObject | CommitObject | ConversationObject | CustomerOrgObject | DashboardObject | DealObject | DeploymentObject | DesignObject | DocumentObject | MessageObject | OrganisationObject | PositionObject | ProjectObject | PullRequestObject | RemoteLinkObject | RepositoryObject | SoftwareServiceObject | SpaceObject | TestObject | TestExecutionObject | TestPlanObject | TestRunObject | VideoObject | WorkItemObject | WorkerObject;
+export { BranchObject, BuildObject, CalendarEventObject, CommentObject, CommitObject, ConversationObject, CustomerOrgObject, DashboardObject, DealObject, DeploymentObject, DesignObject, DocumentObject, MessageObject, ProjectObject, PullRequestObject, RemoteLinkObject, RepositoryObject, SoftwareServiceObject, SpaceObject, TestObject, TestExecutionObject, TestPlanObject, TestRunObject, VideoObject, WorkItemObject };
+export declare type Object = BranchObject | BuildObject | CalendarEventObject | CommentObject | CommitObject | ConversationObject | CustomerOrgObject | DashboardObject | DealObject | DeploymentObject | DesignObject | DocumentObject | MessageObject | ProjectObject | PullRequestObject | RemoteLinkObject | RepositoryObject | SoftwareServiceObject | SpaceObject | TestObject | TestExecutionObject | TestPlanObject | TestRunObject | VideoObject | WorkItemObject;
 //# sourceMappingURL=index.d.ts.map

package/out/types/objects/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/objects/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGxC,OAAO,EACL,YAAY,EACZ,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,WAAW,EACX,UAAU,EACV,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,WAAW,EACX,cAAc,EACd,YAAY,EACb,CAAC;AAGF,oBAAY,MAAM,GACd,YAAY,GACZ,WAAW,GACX,mBAAmB,GACnB,aAAa,GACb,YAAY,GACZ,kBAAkB,GAClB,iBAAiB,GACjB,eAAe,GACf,UAAU,GACV,gBAAgB,GAChB,YAAY,GACZ,cAAc,GACd,aAAa,GACb,kBAAkB,GAClB,cAAc,GACd,aAAa,GACb,iBAAiB,GACjB,gBAAgB,GAChB,gBAAgB,GAChB,qBAAqB,GACrB,WAAW,GACX,UAAU,GACV,mBAAmB,GACnB,cAAc,GACd,aAAa,GACb,WAAW,GACX,cAAc,GACd,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/objects/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,EACL,YAAY,EACZ,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,WAAW,EACX,UAAU,EACV,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,WAAW,EACX,cAAc,EACf,CAAC;AAGF,oBAAY,MAAM,GACd,YAAY,GACZ,WAAW,GACX,mBAAmB,GACnB,aAAa,GACb,YAAY,GACZ,kBAAkB,GAClB,iBAAiB,GACjB,eAAe,GACf,UAAU,GACV,gBAAgB,GAChB,YAAY,GACZ,cAAc,GACd,aAAa,GACb,aAAa,GACb,iBAAiB,GACjB,gBAAgB,GAChB,gBAAgB,GAChB,qBAAqB,GACrB,WAAW,GACX,UAAU,GACV,mBAAmB,GACnB,cAAc,GACd,aAAa,GACb,WAAW,GACX,cAAc,CAAC"}

package/out/utils/error-handling.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-handling.d.ts","sourceRoot":"","sources":["../../src/utils/error-handling.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAgBzC,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAoDhG;AAwBD,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,CAAC,CAQnE"}
+{"version":3,"file":"error-handling.d.ts","sourceRoot":"","sources":["../../src/utils/error-handling.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAgBzC,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CA4DhG;AAwBD,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,CAAC,CAQnE"}

package/out/utils/error-handling.js

@@ -4,6 +4,7 @@ exports.handleError = exports.handleResponseError = void 0;
 const errors_1 = require("./errors");
 async function handleResponseError(response, context) {
     let errorDetails;
+    const traceId = response.headers.get('atl-traceid') ?? undefined;
     try {
         const responseBody = await response.json();
         errorDetails = {
@@ -48,7 +49,10 @@ async function handleResponseError(response, context) {
         default:
             errorMessage = `HTTP ${response.status} - ${errorDetails.message}`;
     }
-    throw new errors_1.ForgeTeamWorkGraphAPIError(errorMessage, response.status, errorDetails.details);
+    if (traceId) {
+        errorMessage += ` (Trace ID: ${traceId})`;
+    }
+    throw new errors_1.ForgeTeamWorkGraphAPIError(errorMessage, response.status, errorDetails.details, traceId);
 }
 exports.handleResponseError = handleResponseError;
 function createErrorMessage(error, operation) {

package/out/utils/errors.d.ts

@@ -13,6 +13,7 @@ export declare class ForgeTeamWorkGraphNetworkError extends ForgeTeamWorkGraphEr
 export declare class ForgeTeamWorkGraphAPIError extends ForgeTeamWorkGraphError {
     readonly status: number;
     readonly responseBody?: any;
-    constructor(message: string, status: number, responseBody?: any);
+    readonly traceId?: string;
+    constructor(message: string, status: number, responseBody?: any, traceId?: string);
 }
 //# sourceMappingURL=errors.d.ts.map

package/out/utils/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAGA,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,KAAK,CAAC,EAAE,MAAM,CAAC;IAC/B,SAAgB,OAAO,CAAC,EAAE,GAAG,CAAC;gBAElB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAOzE;AAKD,qBAAa,iCAAkC,SAAQ,uBAAuB;gBAChE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAG3D;AAKD,qBAAa,8BAA+B,SAAQ,uBAAuB;gBAC7D,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAG3C;AAKD,qBAAa,0BAA2B,SAAQ,uBAAuB;IACrE,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,YAAY,CAAC,EAAE,GAAG,CAAC;gBAEvB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,GAAG;CAKhE"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAGA,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,KAAK,CAAC,EAAE,MAAM,CAAC;IAC/B,SAAgB,OAAO,CAAC,EAAE,GAAG,CAAC;gBAElB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAOzE;AAKD,qBAAa,iCAAkC,SAAQ,uBAAuB;gBAChE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAG3D;AAKD,qBAAa,8BAA+B,SAAQ,uBAAuB;gBAC7D,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAG3C;AAKD,qBAAa,0BAA2B,SAAQ,uBAAuB;IACrE,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,YAAY,CAAC,EAAE,GAAG,CAAC;IACnC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC;gBAErB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,MAAM;CAMlF"}

package/out/utils/errors.js

@@ -29,10 +29,12 @@ exports.ForgeTeamWorkGraphNetworkError = ForgeTeamWorkGraphNetworkError;
 class ForgeTeamWorkGraphAPIError extends ForgeTeamWorkGraphError {
     status;
     responseBody;
-    constructor(message, status, responseBody) {
-        super(message, 'API_ERROR', undefined, { status, responseBody });
+    traceId;
+    constructor(message, status, responseBody, traceId) {
+        super(message, 'API_ERROR', undefined, { status, responseBody, traceId });
         this.status = status;
         this.responseBody = responseBody;
+        this.traceId = traceId;
     }
 }
 exports.ForgeTeamWorkGraphAPIError = ForgeTeamWorkGraphAPIError;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forge/teamwork-graph",
-  "version": "3.0.0-next.2",
+  "version": "3.0.0-next.3",
   "description": "Forge TeamworkGraph SDK",
   "author": "Atlassian",
   "license": "UNLICENSED",

package/out/types/objects/organisation.d.ts

@@ -1,9 +0,0 @@
-import { BaseObjectProperties } from './common';
-export declare type OrganisationAttributes = {};
-export declare type OrganisationObject = BaseObjectProperties & {
-    displayName: string;
-    lastUpdatedAt: string;
-    permissions: NonNullable<BaseObjectProperties['permissions']>;
-    'atlassian:organisation': OrganisationAttributes;
-};
-//# sourceMappingURL=organisation.d.ts.map

package/out/types/objects/organisation.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"organisation.d.ts","sourceRoot":"","sources":["../../../src/types/objects/organisation.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAEhD,oBAAY,sBAAsB,GAAG,EAAE,CAAC;AAExC,oBAAY,kBAAkB,GAAG,oBAAoB,GAAG;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,WAAW,CAAC,oBAAoB,CAAC,aAAa,CAAC,CAAC,CAAC;IAC9D,wBAAwB,EAAE,sBAAsB,CAAC;CAClD,CAAC"}

package/out/types/objects/organisation.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/out/types/objects/position.d.ts

@@ -1,24 +0,0 @@
-import { BaseObjectProperties, ParentKeyObject, Associations } from './common';
-export declare type PositionAttributes = {
-    customAndSensitiveData?: string;
-    status: string;
-    jobTitle?: string;
-};
-export declare type PositionObject = BaseObjectProperties & {
-    displayName: string;
-    lastUpdatedAt: string;
-    permissions: NonNullable<BaseObjectProperties['permissions']>;
-    parentKey: ParentKeyObject & {
-        type: 'atlassian:organisation';
-    };
-    associations: Associations & {
-        set: [
-            {
-                associationType: 'atlassian:worker';
-                values: [string] | [];
-            }
-        ];
-    };
-    'atlassian:position': PositionAttributes;
-};
-//# sourceMappingURL=position.d.ts.map

package/out/types/objects/position.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"position.d.ts","sourceRoot":"","sources":["../../../src/types/objects/position.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE/E,oBAAY,kBAAkB,GAAG;IAC/B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,oBAAY,cAAc,GAAG,oBAAoB,GAAG;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,WAAW,CAAC,oBAAoB,CAAC,aAAa,CAAC,CAAC,CAAC;IAC9D,SAAS,EAAE,eAAe,GAAG;QAAE,IAAI,EAAE,wBAAwB,CAAA;KAAE,CAAC;IAChE,YAAY,EAAE,YAAY,GAAG;QAC3B,GAAG,EAAE;YACH;gBACE,eAAe,EAAE,kBAAkB,CAAC;gBACpC,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;aACvB;SACF,CAAC;KACH,CAAC;IACF,oBAAoB,EAAE,kBAAkB,CAAC;CAC1C,CAAC"}

package/out/types/objects/position.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/out/types/objects/worker.d.ts

@@ -1,13 +0,0 @@
-import { BaseObjectProperties, UserReference } from './common';
-export declare type WorkerAttributes = {
-    hiredAt: string;
-    workerUser: UserReference;
-    customAndSensitiveData?: string;
-};
-export declare type WorkerObject = BaseObjectProperties & {
-    displayName: string;
-    lastUpdatedAt: string;
-    permissions: NonNullable<BaseObjectProperties['permissions']>;
-    'atlassian:worker': WorkerAttributes;
-};
-//# sourceMappingURL=worker.d.ts.map

package/out/types/objects/worker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../../src/types/objects/worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE/D,oBAAY,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,aAAa,CAAC;IAC1B,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC,CAAC;AAEF,oBAAY,YAAY,GAAG,oBAAoB,GAAG;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,WAAW,CAAC,oBAAoB,CAAC,aAAa,CAAC,CAAC,CAAC;IAC9D,kBAAkB,EAAE,gBAAgB,CAAC;CACtC,CAAC"}

package/out/types/objects/worker.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });