@37signals/basecamp 0.2.0

package/dist/hooks.js

@@ -0,0 +1,196 @@
+/**
+ * Observability hooks system for the Basecamp SDK.
+ *
+ * Provides a way to observe API operations and HTTP requests
+ * without modifying the core client logic. Hooks compile away
+ * when unused (no overhead).
+ *
+ * @example
+ * ```ts
+ * import { createBasecampClient, consoleHooks } from "@37signals/basecamp";
+ *
+ * // Simple console logging
+ * const client = createBasecampClient({
+ *   accountId: "12345",
+ *   accessToken: "token",
+ *   hooks: consoleHooks(),
+ * });
+ *
+ * // Custom metrics
+ * const client = createBasecampClient({
+ *   accountId: "12345",
+ *   accessToken: "token",
+ *   hooks: {
+ *     onOperationEnd: (info, result) => {
+ *       metrics.recordLatency(info.service, info.operation, result.durationMs);
+ *       if (result.error) {
+ *         metrics.recordError(info.service, info.operation);
+ *       }
+ *     },
+ *   },
+ * });
+ * ```
+ */
+/**
+ * Combines multiple hooks into a single hooks object.
+ * All hooks are called in order. Errors in hooks are caught and logged.
+ *
+ * @example
+ * ```ts
+ * const hooks = chainHooks(
+ *   consoleHooks(),
+ *   metricsHooks(),
+ *   sentryHooks(),
+ * );
+ * ```
+ */
+export function chainHooks(...hooks) {
+    // Filter out undefined/null hooks
+    const activeHooks = hooks.filter(Boolean);
+    if (activeHooks.length === 0) {
+        return {};
+    }
+    if (activeHooks.length === 1) {
+        return activeHooks[0];
+    }
+    return {
+        onOperationStart: (info) => {
+            for (const h of activeHooks) {
+                try {
+                    h.onOperationStart?.(info);
+                }
+                catch (err) {
+                    console.error("Hook onOperationStart error:", err);
+                }
+            }
+        },
+        onOperationEnd: (info, result) => {
+            for (const h of activeHooks) {
+                try {
+                    h.onOperationEnd?.(info, result);
+                }
+                catch (err) {
+                    console.error("Hook onOperationEnd error:", err);
+                }
+            }
+        },
+        onRequestStart: (info) => {
+            for (const h of activeHooks) {
+                try {
+                    h.onRequestStart?.(info);
+                }
+                catch (err) {
+                    console.error("Hook onRequestStart error:", err);
+                }
+            }
+        },
+        onRequestEnd: (info, result) => {
+            for (const h of activeHooks) {
+                try {
+                    h.onRequestEnd?.(info, result);
+                }
+                catch (err) {
+                    console.error("Hook onRequestEnd error:", err);
+                }
+            }
+        },
+        onRetry: (info, attempt, error, delayMs) => {
+            for (const h of activeHooks) {
+                try {
+                    h.onRetry?.(info, attempt, error, delayMs);
+                }
+                catch (err) {
+                    console.error("Hook onRetry error:", err);
+                }
+            }
+        },
+    };
+}
+/**
+ * Creates hooks that log to the console.
+ * Useful for debugging and development.
+ *
+ * @example
+ * ```ts
+ * // Basic usage
+ * const hooks = consoleHooks();
+ *
+ * // With custom options
+ * const hooks = consoleHooks({
+ *   logRequests: true,
+ *   minDurationMs: 100,
+ * });
+ * ```
+ */
+export function consoleHooks(options = {}) {
+    const { logOperations = true, logRequests = false, logRetries = true, minDurationMs = 0, logger = console, } = options;
+    return {
+        onOperationStart: logOperations
+            ? (info) => {
+                const mutation = info.isMutation ? " [mutation]" : "";
+                const resource = info.resourceId ? ` #${info.resourceId}` : "";
+                const project = info.projectId ? ` (project: ${info.projectId})` : "";
+                logger.log(`[Basecamp] ${info.service}.${info.operation}${resource}${project}${mutation}`);
+            }
+            : undefined,
+        onOperationEnd: logOperations
+            ? (info, result) => {
+                if (result.durationMs < minDurationMs)
+                    return;
+                const duration = `${result.durationMs}ms`;
+                if (result.error) {
+                    logger.error(`[Basecamp] ${info.service}.${info.operation} failed (${duration}):`, result.error.message);
+                }
+                else {
+                    logger.log(`[Basecamp] ${info.service}.${info.operation} completed (${duration})`);
+                }
+            }
+            : undefined,
+        onRequestStart: logRequests
+            ? (info) => {
+                const retry = info.attempt > 1 ? ` (attempt ${info.attempt})` : "";
+                logger.log(`[Basecamp] -> ${info.method} ${info.url}${retry}`);
+            }
+            : undefined,
+        onRequestEnd: logRequests
+            ? (info, result) => {
+                if (result.durationMs < minDurationMs)
+                    return;
+                const cache = result.fromCache ? " (cached)" : "";
+                const status = result.error ? "error" : result.statusCode;
+                logger.log(`[Basecamp] <- ${info.method} ${info.url} ${status} (${result.durationMs}ms)${cache}`);
+            }
+            : undefined,
+        onRetry: logRetries
+            ? (info, attempt, error, delayMs) => {
+                logger.warn(`[Basecamp] Retrying ${info.method} ${info.url} (attempt ${attempt + 1}, waiting ${delayMs}ms): ${error.message}`);
+            }
+            : undefined,
+    };
+}
+/**
+ * Creates a no-op hooks object.
+ * Useful as a default when hooks are optional.
+ */
+export function noopHooks() {
+    return {};
+}
+/**
+ * Internal helper to safely invoke a hook.
+ * Returns silently if the hook throws.
+ */
+export function safeInvoke(hooks, hookName, ...args) {
+    if (!hooks)
+        return;
+    const hook = hooks[hookName];
+    if (!hook)
+        return;
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        hook(...args);
+    }
+    catch (err) {
+        console.error(`Hook ${hookName} error:`, err);
+    }
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Basecamp TypeScript SDK
+ *
+ * Type-safe client for the Basecamp 3 API.
+ *
+ * @example
+ * ```ts
+ * import { createBasecampClient } from "@37signals/basecamp";
+ *
+ * const client = createBasecampClient({
+ *   accountId: "12345",
+ *   accessToken: process.env.BASECAMP_TOKEN!,
+ * });
+ *
+ * // High-level service methods
+ * const projects = await client.projects.list();
+ * const todo = await client.todos.create(projectId, todolistId, {
+ *   content: "Ship the feature",
+ *   assigneeIds: [userId],
+ * });
+ *
+ * // Or use low-level typed API calls
+ * const { data, error } = await client.GET("/projects.json");
+ *
+ * if (data) {
+ *   console.log(data.map(p => p.name));
+ * }
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { createBasecampClient, type BasecampClient, type BasecampClientOptions, type TokenProvider, type RawClient, } from "./client.js";
+export { type AuthStrategy, BearerAuth, bearerAuth } from "./auth-strategy.js";
+export { fetchAllPages, paginateAll } from "./client.js";
+export { ListResult, parseTotalCount, type ListMeta, type PaginationOptions } from "./pagination.js";
+export { parseNextLink, resolveURL, isSameOrigin } from "./pagination-utils.js";
+export { BasecampError, Errors, errorFromResponse, isBasecampError, isErrorCode, type ErrorCode, type BasecampErrorOptions, } from "./errors.js";
+export { chainHooks, consoleHooks, noopHooks, safeInvoke, type BasecampHooks, type OperationInfo, type RequestInfo, type RequestResult, type OperationResult, type ConsoleHooksOptions, } from "./hooks.js";
+export { BaseService, type FetchResponse } from "./services/base.js";
+export { AuthorizationService, type Identity, type AuthorizedAccount, type AuthorizationInfo, type GetAuthorizationInfoOptions, } from "./services/authorization.js";
+export { ProjectsService, type Project, type ListProjectOptions, type CreateProjectRequest, type UpdateProjectRequest, } from "./generated/services/projects.js";
+export { TodosService, type Todo, type ListTodoOptions, type CreateTodoRequest, type UpdateTodoRequest, type RepositionTodoRequest, } from "./generated/services/todos.js";
+export { TodolistsService, type Todolist, type ListTodolistOptions, type CreateTodolistRequest, type UpdateTodolistRequest, } from "./generated/services/todolists.js";
+export { TodosetsService, type Todoset, } from "./generated/services/todosets.js";
+export { PeopleService, type Person, type UpdateProjectAccessPeopleRequest, } from "./generated/services/people.js";
+export { MessagesService, type Message, type CreateMessageRequest, type UpdateMessageRequest, } from "./generated/services/messages.js";
+export { CommentsService, type Comment, type CreateCommentRequest, type UpdateCommentRequest, } from "./generated/services/comments.js";
+export { CampfiresService, type Campfire, type CampfireLine, type Chatbot, type CreateChatbotCampfireRequest, type UpdateChatbotCampfireRequest, type CreateLineCampfireRequest, } from "./generated/services/campfires.js";
+export { CardTablesService, type CardTable, } from "./generated/services/card-tables.js";
+export { CardsService, type Card, type CreateCardRequest, type UpdateCardRequest, type MoveCardRequest, } from "./generated/services/cards.js";
+export { CardColumnsService, type CardColumn, type CreateCardColumnRequest, type UpdateCardColumnRequest, type MoveCardColumnRequest, type SetColorCardColumnRequest, } from "./generated/services/card-columns.js";
+export { CardStepsService, type CardStep, type CreateCardStepRequest, type UpdateCardStepRequest, } from "./generated/services/card-steps.js";
+export { MessageBoardsService, type MessageBoard, } from "./generated/services/message-boards.js";
+export { MessageTypesService, type MessageType, type CreateMessageTypeRequest, type UpdateMessageTypeRequest, } from "./generated/services/message-types.js";
+export { ForwardsService, type Inbox, type Forward, type ForwardReply, type CreateReplyForwardRequest, } from "./generated/services/forwards.js";
+export { CheckinsService, type Questionnaire, type Question, type Answer, type CreateQuestionCheckinRequest, type UpdateQuestionCheckinRequest, type CreateAnswerCheckinRequest, type UpdateAnswerCheckinRequest, type UpdateNotificationSettingsCheckinRequest, } from "./generated/services/checkins.js";
+export { ClientApprovalsService, type ClientApproval, } from "./generated/services/client-approvals.js";
+export { ClientCorrespondencesService, type ClientCorrespondence, } from "./generated/services/client-correspondences.js";
+export { ClientRepliesService, type ClientReply, } from "./generated/services/client-replies.js";
+export { ClientVisibilityService, } from "./generated/services/client-visibility.js";
+export { WebhooksService, type Webhook, type CreateWebhookRequest, type UpdateWebhookRequest, } from "./generated/services/webhooks.js";
+export { WebhookReceiver, WebhookVerificationError, type WebhookEventHandler, type WebhookMiddleware, type WebhookReceiverOptions, type HeaderAccessor, } from "./webhooks/handler.js";
+export { verifyWebhookSignature, signWebhookPayload } from "./webhooks/verify.js";
+export { parseEventKind, WebhookEventKind, type WebhookEvent, type WebhookDelivery, type WebhookDeliveryRequest, type WebhookDeliveryResponse, type WebhookCopy, } from "./webhooks/events.js";
+export { createNodeHandler, type NodeHandlerOptions } from "./webhooks/adapters/node-http.js";
+export { SubscriptionsService, type Subscription, type UpdateSubscriptionRequest, } from "./generated/services/subscriptions.js";
+export { EventsService, type Event, } from "./generated/services/events.js";
+export { AttachmentsService, } from "./generated/services/attachments.js";
+export { VaultsService, type Vault, type CreateVaultRequest, type UpdateVaultRequest, } from "./generated/services/vaults.js";
+export { DocumentsService, type Document, type CreateDocumentRequest, type UpdateDocumentRequest, } from "./generated/services/documents.js";
+export { UploadsService, type Upload, type CreateUploadRequest, type UpdateUploadRequest, } from "./generated/services/uploads.js";
+export { SchedulesService, type Schedule, type ScheduleEntry, type CreateEntryScheduleRequest, type UpdateEntryScheduleRequest, type UpdateSettingsScheduleRequest, type ListEntriesScheduleOptions, } from "./generated/services/schedules.js";
+export { TimesheetsService, type ForRecordingTimesheetOptions, type ForProjectTimesheetOptions, type ReportTimesheetOptions, } from "./generated/services/timesheets.js";
+export { TimelineService, } from "./generated/services/timeline.js";
+export { SearchService, type SearchSearchOptions, } from "./generated/services/search.js";
+export { ReportsService, } from "./generated/services/reports.js";
+export { RecordingsService, type Recording, type ListRecordingOptions, } from "./generated/services/recordings.js";
+export { TemplatesService, type Template, type ListTemplateOptions, type CreateTemplateRequest, type UpdateTemplateRequest, type CreateProjectTemplateRequest, } from "./generated/services/templates.js";
+export { LineupService, type CreateLineupRequest, type UpdateLineupRequest, } from "./generated/services/lineup.js";
+export { TodolistGroupsService, type TodolistGroup, type CreateTodolistGroupRequest, } from "./generated/services/todolist-groups.js";
+export { ToolsService, type Tool, } from "./generated/services/tools.js";
+export { BoostsService, type ListForRecordingBoostOptions, type CreateForRecordingBoostRequest, type ListForEventBoostOptions, type CreateForEventBoostRequest, } from "./generated/services/boosts.js";
+export { otelHooks, type OtelHooksOptions, } from "./hooks/otel.js";
+export type { OAuthConfig, OAuthToken, ExchangeRequest, RefreshRequest, RawTokenResponse, OAuthErrorResponse, } from "./oauth/types.js";
+export { discover, discoverLaunchpad, LAUNCHPAD_BASE_URL, type DiscoverOptions, } from "./oauth/discovery.js";
+export { exchangeCode, refreshToken, isTokenExpired, type TokenOptions, } from "./oauth/exchange.js";
+export { generatePKCE, generateState, type PKCE, } from "./oauth/pkce.js";
+export { redactHeaders, redactHeadersRecord, } from "./security.js";
+export type { paths } from "./generated/schema.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,122 @@
+/**
+ * Basecamp TypeScript SDK
+ *
+ * Type-safe client for the Basecamp 3 API.
+ *
+ * @example
+ * ```ts
+ * import { createBasecampClient } from "@37signals/basecamp";
+ *
+ * const client = createBasecampClient({
+ *   accountId: "12345",
+ *   accessToken: process.env.BASECAMP_TOKEN!,
+ * });
+ *
+ * // High-level service methods
+ * const projects = await client.projects.list();
+ * const todo = await client.todos.create(projectId, todolistId, {
+ *   content: "Ship the feature",
+ *   assigneeIds: [userId],
+ * });
+ *
+ * // Or use low-level typed API calls
+ * const { data, error } = await client.GET("/projects.json");
+ *
+ * if (data) {
+ *   console.log(data.map(p => p.name));
+ * }
+ * ```
+ *
+ * @packageDocumentation
+ */
+// Main client factory
+export { createBasecampClient, } from "./client.js";
+// Authentication strategies
+export { BearerAuth, bearerAuth } from "./auth-strategy.js";
+// Pagination helpers
+export { fetchAllPages, paginateAll } from "./client.js";
+// Pagination types and utilities
+export { ListResult, parseTotalCount } from "./pagination.js";
+export { parseNextLink, resolveURL, isSameOrigin } from "./pagination-utils.js";
+// Errors
+export { BasecampError, Errors, errorFromResponse, isBasecampError, isErrorCode, } from "./errors.js";
+// Hooks
+export { chainHooks, consoleHooks, noopHooks, safeInvoke, } from "./hooks.js";
+// =============================================================================
+// Services - Generated from OpenAPI spec (spec-driven)
+// =============================================================================
+// Base service (for extending) - hand-written infrastructure
+export { BaseService } from "./services/base.js";
+// Authorization service - hand-written (OAuth flows not in OpenAPI spec)
+export { AuthorizationService, } from "./services/authorization.js";
+// Core services - generated
+export { ProjectsService, } from "./generated/services/projects.js";
+export { TodosService, } from "./generated/services/todos.js";
+export { TodolistsService, } from "./generated/services/todolists.js";
+export { TodosetsService, } from "./generated/services/todosets.js";
+export { PeopleService, } from "./generated/services/people.js";
+// Communication services - generated
+export { MessagesService, } from "./generated/services/messages.js";
+export { CommentsService, } from "./generated/services/comments.js";
+export { CampfiresService, } from "./generated/services/campfires.js";
+// Card services (kanban boards) - generated
+export { CardTablesService, } from "./generated/services/card-tables.js";
+export { CardsService, } from "./generated/services/cards.js";
+export { CardColumnsService, } from "./generated/services/card-columns.js";
+export { CardStepsService, } from "./generated/services/card-steps.js";
+// Message services - generated
+export { MessageBoardsService, } from "./generated/services/message-boards.js";
+export { MessageTypesService, } from "./generated/services/message-types.js";
+// Forwards service - generated
+export { ForwardsService, } from "./generated/services/forwards.js";
+// Checkins service - generated
+export { CheckinsService, } from "./generated/services/checkins.js";
+// Client Portal services - generated
+export { ClientApprovalsService, } from "./generated/services/client-approvals.js";
+export { ClientCorrespondencesService, } from "./generated/services/client-correspondences.js";
+export { ClientRepliesService, } from "./generated/services/client-replies.js";
+export { ClientVisibilityService, } from "./generated/services/client-visibility.js";
+// Automation services - generated
+export { WebhooksService, } from "./generated/services/webhooks.js";
+// Webhook Receiving Infrastructure (hand-written, uses generated types)
+export { WebhookReceiver, WebhookVerificationError, } from "./webhooks/handler.js";
+export { verifyWebhookSignature, signWebhookPayload } from "./webhooks/verify.js";
+export { parseEventKind, WebhookEventKind, } from "./webhooks/events.js";
+export { createNodeHandler } from "./webhooks/adapters/node-http.js";
+export { SubscriptionsService, } from "./generated/services/subscriptions.js";
+export { EventsService, } from "./generated/services/events.js";
+// File services - generated
+export { AttachmentsService, } from "./generated/services/attachments.js";
+export { VaultsService, } from "./generated/services/vaults.js";
+export { DocumentsService, } from "./generated/services/documents.js";
+export { UploadsService, } from "./generated/services/uploads.js";
+// Schedule & Time services - generated
+export { SchedulesService, } from "./generated/services/schedules.js";
+export { TimesheetsService, } from "./generated/services/timesheets.js";
+export { TimelineService, } from "./generated/services/timeline.js";
+// Search & Reports services - generated
+export { SearchService, } from "./generated/services/search.js";
+export { ReportsService, } from "./generated/services/reports.js";
+// Recording services - generated
+export { RecordingsService, } from "./generated/services/recordings.js";
+// Templates service - generated
+export { TemplatesService, } from "./generated/services/templates.js";
+// Lineup service - generated
+export { LineupService, } from "./generated/services/lineup.js";
+// Organization services - generated
+export { TodolistGroupsService, } from "./generated/services/todolist-groups.js";
+export { ToolsService, } from "./generated/services/tools.js";
+// Boosts service - generated
+export { BoostsService, } from "./generated/services/boosts.js";
+// OpenTelemetry hooks
+export { otelHooks, } from "./hooks/otel.js";
+// OAuth functions
+export { discover, discoverLaunchpad, LAUNCHPAD_BASE_URL, } from "./oauth/discovery.js";
+export { exchangeCode, refreshToken, isTokenExpired, } from "./oauth/exchange.js";
+// PKCE utilities
+export { generatePKCE, generateState, } from "./oauth/pkce.js";
+// =============================================================================
+// Security Utilities
+// =============================================================================
+export { redactHeaders, redactHeadersRecord, } from "./security.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/oauth/authorize.d.ts

@@ -0,0 +1,48 @@
+/**
+ * OAuth 2.0 authorization URL construction for Basecamp SDK.
+ *
+ * Builds the authorization URL to redirect users to the OAuth provider.
+ */
+import type { PKCE } from "./pkce.js";
+/**
+ * Parameters for building an OAuth authorization URL.
+ */
+export interface AuthorizeParams {
+    /** URL of the authorization endpoint */
+    authorizationEndpoint: string;
+    /** The client identifier */
+    clientId: string;
+    /** The redirect URI for the callback */
+    redirectUri: string;
+    /** CSRF protection state parameter */
+    state: string;
+    /** PKCE parameters (optional) */
+    pkce?: PKCE;
+    /** OAuth scope to request (optional) */
+    scope?: string;
+}
+/**
+ * Builds an OAuth 2.0 authorization URL.
+ *
+ * Constructs a URL with the required OAuth parameters for initiating
+ * the authorization code flow. Validates that the endpoint uses HTTPS
+ * (localhost is allowed for development).
+ *
+ * @param params - Authorization parameters
+ * @returns The complete authorization URL
+ * @throws BasecampError on validation errors (non-HTTPS, invalid URL)
+ *
+ * @example
+ * ```ts
+ * const url = buildAuthorizationUrl({
+ *   authorizationEndpoint: config.authorizationEndpoint,
+ *   clientId: "my_client_id",
+ *   redirectUri: "http://localhost:14923/callback",
+ *   state: generateState(),
+ *   pkce: await generatePKCE(),
+ * });
+ * // Redirect user to url.toString()
+ * ```
+ */
+export declare function buildAuthorizationUrl(params: AuthorizeParams): URL;
+//# sourceMappingURL=authorize.d.ts.map

package/dist/oauth/authorize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authorize.d.ts","sourceRoot":"","sources":["../../src/oauth/authorize.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,GAAG,CA6BlE"}

package/dist/oauth/authorize.js

@@ -0,0 +1,56 @@
+/**
+ * OAuth 2.0 authorization URL construction for Basecamp SDK.
+ *
+ * Builds the authorization URL to redirect users to the OAuth provider.
+ */
+import { BasecampError } from "../errors.js";
+import { isLocalhost } from "../security.js";
+/**
+ * Builds an OAuth 2.0 authorization URL.
+ *
+ * Constructs a URL with the required OAuth parameters for initiating
+ * the authorization code flow. Validates that the endpoint uses HTTPS
+ * (localhost is allowed for development).
+ *
+ * @param params - Authorization parameters
+ * @returns The complete authorization URL
+ * @throws BasecampError on validation errors (non-HTTPS, invalid URL)
+ *
+ * @example
+ * ```ts
+ * const url = buildAuthorizationUrl({
+ *   authorizationEndpoint: config.authorizationEndpoint,
+ *   clientId: "my_client_id",
+ *   redirectUri: "http://localhost:14923/callback",
+ *   state: generateState(),
+ *   pkce: await generatePKCE(),
+ * });
+ * // Redirect user to url.toString()
+ * ```
+ */
+export function buildAuthorizationUrl(params) {
+    const { authorizationEndpoint, clientId, redirectUri, state, pkce, scope } = params;
+    let url;
+    try {
+        url = new URL(authorizationEndpoint);
+    }
+    catch {
+        throw new BasecampError("validation", `Invalid authorization endpoint URL: ${authorizationEndpoint}`);
+    }
+    if (url.protocol !== "https:" && !isLocalhost(url.hostname)) {
+        throw new BasecampError("validation", `Authorization endpoint must use HTTPS: ${authorizationEndpoint}`);
+    }
+    url.searchParams.set("response_type", "code");
+    url.searchParams.set("client_id", clientId);
+    url.searchParams.set("redirect_uri", redirectUri);
+    url.searchParams.set("state", state);
+    if (pkce) {
+        url.searchParams.set("code_challenge", pkce.challenge);
+        url.searchParams.set("code_challenge_method", "S256");
+    }
+    if (scope) {
+        url.searchParams.set("scope", scope);
+    }
+    return url;
+}
+//# sourceMappingURL=authorize.js.map

package/dist/oauth/authorize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authorize.js","sourceRoot":"","sources":["../../src/oauth/authorize.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAqB7C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAuB;IAC3D,MAAM,EAAE,qBAAqB,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;IAEpF,IAAI,GAAQ,CAAC;IACb,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,GAAG,CAAC,qBAAqB,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,aAAa,CAAC,YAAY,EAAE,uCAAuC,qBAAqB,EAAE,CAAC,CAAC;IACxG,CAAC;IAED,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5D,MAAM,IAAI,aAAa,CAAC,YAAY,EAAE,0CAA0C,qBAAqB,EAAE,CAAC,CAAC;IAC3G,CAAC;IAED,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;IAC9C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC5C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;IAClD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAErC,IAAI,IAAI,EAAE,CAAC;QACT,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,gBAAgB,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACvD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,KAAK,EAAE,CAAC;QACV,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/oauth/callback-server.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Local HTTP callback server for OAuth 2.0 authorization code flow.
+ *
+ * Starts a temporary server to receive the authorization callback,
+ * validates the state parameter, and extracts the authorization code.
+ */
+/**
+ * Result from a successful OAuth callback.
+ */
+export interface CallbackResult {
+    /** The authorization code */
+    code: string;
+    /** The state parameter (already validated) */
+    state: string;
+}
+/**
+ * Options for the callback server.
+ */
+export interface CallbackServerOptions {
+    /** Port to listen on (default: 14923) */
+    port?: number;
+    /** Host to bind to (default: "localhost") */
+    host?: string;
+    /** Timeout in milliseconds (default: 120000) */
+    timeoutMs?: number;
+    /** Expected state parameter for CSRF validation */
+    expectedState: string;
+}
+/**
+ * Starts a local HTTP server to receive the OAuth callback.
+ *
+ * The server listens for a single GET /callback request, validates
+ * the state parameter, and extracts the authorization code.
+ * It auto-closes after receiving the callback or on timeout.
+ *
+ * @param options - Server configuration
+ * @returns The callback URL, a promise for the result, and a close function
+ * @throws BasecampError if the port is already in use
+ *
+ * @example
+ * ```ts
+ * const { url, waitForCallback, close } = await startCallbackServer({
+ *   expectedState: myState,
+ * });
+ *
+ * // Use `url` as the redirect_uri in the authorization request
+ * // Then wait for the user to complete the flow:
+ * const { code } = await waitForCallback();
+ * ```
+ */
+export declare function startCallbackServer(options: CallbackServerOptions): Promise<{
+    url: string;
+    waitForCallback: () => Promise<CallbackResult>;
+    close: () => void;
+}>;
+//# sourceMappingURL=callback-server.d.ts.map

package/dist/oauth/callback-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"callback-server.d.ts","sourceRoot":"","sources":["../../src/oauth/callback-server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,aAAa,EAAE,MAAM,CAAC;CACvB;AAgBD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,IAAI,CAAA;CAAE,CAAC,CA8H7F"}