@launchdarkly/mcp-server 0.6.1 → 0.7.0

package/src/models/components/subjectdatarep.ts

@@ -0,0 +1,76 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  Link,
+  Link$inboundSchema,
+  Link$Outbound,
+  Link$outboundSchema,
+} from "./link.js";
+
+export type SubjectDataRep = {
+  links?: { [k: string]: Link } | undefined;
+  /**
+   * The subject's name
+   */
+  name?: string | undefined;
+  /**
+   * The subject's avatar
+   */
+  avatarUrl?: string | undefined;
+};
+
+/** @internal */
+export const SubjectDataRep$inboundSchema: z.ZodType<
+  SubjectDataRep,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  _links: z.record(Link$inboundSchema).optional(),
+  name: z.string().optional(),
+  avatarUrl: z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "_links": "links",
+  });
+});
+/** @internal */
+export type SubjectDataRep$Outbound = {
+  _links?: { [k: string]: Link$Outbound } | undefined;
+  name?: string | undefined;
+  avatarUrl?: string | undefined;
+};
+
+/** @internal */
+export const SubjectDataRep$outboundSchema: z.ZodType<
+  SubjectDataRep$Outbound,
+  z.ZodTypeDef,
+  SubjectDataRep
+> = z.object({
+  links: z.record(Link$outboundSchema).optional(),
+  name: z.string().optional(),
+  avatarUrl: z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    links: "_links",
+  });
+});
+
+export function subjectDataRepToJSON(subjectDataRep: SubjectDataRep): string {
+  return JSON.stringify(SubjectDataRep$outboundSchema.parse(subjectDataRep));
+}
+export function subjectDataRepFromJSON(
+  jsonString: string,
+): SafeParseResult<SubjectDataRep, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => SubjectDataRep$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'SubjectDataRep' from JSON`,
+  );
+}

package/src/models/components/targetresourcerep.ts

@@ -0,0 +1,80 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  Link,
+  Link$inboundSchema,
+  Link$Outbound,
+  Link$outboundSchema,
+} from "./link.js";
+
+export type TargetResourceRep = {
+  links?: { [k: string]: Link } | undefined;
+  /**
+   * The name of the resource
+   */
+  name?: string | undefined;
+  /**
+   * The resource specifier
+   */
+  resources?: Array<string> | undefined;
+};
+
+/** @internal */
+export const TargetResourceRep$inboundSchema: z.ZodType<
+  TargetResourceRep,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  _links: z.record(Link$inboundSchema).optional(),
+  name: z.string().optional(),
+  resources: z.array(z.string()).optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "_links": "links",
+  });
+});
+/** @internal */
+export type TargetResourceRep$Outbound = {
+  _links?: { [k: string]: Link$Outbound } | undefined;
+  name?: string | undefined;
+  resources?: Array<string> | undefined;
+};
+
+/** @internal */
+export const TargetResourceRep$outboundSchema: z.ZodType<
+  TargetResourceRep$Outbound,
+  z.ZodTypeDef,
+  TargetResourceRep
+> = z.object({
+  links: z.record(Link$outboundSchema).optional(),
+  name: z.string().optional(),
+  resources: z.array(z.string()).optional(),
+}).transform((v) => {
+  return remap$(v, {
+    links: "_links",
+  });
+});
+
+export function targetResourceRepToJSON(
+  targetResourceRep: TargetResourceRep,
+): string {
+  return JSON.stringify(
+    TargetResourceRep$outboundSchema.parse(targetResourceRep),
+  );
+}
+export function targetResourceRepFromJSON(
+  jsonString: string,
+): SafeParseResult<TargetResourceRep, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => TargetResourceRep$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'TargetResourceRep' from JSON`,
+  );
+}

package/src/models/components/tokensummary.ts

@@ -0,0 +1,89 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  Link,
+  Link$inboundSchema,
+  Link$Outbound,
+  Link$outboundSchema,
+} from "./link.js";
+
+export type TokenSummary = {
+  links?: { [k: string]: Link } | undefined;
+  id?: string | undefined;
+  /**
+   * The name of the token
+   */
+  name?: string | undefined;
+  /**
+   * The last few characters of the token
+   */
+  ending?: string | undefined;
+  /**
+   * Whether this is a service token
+   */
+  serviceToken?: boolean | undefined;
+};
+
+/** @internal */
+export const TokenSummary$inboundSchema: z.ZodType<
+  TokenSummary,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  _links: z.record(Link$inboundSchema).optional(),
+  _id: z.string().optional(),
+  name: z.string().optional(),
+  ending: z.string().optional(),
+  serviceToken: z.boolean().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "_links": "links",
+    "_id": "id",
+  });
+});
+/** @internal */
+export type TokenSummary$Outbound = {
+  _links?: { [k: string]: Link$Outbound } | undefined;
+  _id?: string | undefined;
+  name?: string | undefined;
+  ending?: string | undefined;
+  serviceToken?: boolean | undefined;
+};
+
+/** @internal */
+export const TokenSummary$outboundSchema: z.ZodType<
+  TokenSummary$Outbound,
+  z.ZodTypeDef,
+  TokenSummary
+> = z.object({
+  links: z.record(Link$outboundSchema).optional(),
+  id: z.string().optional(),
+  name: z.string().optional(),
+  ending: z.string().optional(),
+  serviceToken: z.boolean().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    links: "_links",
+    id: "_id",
+  });
+});
+
+export function tokenSummaryToJSON(tokenSummary: TokenSummary): string {
+  return JSON.stringify(TokenSummary$outboundSchema.parse(tokenSummary));
+}
+export function tokenSummaryFromJSON(
+  jsonString: string,
+): SafeParseResult<TokenSummary, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => TokenSummary$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'TokenSummary' from JSON`,
+  );
+}

package/src/models/operations/getauditlogentries.ts

@@ -0,0 +1,82 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export type GetAuditLogEntriesRequest = {
+  /**
+   * A timestamp filter, expressed as a Unix epoch time in milliseconds.  All entries this returns occurred before the timestamp.
+   */
+  before?: number | undefined;
+  /**
+   * A timestamp filter, expressed as a Unix epoch time in milliseconds. All entries this returns occurred after the timestamp.
+   */
+  after?: number | undefined;
+  /**
+   * Text to search for. You can search for the full or partial name of the resource.
+   */
+  q?: string | undefined;
+  /**
+   * A limit on the number of audit log entries that return. Set between 1 and 20. The default is 10.
+   */
+  limit?: number | undefined;
+  /**
+   * A resource specifier that lets you filter audit log listings by resource
+   */
+  spec?: string | undefined;
+};
+
+/** @internal */
+export const GetAuditLogEntriesRequest$inboundSchema: z.ZodType<
+  GetAuditLogEntriesRequest,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  before: z.number().int().optional(),
+  after: z.number().int().optional(),
+  q: z.string().optional(),
+  limit: z.number().int().optional(),
+  spec: z.string().optional(),
+});
+/** @internal */
+export type GetAuditLogEntriesRequest$Outbound = {
+  before?: number | undefined;
+  after?: number | undefined;
+  q?: string | undefined;
+  limit?: number | undefined;
+  spec?: string | undefined;
+};
+
+/** @internal */
+export const GetAuditLogEntriesRequest$outboundSchema: z.ZodType<
+  GetAuditLogEntriesRequest$Outbound,
+  z.ZodTypeDef,
+  GetAuditLogEntriesRequest
+> = z.object({
+  before: z.number().int().optional(),
+  after: z.number().int().optional(),
+  q: z.string().optional(),
+  limit: z.number().int().optional(),
+  spec: z.string().optional(),
+});
+
+export function getAuditLogEntriesRequestToJSON(
+  getAuditLogEntriesRequest: GetAuditLogEntriesRequest,
+): string {
+  return JSON.stringify(
+    GetAuditLogEntriesRequest$outboundSchema.parse(getAuditLogEntriesRequest),
+  );
+}
+export function getAuditLogEntriesRequestFromJSON(
+  jsonString: string,
+): SafeParseResult<GetAuditLogEntriesRequest, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GetAuditLogEntriesRequest$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetAuditLogEntriesRequest' from JSON`,
+  );
+}

package/src/models/operations/index.ts

@@ -9,6 +9,7 @@ export * from "./getaiconfig.js";
 export * from "./getaiconfigs.js";
 export * from "./getaiconfigtargeting.js";
 export * from "./getaiconfigvariation.js";
+export * from "./getauditlogentries.js";
 export * from "./getenvironmentsbyproject.js";
 export * from "./getfeatureflag.js";
 export * from "./getfeatureflags.js";

package/src/sdk/auditlog.ts

@@ -0,0 +1,30 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { auditLogListEntries } from "../funcs/auditLogListEntries.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as components from "../models/components/index.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class AuditLog extends ClientSDK {
+  /**
+   * List audit log entries
+   *
+   * @remarks
+   * Get a list of all audit log entries. The query parameters let you restrict the results that return by date ranges, resource specifiers, or a full-text search query.
+   *
+   * LaunchDarkly uses a resource specifier syntax to name resources or collections of resources. To learn more, read [About the resource specifier syntax](https://launchdarkly.com/docs/home/account/role-resources#about-the-resource-specifier-syntax).
+   */
+  async listEntries(
+    request: operations.GetAuditLogEntriesRequest,
+    options?: RequestOptions,
+  ): Promise<components.AuditLogEntryListingRepCollection> {
+    return unwrapAsync(auditLogListEntries(
+      this,
+      request,
+      options,
+    ));
+  }
+}

package/src/sdk/sdk.ts

@@ -4,11 +4,17 @@
 
 import { ClientSDK } from "../lib/sdks.js";
 import { AiConfigs } from "./aiconfigs.js";
+import { AuditLog } from "./auditlog.js";
 import { CodeReferences } from "./codereferences.js";
 import { Environments } from "./environments.js";
 import { FeatureFlags } from "./featureflags.js";
 
 export class LaunchDarkly extends ClientSDK {
+  private _auditLog?: AuditLog;
+  get auditLog(): AuditLog {
+    return (this._auditLog ??= new AuditLog(this._options));
+  }
+
   private _codeReferences?: CodeReferences;
   get codeReferences(): CodeReferences {
     return (this._codeReferences ??= new CodeReferences(this._options));

package/test/sse-security.test.mjs

@@ -0,0 +1,84 @@
+import assert from "node:assert/strict";
+import process from "node:process";
+import { after, before, describe, test } from "node:test";
+import express from "express";
+import { main } from "../dist/esm/mcp-server/cli/start/impl.js";
+import {
+  assertSafeSSEBind,
+  requireBearerToken,
+} from "../dist/esm/mcp-server/cli/start/sse-security.js";
+
+const TOKEN = "0123456789abcdef";
+
+describe("assertSafeSSEBind", () => {
+  for (const host of ["0.0.0.0", "::", "192.168.1.10", "example.com"]) {
+    test(`refuses ${host} without a token`, () => {
+      assert.throws(
+        () => assertSafeSSEBind(host, undefined),
+        /--auth-token is required/,
+      );
+    });
+
+    test(`allows ${host} with a token`, () => {
+      assert.doesNotThrow(() => assertSafeSSEBind(host, TOKEN));
+    });
+  }
+
+  for (const host of ["127.0.0.1", "localhost", "::1"]) {
+    test(`allows loopback ${host} without a token`, () => {
+      assert.doesNotThrow(() => assertSafeSSEBind(host, undefined));
+    });
+  }
+});
+
+test("start --transport sse refuses a non-loopback host without a token", async () => {
+  await assert.rejects(
+    main.call({ process }, {
+      transport: "sse",
+      host: "0.0.0.0",
+      port: 0,
+      "log-level": "error",
+    }),
+    /--auth-token is required/,
+  );
+});
+
+describe("requireBearerToken", () => {
+  let server;
+  let url;
+
+  before(async () => {
+    const app = express();
+    app.use(requireBearerToken(TOKEN));
+    app.get("/", (_req, res) => res.send("ok"));
+    await new Promise((resolve) => {
+      server = app.listen(0, "127.0.0.1", resolve);
+    });
+    url = `http://127.0.0.1:${server.address().port}/`;
+  });
+
+  after(() => new Promise((resolve) => server.close(resolve)));
+
+  const cases = [
+    ["a missing header", undefined],
+    ["a wrong token of the same length", "Bearer fedcba9876543210"],
+    ["a token prefix", `Bearer ${TOKEN.slice(0, -1)}`],
+    ["the token without the Bearer scheme", TOKEN],
+  ];
+  for (const [name, header] of cases) {
+    test(`returns 401 for ${name}`, async () => {
+      const res = await fetch(url, {
+        headers: header === undefined ? {} : { Authorization: header },
+      });
+      assert.equal(res.status, 401);
+    });
+  }
+
+  test("passes the request through for the right token", async () => {
+    const res = await fetch(url, {
+      headers: { Authorization: `Bearer ${TOKEN}` },
+    });
+    assert.equal(res.status, 200);
+    assert.equal(await res.text(), "ok");
+  });
+});