@superblocksteam/sdk-api 0.0.6 → 0.0.8

package/dist/integrations/slack/client.test.js

@@ -0,0 +1,368 @@
+/**
+ * Tests for SlackClientImpl.
+ *
+ * Validates the SlackResponse<T> discriminated union contract:
+ * - ok:false from Slack → SlackErrorResponse (no throw)
+ * - ok:true from Slack  → Zod-validated success data
+ * - ok:true but schema mismatch → RestApiValidationError (thrown)
+ * - Body validation failures still throw RestApiValidationError
+ */
+import { describe, it, expect, vi } from "vitest";
+import { z } from "zod";
+import { RestApiValidationError } from "../../errors.js";
+import { SlackClientImpl } from "./client.js";
+const TEST_CONFIG = {
+    id: "slack-test-id",
+    name: "Test Slack",
+    pluginId: "slack",
+    configuration: {},
+};
+function createClient(mockResult) {
+    const executeQuery = vi.fn().mockResolvedValue(mockResult);
+    const client = new SlackClientImpl(TEST_CONFIG, executeQuery);
+    return { client, executeQuery };
+}
+const ChannelsSchema = z.object({
+    channels: z.array(z.object({ id: z.string(), name: z.string() })),
+});
+const PostMessageSchema = z.object({
+    channel: z.string(),
+    ts: z.string(),
+});
+describe("SlackClientImpl", () => {
+    // ── Success responses ──────────────────────────────────────────
+    describe("success responses (ok: true)", () => {
+        it("returns validated data with ok: true", async () => {
+            const { client } = createClient({
+                ok: true,
+                channels: [{ id: "C123", name: "general" }],
+            });
+            const result = await client.apiRequest({ method: "GET", path: "/conversations.list" }, { response: ChannelsSchema });
+            expect(result.ok).toBe(true);
+            if (result.ok) {
+                expect(result.channels).toHaveLength(1);
+                expect(result.channels[0]).toEqual({ id: "C123", name: "general" });
+            }
+        });
+        it("strips unknown keys via Zod strip mode", async () => {
+            const { client } = createClient({
+                ok: true,
+                channels: [{ id: "C1", name: "test", extra: true }],
+                response_metadata: { next_cursor: "" },
+            });
+            const result = await client.apiRequest({ method: "GET", path: "/conversations.list" }, { response: ChannelsSchema });
+            expect(result.ok).toBe(true);
+            if (result.ok) {
+                expect(result).not.toHaveProperty("response_metadata");
+                expect(result.channels[0]).not.toHaveProperty("extra");
+            }
+        });
+        it("validates a post message success response", async () => {
+            const { client } = createClient({
+                ok: true,
+                channel: "C123",
+                ts: "1234567890.123456",
+            });
+            const result = await client.apiRequest({
+                method: "POST",
+                path: "/chat.postMessage",
+                body: { channel: "C123", text: "hello" },
+            }, { response: PostMessageSchema });
+            expect(result.ok).toBe(true);
+            if (result.ok) {
+                expect(result.ts).toBe("1234567890.123456");
+                expect(result.channel).toBe("C123");
+            }
+        });
+    });
+    // ── Error responses (ok: false) ────────────────────────────────
+    describe("error responses (ok: false)", () => {
+        it("returns SlackErrorResponse instead of throwing", async () => {
+            const { client } = createClient({
+                ok: false,
+                error: "channel_not_found",
+            });
+            const result = await client.apiRequest({
+                method: "POST",
+                path: "/chat.postMessage",
+                body: { channel: "C000", text: "hi" },
+            }, { response: PostMessageSchema });
+            expect(result.ok).toBe(false);
+            if (!result.ok) {
+                expect(result.error).toBe("channel_not_found");
+            }
+        });
+        it("includes needed scopes on missing_scope errors", async () => {
+            const { client } = createClient({
+                ok: false,
+                error: "missing_scope",
+                needed: "channels:read",
+                provided: "identify,bot",
+            });
+            const result = await client.apiRequest({ method: "GET", path: "/conversations.list" }, { response: ChannelsSchema });
+            expect(result.ok).toBe(false);
+            if (!result.ok) {
+                expect(result.error).toBe("missing_scope");
+                expect(result.needed).toBe("channels:read");
+                expect(result.provided).toBe("identify,bot");
+            }
+        });
+        it("throws when ok: false but no error string (invalid Slack error)", async () => {
+            const { client } = createClient({ ok: false });
+            // { ok: false } without an error string doesn't match SlackErrorSchema,
+            // and also doesn't match the success schema → RestApiValidationError.
+            await expect(client.apiRequest({ method: "GET", path: "/conversations.list" }, { response: ChannelsSchema })).rejects.toThrow(RestApiValidationError);
+        });
+        it.each(["not_authed", "invalid_auth", "ratelimited"])("handles %s error", async (errorCode) => {
+            const { client } = createClient({ ok: false, error: errorCode });
+            const result = await client.apiRequest({ method: "GET", path: "/auth.test" }, { response: z.object({}) });
+            expect(result.ok).toBe(false);
+            if (!result.ok) {
+                expect(result.error).toBe(errorCode);
+            }
+        });
+        it("omits needed/provided when not present in Slack response", async () => {
+            const { client } = createClient({
+                ok: false,
+                error: "channel_not_found",
+            });
+            const result = await client.apiRequest({ method: "POST", path: "/chat.postMessage" }, { response: PostMessageSchema });
+            expect(result.ok).toBe(false);
+            if (!result.ok) {
+                expect(result).not.toHaveProperty("needed");
+                expect(result).not.toHaveProperty("provided");
+            }
+        });
+        it("throws when needed/provided are non-string (invalid Slack error)", async () => {
+            const { client } = createClient({
+                ok: false,
+                error: "missing_scope",
+                needed: 123,
+                provided: true,
+            });
+            // Zod rejects non-string needed/provided. Since raw response has ok:false,
+            // SlackClient rejects it before success payload validation.
+            await expect(client.apiRequest({ method: "GET", path: "/conversations.list" }, { response: ChannelsSchema })).rejects.toThrow(RestApiValidationError);
+        });
+    });
+    // ── Validation errors (still thrown) ───────────────────────────
+    describe("validation errors", () => {
+        it("throws RestApiValidationError when ok:true but schema does not match", async () => {
+            // Slack says ok:true but response is missing required fields
+            const { client } = createClient({
+                ok: true,
+                // Missing 'channels' field
+            });
+            await expect(client.apiRequest({ method: "GET", path: "/conversations.list" }, { response: ChannelsSchema })).rejects.toThrow(RestApiValidationError);
+        });
+        it("includes raw data and Zod error in validation error details", async () => {
+            const badResponse = { ok: true };
+            const { client } = createClient(badResponse);
+            try {
+                await client.apiRequest({ method: "GET", path: "/conversations.list" }, { response: ChannelsSchema });
+                expect.fail("Expected RestApiValidationError");
+            }
+            catch (e) {
+                expect(e).toBeInstanceOf(RestApiValidationError);
+                const err = e;
+                expect(err.details.data).toEqual(badResponse);
+                expect(err.details.zodError).toBeDefined();
+            }
+        });
+        it("throws RestApiValidationError when request body fails validation", async () => {
+            const { client } = createClient({ ok: true });
+            const BodySchema = z.object({
+                channel: z.string(),
+                text: z.string(),
+            });
+            await expect(client.apiRequest({
+                method: "POST",
+                path: "/chat.postMessage",
+                body: { channel: 123, text: "hello" },
+            }, { body: BodySchema, response: PostMessageSchema })).rejects.toThrow(RestApiValidationError);
+        });
+    });
+    // ── Request building ───────────────────────────────────────────
+    describe("request building", () => {
+        it("sends correct proto structure to executeQuery", async () => {
+            const { client, executeQuery } = createClient({
+                ok: true,
+                channel: "C123",
+                ts: "1234567890.123456",
+            });
+            await client.apiRequest({
+                method: "POST",
+                path: "/chat.postMessage",
+                body: { channel: "#general", text: "hello" },
+                headers: { "X-Custom": "value" },
+                params: { unfurl_links: false },
+            }, { response: PostMessageSchema });
+            expect(executeQuery).toHaveBeenCalledOnce();
+            const request = executeQuery.mock.calls[0][0];
+            expect(request.openApiAction).toBe("genericHttpRequest");
+            expect(request.httpMethod).toBe("POST");
+            expect(request.urlPath).toBe("/chat.postMessage");
+            expect(request.responseType).toBe("json");
+            expect(request.body).toBe(JSON.stringify({ channel: "#general", text: "hello" }));
+            expect(request.bodyType).toBe("jsonBody");
+            expect(request.headers).toEqual([{ key: "X-Custom", value: "value" }]);
+            expect(request.params).toEqual([{ key: "unfurl_links", value: "false" }]);
+        });
+        it("passes trace metadata to executeQuery", async () => {
+            const { client, executeQuery } = createClient({
+                ok: true,
+                channel: "C1",
+                ts: "1.1",
+            });
+            await client.apiRequest({ method: "POST", path: "/chat.postMessage" }, { response: PostMessageSchema }, { label: "slack.postMessage", description: "Post a message" });
+            expect(executeQuery).toHaveBeenCalledWith(expect.any(Object), undefined, {
+                label: "slack.postMessage",
+                description: "Post a message",
+            });
+        });
+        it("propagates executeQuery rejections as transport errors", async () => {
+            const executeQuery = vi
+                .fn()
+                .mockRejectedValue(new Error("network timeout"));
+            const client = new SlackClientImpl(TEST_CONFIG, executeQuery);
+            await expect(client.apiRequest({ method: "GET", path: "/auth.test" }, { response: z.object({}) })).rejects.toThrow("network timeout");
+        });
+    });
+    // ── Edge cases ─────────────────────────────────────────────────
+    describe("edge cases", () => {
+        it("falls through to schema validation when response has no ok field", async () => {
+            const { client } = createClient({ data: [1, 2, 3] });
+            // No ok field → not Slack error, and missing success envelope.
+            await expect(client.apiRequest({ method: "GET", path: "/some.endpoint" }, { response: ChannelsSchema })).rejects.toThrow(RestApiValidationError);
+        });
+        it("falls through to schema validation when ok is not a boolean", async () => {
+            const { client } = createClient({ ok: "false", error: "nope" });
+            // ok is a string, so it is neither a valid Slack error envelope
+            // nor a valid success envelope.
+            await expect(client.apiRequest({ method: "GET", path: "/some.endpoint" }, { response: ChannelsSchema })).rejects.toThrow(RestApiValidationError);
+        });
+        it("handles response surviving JSON round-trip (protobuf simulation)", async () => {
+            const original = {
+                ok: true,
+                channels: [{ id: "C123", name: "general" }],
+                nested: { count: 42 },
+            };
+            const roundTripped = JSON.parse(JSON.stringify(original));
+            const { client } = createClient(roundTripped);
+            const result = await client.apiRequest({ method: "GET", path: "/conversations.list" }, { response: ChannelsSchema });
+            expect(result.ok).toBe(true);
+            if (result.ok) {
+                expect(result.channels[0].id).toBe("C123");
+            }
+        });
+        it("injects ok: true when schema omits the ok field", async () => {
+            const NoOkSchema = z.object({
+                channels: z.array(z.object({ id: z.string(), name: z.string() })),
+            });
+            const { client } = createClient({
+                ok: true,
+                channels: [{ id: "C1", name: "test" }],
+            });
+            const result = await client.apiRequest({ method: "GET", path: "/conversations.list" }, { response: NoOkSchema });
+            expect(result.ok).toBe(true);
+            if (result.ok) {
+                expect(result.channels).toHaveLength(1);
+            }
+        });
+        it("validates payload schema after removing envelope field for strict schemas", async () => {
+            const StrictSchema = z
+                .object({
+                channels: z.array(z.object({ id: z.string(), name: z.string() })),
+            })
+                .strict();
+            const { client } = createClient({
+                ok: true,
+                channels: [{ id: "C1", name: "test" }],
+            });
+            const result = await client.apiRequest({ method: "GET", path: "/conversations.list" }, { response: StrictSchema });
+            expect(result.ok).toBe(true);
+            if (result.ok) {
+                expect(result.channels).toHaveLength(1);
+            }
+        });
+        it("supports passthrough schemas and still enforces literal ok discriminant", async () => {
+            const PassthroughSchema = z
+                .object({
+                channels: z.array(z.object({ id: z.string(), name: z.string() })),
+            })
+                .passthrough();
+            const { client } = createClient({
+                ok: true,
+                channels: [{ id: "C1", name: "test" }],
+                response_metadata: { next_cursor: "abc" },
+            });
+            const result = await client.apiRequest({ method: "GET", path: "/conversations.list" }, { response: PassthroughSchema });
+            expect(result.ok).toBe(true);
+            if (result.ok) {
+                expect(result.channels).toHaveLength(1);
+                expect(result).toHaveProperty("response_metadata");
+            }
+        });
+        it("throws when ok:false and loose payload schema would otherwise accept", async () => {
+            const LooseSchema = z.object({});
+            const { client } = createClient({ ok: false });
+            await expect(client.apiRequest({ method: "GET", path: "/auth.test" }, { response: LooseSchema })).rejects.toThrow(RestApiValidationError);
+        });
+        it("routes to error branch when response matches both schemas", async () => {
+            // Response matches SlackErrorSchema AND a loose success schema.
+            // Error branch must win because it's checked first.
+            const FlexibleSchema = z.object({
+                error: z.string().optional(),
+            });
+            const { client } = createClient({
+                ok: false,
+                error: "channel_not_found",
+            });
+            const result = await client.apiRequest({ method: "POST", path: "/chat.postMessage" }, { response: FlexibleSchema });
+            expect(result.ok).toBe(false);
+            if (!result.ok) {
+                expect(result.error).toBe("channel_not_found");
+            }
+        });
+        it("does not treat ok: 0 as a Slack error (only strict false)", async () => {
+            // ok: 0 is not === false, so it is NOT detected as a Slack error.
+            // It fails success envelope validation because ok must be literal true.
+            const { client } = createClient({
+                ok: 0,
+                channels: [{ id: "C1", name: "test" }],
+            });
+            await expect(client.apiRequest({ method: "GET", path: "/conversations.list" }, { response: ChannelsSchema })).rejects.toThrow(RestApiValidationError);
+        });
+    });
+    // ── Type narrowing (compile-time verification) ─────────────────
+    describe("type narrowing", () => {
+        it("narrows to error response fields when ok is false", async () => {
+            const { client } = createClient({
+                ok: false,
+                error: "missing_scope",
+                needed: "channels:read",
+            });
+            const result = await client.apiRequest({ method: "GET", path: "/conversations.list" }, { response: ChannelsSchema });
+            // This block exercises the SlackErrorResponse branch
+            if (!result.ok) {
+                const errorResult = result;
+                expect(errorResult.error).toBe("missing_scope");
+                expect(errorResult.needed).toBe("channels:read");
+            }
+        });
+        it("narrows to success response fields when ok is true", async () => {
+            const { client } = createClient({
+                ok: true,
+                channels: [{ id: "C1", name: "general" }],
+            });
+            const result = await client.apiRequest({ method: "GET", path: "/conversations.list" }, { response: ChannelsSchema });
+            // This block exercises the T & { ok: true } branch
+            if (result.ok) {
+                // TypeScript narrows: result.channels is accessible
+                expect(result.channels).toHaveLength(1);
+                expect(result.channels[0].name).toBe("general");
+            }
+        });
+    });
+});
+//# sourceMappingURL=client.test.js.map

package/dist/integrations/slack/client.test.js.map

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

package/dist/integrations/slack/index.d.ts

@@ -1,6 +1,7 @@
 /**
  * Slack integration module.
  */
-export type { SlackClient } from "./types.js";
+export type { SlackClient, SlackResponse, SlackErrorResponse, } from "./types.js";
+export { SlackErrorSchema } from "./types.js";
 export { SlackClientImpl } from "./client.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/integrations/slack/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/integrations/slack/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/integrations/slack/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACV,WAAW,EACX,aAAa,EACb,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/integrations/slack/index.js

@@ -1,5 +1,6 @@
 /**
  * Slack integration module.
  */
+export { SlackErrorSchema } from "./types.js";
 export { SlackClientImpl } from "./client.js";
 //# sourceMappingURL=index.js.map

package/dist/integrations/slack/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/integrations/slack/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/integrations/slack/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/integrations/slack/types.d.ts

@@ -1,48 +1,147 @@
 /**
  * Slack client types.
+ *
+ * Defines the SlackResponse<T> discriminated union that wraps every
+ * Slack API call, plus the SlackClient interface consumers interact with.
  */
+import { z } from "zod";
 import type { BaseIntegrationClient } from "../../types.js";
-import type { SupportsApiRequest } from "../base/index.js";
+import type { ApiRequestOptions, TraceMetadata } from "../base/types.js";
 /**
- * Slack client for API interactions.
+ * Zod schema for Slack API error responses.
+ *
+ * Slack returns errors as HTTP 200 with `{ ok: false, error: "..." }`.
+ * For `missing_scope` errors, `needed` and `provided` list the
+ * required vs current OAuth scopes.
+ */
+export declare const SlackErrorSchema: z.ZodObject<{
+    ok: z.ZodLiteral<false>;
+    error: z.ZodString;
+    needed: z.ZodOptional<z.ZodString>;
+    provided: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    ok: false;
+    error: string;
+    needed?: string | undefined;
+    provided?: string | undefined;
+}, {
+    ok: false;
+    error: string;
+    needed?: string | undefined;
+    provided?: string | undefined;
+}>;
+/** Slack API error response, derived from {@link SlackErrorSchema}. */
+export type SlackErrorResponse = z.infer<typeof SlackErrorSchema>;
+/**
+ * Zod schema for Slack success envelopes.
+ *
+ * Success responses from Slack include `{ ok: true, ...payload }`.
+ * Callers provide schemas for the payload fields only; the SDK validates
+ * this envelope separately and injects `ok: true` in the returned type.
+ */
+export declare const SlackSuccessEnvelopeSchema: z.ZodObject<{
+    ok: z.ZodLiteral<true>;
+}, "strip", z.ZodTypeAny, {
+    ok: true;
+}, {
+    ok: true;
+}>;
+/**
+ * Enforce that caller-provided success schemas do not define `ok`.
+ *
+ * The `ok` field belongs to the Slack envelope and is injected by the SDK.
+ */
+type SlackSuccessSchemaHasExplicitOkKey<TSchema extends z.AnyZodObject> = TSchema extends z.ZodObject<infer TShape, z.UnknownKeysParam, z.ZodTypeAny, unknown, unknown> ? "ok" extends keyof TShape ? true : false : false;
+type SlackSuccessSchema<TSchema extends z.AnyZodObject> = SlackSuccessSchemaHasExplicitOkKey<TSchema> extends true ? never : TSchema;
+/**
+ * Schema configuration for Slack API requests.
+ *
+ * Response schema must be an object payload schema (without `ok`).
+ */
+export interface SlackApiRequestSchema<TBody, TResponseSchema extends z.AnyZodObject> {
+    body?: z.ZodSchema<TBody>;
+    response: SlackSuccessSchema<TResponseSchema>;
+}
+/** Slack success response shape with injected discriminant. */
+type SlackSuccessResponse<T extends Record<string, unknown>> = T & {
+    readonly ok: true;
+};
+/**
+ * Discriminated union of a Slack success response and error response.
  *
- * Provides generic API request method for interacting with Slack's API.
- * Use apiRequest() to make calls to any Slack API endpoint.
+ * On success (`ok: true`), the type is `T & { ok: true }` — the
+ * validated schema output intersected with a literal `true` discriminant.
+ * On failure (`ok: false`), the type is {@link SlackErrorResponse}.
+ *
+ * Use the `ok` field as a discriminant for type narrowing:
  *
  * @example
  * ```typescript
- * // Declare in api(): integrations: { slack: slack(INTEGRATION_ID) }
- * // In run(), access via: ctx.integrations.slack
- * await ctx.integrations.slack.apiRequest(
- *   {
- *     method: 'POST',
- *     path: '/chat.postMessage',
- *     body: {
- *       channel: '#alerts',
- *       text: 'Deployment completed!',
- *     },
- *   },
- *   { response: PostMessageResponseSchema }
+ * const result = await ctx.integrations.slack.apiRequest(
+ *   { method: "GET", path: "/conversations.list", params: { limit: 100 } },
+ *   { response: ListChannelsSchema },
  * );
  *
- * // List channels
- * const ListChannelsResponseSchema = z.object({
- *   channels: z.array(z.object({
- *     id: z.string(),
- *     name: z.string(),
- *   })),
- * });
+ * if (!result.ok) {
+ *   // TypeScript narrows to SlackErrorResponse
+ *   console.error(`Slack error: ${result.error}`);
+ *   return;
+ * }
  *
+ * // TypeScript narrows to T & { ok: true }
+ * result.channels.forEach(ch => console.log(ch.name));
+ * ```
+ */
+export type SlackResponse<T extends Record<string, unknown>> = SlackSuccessResponse<T> | SlackErrorResponse;
+/**
+ * Slack client for API interactions.
+ *
+ * Returns {@link SlackResponse}<T> from `apiRequest` — a discriminated
+ * union that encapsulates both Slack success and error responses. This
+ * avoids confusing Zod validation errors when Slack returns `ok: false`
+ * (which is an HTTP 200 with no success-specific fields).
+ *
+ * Note: SlackClient intentionally does not extend `SupportsApiRequest`.
+ * `SupportsApiRequest.apiRequest` returns `Promise<TResponse>`, while
+ * Slack returns `Promise<SlackResponse<T>>` by design.
+ *
+ * @example
+ * ```typescript
  * const result = await ctx.integrations.slack.apiRequest(
  *   {
- *     method: 'GET',
- *     path: '/conversations.list',
- *     params: { limit: 100 },
+ *     method: "POST",
+ *     path: "/chat.postMessage",
+ *     body: { channel: "#alerts", text: "Deployed!" },
  *   },
- *   { response: ListChannelsResponseSchema }
+ *   { response: PostMessageResponseSchema },
  * );
+ *
+ * if (!result.ok) {
+ *   throw new Error(`Slack API error: ${result.error}`);
+ * }
+ *
+ * console.log(`Message sent: ${result.ts}`);
  * ```
  */
-export interface SlackClient extends BaseIntegrationClient, SupportsApiRequest {
+export interface SlackClient extends BaseIntegrationClient {
+    /**
+     * Execute a Slack API request with type-safe response handling.
+     *
+     * Returns a {@link SlackResponse}<TResponse> discriminated union:
+     * - On success: the Zod-validated payload with injected `ok: true`
+     * - On failure: a {@link SlackErrorResponse} with `ok: false` and the Slack error code
+     *
+     * Body validation still throws {@link RestApiValidationError} if the
+     * request body fails its Zod schema.
+     *
+     * @param options - Request configuration (method, path, params, body, headers)
+     * @param schema - Zod schemas for body and response validation (response REQUIRED)
+     *   - `response` must be `z.object(...)`
+     *   - `response` should define payload fields only (MUST NOT define `ok`)
+     * @param metadata - Optional trace metadata for observability
+     * @returns Discriminated union — check `result.ok` before accessing fields
+     */
+    apiRequest<TBody, TResponseSchema extends z.AnyZodObject>(options: ApiRequestOptions<TBody>, schema: SlackApiRequestSchema<TBody, TResponseSchema>, metadata?: TraceMetadata): Promise<SlackResponse<z.output<TResponseSchema>>>;
 }
+export {};
 //# sourceMappingURL=types.d.ts.map

package/dist/integrations/slack/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/integrations/slack/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,WAAW,WAAY,SAAQ,qBAAqB,EAAE,kBAAkB;CAE7E"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/integrations/slack/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEzE;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;EAK3B,CAAC;AAEH,uEAAuE;AACvE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAElE;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B;;;;;;EAErC,CAAC;AAEH;;;;GAIG;AACH,KAAK,kCAAkC,CAAC,OAAO,SAAS,CAAC,CAAC,YAAY,IACpE,OAAO,SAAS,CAAC,CAAC,SAAS,CACzB,MAAM,MAAM,EACZ,CAAC,CAAC,gBAAgB,EAClB,CAAC,CAAC,UAAU,EACZ,OAAO,EACP,OAAO,CACR,GACG,IAAI,SAAS,MAAM,MAAM,GACvB,IAAI,GACJ,KAAK,GACP,KAAK,CAAC;AAEZ,KAAK,kBAAkB,CAAC,OAAO,SAAS,CAAC,CAAC,YAAY,IACpD,kCAAkC,CAAC,OAAO,CAAC,SAAS,IAAI,GAAG,KAAK,GAAG,OAAO,CAAC;AAE7E;;;;GAIG;AACH,MAAM,WAAW,qBAAqB,CACpC,KAAK,EACL,eAAe,SAAS,CAAC,CAAC,YAAY;IAEtC,IAAI,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC1B,QAAQ,EAAE,kBAAkB,CAAC,eAAe,CAAC,CAAC;CAC/C;AAED,+DAA+D;AAC/D,KAAK,oBAAoB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG;IACjE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;CACnB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IACvD,oBAAoB,CAAC,CAAC,CAAC,GACvB,kBAAkB,CAAC;AAEvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,WAAW,WAAY,SAAQ,qBAAqB;IACxD;;;;;;;;;;;;;;;;OAgBG;IACH,UAAU,CAAC,KAAK,EAAE,eAAe,SAAS,CAAC,CAAC,YAAY,EACtD,OAAO,EAAE,iBAAiB,CAAC,KAAK,CAAC,EACjC,MAAM,EAAE,qBAAqB,CAAC,KAAK,EAAE,eAAe,CAAC,EACrD,QAAQ,CAAC,EAAE,aAAa,GACvB,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;CACtD"}

package/dist/integrations/slack/types.js

@@ -1,5 +1,31 @@
 /**
  * Slack client types.
+ *
+ * Defines the SlackResponse<T> discriminated union that wraps every
+ * Slack API call, plus the SlackClient interface consumers interact with.
  */
-export {};
+import { z } from "zod";
+/**
+ * Zod schema for Slack API error responses.
+ *
+ * Slack returns errors as HTTP 200 with `{ ok: false, error: "..." }`.
+ * For `missing_scope` errors, `needed` and `provided` list the
+ * required vs current OAuth scopes.
+ */
+export const SlackErrorSchema = z.object({
+    ok: z.literal(false),
+    error: z.string(),
+    needed: z.string().optional(),
+    provided: z.string().optional(),
+});
+/**
+ * Zod schema for Slack success envelopes.
+ *
+ * Success responses from Slack include `{ ok: true, ...payload }`.
+ * Callers provide schemas for the payload fields only; the SDK validates
+ * this envelope separately and injects `ok: true` in the returned type.
+ */
+export const SlackSuccessEnvelopeSchema = z.object({
+    ok: z.literal(true),
+});
 //# sourceMappingURL=types.js.map

package/dist/integrations/slack/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/integrations/slack/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/integrations/slack/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACpB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC,CAAC;AAKH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;CACpB,CAAC,CAAC"}