@stripe/extensibility-language-server 0.2.8

package/LICENSE.md

@@ -0,0 +1,19 @@
+Copyright (C) 2026 Stripe, Inc. (https://stripe.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/dist/extensibility-language-server-alpha.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Extensibility Language Server
+ *
+ * Provides a tsserver plugin and standalone LSP language server for the
+ * Stripe extensibility SDK, built on formspec building blocks.
+ *
+ * Consumers should import from subpath exports:
+ * - `extensibility-language-server/plugin` — tsserver plugin
+ * - `extensibility-language-server/server` — LSP language server
+ *
+ * @packageDocumentation
+ */
+
+import type { Connection } from 'vscode-languageserver/node.js';
+import { CreateServerOptions as CreateServerOptions_2 } from '@formspec/language-server';
+import type * as tsServer from 'typescript/lib/tsserverlibrary.js';
+
+/**
+ * Creates and configures the Extensibility language server connection.
+ *
+ * The current implementation delegates to FormSpec's packaged server and keeps
+ * a local wrapper so Extensibility-specific handlers can be interleaved later
+ * without changing this package's public API.
+ *
+ * @public
+ */
+export declare function createServer(options?: CreateServerOptions): Connection;
+
+/**
+ * Public configuration for constructing the Extensibility language server.
+ *
+ * This currently matches FormSpec's server options, while preserving an SDK-owned
+ * wrapper seam where Extensibility-specific LSP behavior can be layered in.
+ *
+ * @public
+ */
+export declare type CreateServerOptions = CreateServerOptions_2;
+
+/**
+ * Initializes the Extensibility TypeScript language service plugin.
+ *
+ * @public
+ */
+export declare function init(modules: { readonly typescript: typeof tsServer }): tsServer.server.PluginModule;
+
+export { }

package/dist/extensibility-language-server-beta.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Extensibility Language Server
+ *
+ * Provides a tsserver plugin and standalone LSP language server for the
+ * Stripe extensibility SDK, built on formspec building blocks.
+ *
+ * Consumers should import from subpath exports:
+ * - `extensibility-language-server/plugin` — tsserver plugin
+ * - `extensibility-language-server/server` — LSP language server
+ *
+ * @packageDocumentation
+ */
+
+import type { Connection } from 'vscode-languageserver/node.js';
+import { CreateServerOptions as CreateServerOptions_2 } from '@formspec/language-server';
+import type * as tsServer from 'typescript/lib/tsserverlibrary.js';
+
+/**
+ * Creates and configures the Extensibility language server connection.
+ *
+ * The current implementation delegates to FormSpec's packaged server and keeps
+ * a local wrapper so Extensibility-specific handlers can be interleaved later
+ * without changing this package's public API.
+ *
+ * @public
+ */
+export declare function createServer(options?: CreateServerOptions): Connection;
+
+/**
+ * Public configuration for constructing the Extensibility language server.
+ *
+ * This currently matches FormSpec's server options, while preserving an SDK-owned
+ * wrapper seam where Extensibility-specific LSP behavior can be layered in.
+ *
+ * @public
+ */
+export declare type CreateServerOptions = CreateServerOptions_2;
+
+/**
+ * Initializes the Extensibility TypeScript language service plugin.
+ *
+ * @public
+ */
+export declare function init(modules: { readonly typescript: typeof tsServer }): tsServer.server.PluginModule;
+
+export { }

package/dist/extensibility-language-server-internal.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Extensibility Language Server
+ *
+ * Provides a tsserver plugin and standalone LSP language server for the
+ * Stripe extensibility SDK, built on formspec building blocks.
+ *
+ * Consumers should import from subpath exports:
+ * - `extensibility-language-server/plugin` — tsserver plugin
+ * - `extensibility-language-server/server` — LSP language server
+ *
+ * @packageDocumentation
+ */
+
+import type { Connection } from 'vscode-languageserver/node.js';
+import { CreateServerOptions as CreateServerOptions_2 } from '@formspec/language-server';
+import type * as tsServer from 'typescript/lib/tsserverlibrary.js';
+
+/**
+ * Creates and configures the Extensibility language server connection.
+ *
+ * The current implementation delegates to FormSpec's packaged server and keeps
+ * a local wrapper so Extensibility-specific handlers can be interleaved later
+ * without changing this package's public API.
+ *
+ * @public
+ */
+export declare function createServer(options?: CreateServerOptions): Connection;
+
+/**
+ * Public configuration for constructing the Extensibility language server.
+ *
+ * This currently matches FormSpec's server options, while preserving an SDK-owned
+ * wrapper seam where Extensibility-specific LSP behavior can be layered in.
+ *
+ * @public
+ */
+export declare type CreateServerOptions = CreateServerOptions_2;
+
+/**
+ * Initializes the Extensibility TypeScript language service plugin.
+ *
+ * @public
+ */
+export declare function init(modules: { readonly typescript: typeof tsServer }): tsServer.server.PluginModule;
+
+export { }

package/dist/extensibility-language-server-plugin-alpha.d.ts

@@ -0,0 +1,10 @@
+import type * as tsServer from 'typescript/lib/tsserverlibrary.js';
+
+/**
+ * Initializes the Extensibility TypeScript language service plugin.
+ *
+ * @public
+ */
+export declare function init(modules: { readonly typescript: typeof tsServer }): tsServer.server.PluginModule;
+
+export { }

package/dist/extensibility-language-server-plugin-beta.d.ts

@@ -0,0 +1,10 @@
+import type * as tsServer from 'typescript/lib/tsserverlibrary.js';
+
+/**
+ * Initializes the Extensibility TypeScript language service plugin.
+ *
+ * @public
+ */
+export declare function init(modules: { readonly typescript: typeof tsServer }): tsServer.server.PluginModule;
+
+export { }

package/dist/extensibility-language-server-plugin-internal.d.ts

@@ -0,0 +1,10 @@
+import type * as tsServer from 'typescript/lib/tsserverlibrary.js';
+
+/**
+ * Initializes the Extensibility TypeScript language service plugin.
+ *
+ * @public
+ */
+export declare function init(modules: { readonly typescript: typeof tsServer }): tsServer.server.PluginModule;
+
+export { }

package/dist/extensibility-language-server-plugin-public.d.ts

@@ -0,0 +1,10 @@
+import type * as tsServer from 'typescript/lib/tsserverlibrary.js';
+
+/**
+ * Initializes the Extensibility TypeScript language service plugin.
+ *
+ * @public
+ */
+export declare function init(modules: { readonly typescript: typeof tsServer }): tsServer.server.PluginModule;
+
+export { }

package/dist/extensibility-language-server-public.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Extensibility Language Server
+ *
+ * Provides a tsserver plugin and standalone LSP language server for the
+ * Stripe extensibility SDK, built on formspec building blocks.
+ *
+ * Consumers should import from subpath exports:
+ * - `extensibility-language-server/plugin` — tsserver plugin
+ * - `extensibility-language-server/server` — LSP language server
+ *
+ * @packageDocumentation
+ */
+
+import type { Connection } from 'vscode-languageserver/node.js';
+import { CreateServerOptions as CreateServerOptions_2 } from '@formspec/language-server';
+import type * as tsServer from 'typescript/lib/tsserverlibrary.js';
+
+/**
+ * Creates and configures the Extensibility language server connection.
+ *
+ * The current implementation delegates to FormSpec's packaged server and keeps
+ * a local wrapper so Extensibility-specific handlers can be interleaved later
+ * without changing this package's public API.
+ *
+ * @public
+ */
+export declare function createServer(options?: CreateServerOptions): Connection;
+
+/**
+ * Public configuration for constructing the Extensibility language server.
+ *
+ * This currently matches FormSpec's server options, while preserving an SDK-owned
+ * wrapper seam where Extensibility-specific LSP behavior can be layered in.
+ *
+ * @public
+ */
+export declare type CreateServerOptions = CreateServerOptions_2;
+
+/**
+ * Initializes the Extensibility TypeScript language service plugin.
+ *
+ * @public
+ */
+export declare function init(modules: { readonly typescript: typeof tsServer }): tsServer.server.PluginModule;
+
+export { }

package/dist/extensibility-language-server-server-alpha.d.ts

@@ -0,0 +1,25 @@
+import type { Connection } from 'vscode-languageserver/node.js';
+import { CreateServerOptions as CreateServerOptions_2 } from '@formspec/language-server';
+
+/**
+ * Creates and configures the Extensibility language server connection.
+ *
+ * The current implementation delegates to FormSpec's packaged server and keeps
+ * a local wrapper so Extensibility-specific handlers can be interleaved later
+ * without changing this package's public API.
+ *
+ * @public
+ */
+export declare function createServer(options?: CreateServerOptions): Connection;
+
+/**
+ * Public configuration for constructing the Extensibility language server.
+ *
+ * This currently matches FormSpec's server options, while preserving an SDK-owned
+ * wrapper seam where Extensibility-specific LSP behavior can be layered in.
+ *
+ * @public
+ */
+export declare type CreateServerOptions = CreateServerOptions_2;
+
+export { }

package/dist/extensibility-language-server-server-beta.d.ts

@@ -0,0 +1,25 @@
+import type { Connection } from 'vscode-languageserver/node.js';
+import { CreateServerOptions as CreateServerOptions_2 } from '@formspec/language-server';
+
+/**
+ * Creates and configures the Extensibility language server connection.
+ *
+ * The current implementation delegates to FormSpec's packaged server and keeps
+ * a local wrapper so Extensibility-specific handlers can be interleaved later
+ * without changing this package's public API.
+ *
+ * @public
+ */
+export declare function createServer(options?: CreateServerOptions): Connection;
+
+/**
+ * Public configuration for constructing the Extensibility language server.
+ *
+ * This currently matches FormSpec's server options, while preserving an SDK-owned
+ * wrapper seam where Extensibility-specific LSP behavior can be layered in.
+ *
+ * @public
+ */
+export declare type CreateServerOptions = CreateServerOptions_2;
+
+export { }

package/dist/extensibility-language-server-server-internal.d.ts

@@ -0,0 +1,25 @@
+import type { Connection } from 'vscode-languageserver/node.js';
+import { CreateServerOptions as CreateServerOptions_2 } from '@formspec/language-server';
+
+/**
+ * Creates and configures the Extensibility language server connection.
+ *
+ * The current implementation delegates to FormSpec's packaged server and keeps
+ * a local wrapper so Extensibility-specific handlers can be interleaved later
+ * without changing this package's public API.
+ *
+ * @public
+ */
+export declare function createServer(options?: CreateServerOptions): Connection;
+
+/**
+ * Public configuration for constructing the Extensibility language server.
+ *
+ * This currently matches FormSpec's server options, while preserving an SDK-owned
+ * wrapper seam where Extensibility-specific LSP behavior can be layered in.
+ *
+ * @public
+ */
+export declare type CreateServerOptions = CreateServerOptions_2;
+
+export { }

package/dist/extensibility-language-server-server-public.d.ts

@@ -0,0 +1,25 @@
+import type { Connection } from 'vscode-languageserver/node.js';
+import { CreateServerOptions as CreateServerOptions_2 } from '@formspec/language-server';
+
+/**
+ * Creates and configures the Extensibility language server connection.
+ *
+ * The current implementation delegates to FormSpec's packaged server and keeps
+ * a local wrapper so Extensibility-specific handlers can be interleaved later
+ * without changing this package's public API.
+ *
+ * @public
+ */
+export declare function createServer(options?: CreateServerOptions): Connection;
+
+/**
+ * Public configuration for constructing the Extensibility language server.
+ *
+ * This currently matches FormSpec's server options, while preserving an SDK-owned
+ * wrapper seam where Extensibility-specific LSP behavior can be layered in.
+ *
+ * @public
+ */
+export declare type CreateServerOptions = CreateServerOptions_2;
+
+export { }

package/dist/index.cjs

@@ -0,0 +1,123 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  createServer: () => createServer,
+  init: () => init
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/plugin/index.ts
+var import_ts_plugin = require("@formspec/ts-plugin");
+var services = /* @__PURE__ */ new Map();
+var PERF_LOG_ENV_VAR = "EXTENSIBILITY_PLUGIN_PROFILE";
+var PERF_LOG_THRESHOLD_ENV_VAR = "EXTENSIBILITY_PLUGIN_PROFILE_THRESHOLD_MS";
+function formatPluginError(error) {
+  return error instanceof Error ? error.stack ?? error.message : String(error);
+}
+function readBooleanEnvFlag(name) {
+  const rawValue = process.env[name];
+  return rawValue === "1" || rawValue === "true";
+}
+function readNumberEnvFlag(name) {
+  const rawValue = process.env[name];
+  if (rawValue === void 0 || rawValue.trim() === "") {
+    return void 0;
+  }
+  const parsed = Number(rawValue);
+  return Number.isFinite(parsed) ? parsed : void 0;
+}
+function getOrCreateService(info, typescriptVersion) {
+  const workspaceRoot = info.project.getCurrentDirectory();
+  const existing = services.get(workspaceRoot);
+  if (existing !== void 0) {
+    existing.referenceCount += 1;
+    attachProjectCloseHandler(info, workspaceRoot, existing);
+    return existing.service;
+  }
+  const performanceLogThresholdMs = readNumberEnvFlag(PERF_LOG_THRESHOLD_ENV_VAR);
+  const service = new import_ts_plugin.FormSpecPluginService({
+    workspaceRoot,
+    typescriptVersion,
+    getProgram: () => info.languageService.getProgram(),
+    logger: info.project.projectService.logger,
+    enablePerformanceLogging: readBooleanEnvFlag(PERF_LOG_ENV_VAR),
+    ...performanceLogThresholdMs === void 0 ? {} : { performanceLogThresholdMs }
+  });
+  const serviceEntry = {
+    service,
+    referenceCount: 1
+  };
+  attachProjectCloseHandler(info, workspaceRoot, serviceEntry);
+  service.start().catch((error) => {
+    info.project.projectService.logger.info(
+      `[Extensibility] Plugin service failed to start for ${workspaceRoot}: ${formatPluginError(error)}`
+    );
+    services.delete(workspaceRoot);
+  });
+  services.set(workspaceRoot, serviceEntry);
+  return service;
+}
+function attachProjectCloseHandler(info, workspaceRoot, serviceEntry) {
+  const originalClose = info.project.close.bind(info.project);
+  let closed = false;
+  info.project.close = () => {
+    if (closed) {
+      originalClose();
+      return;
+    }
+    closed = true;
+    serviceEntry.referenceCount -= 1;
+    if (serviceEntry.referenceCount <= 0) {
+      services.delete(workspaceRoot);
+      void serviceEntry.service.stop().catch((error) => {
+        info.project.projectService.logger.info(
+          `[Extensibility] Failed to stop plugin service for ${workspaceRoot}: ${formatPluginError(error)}`
+        );
+      });
+    }
+    originalClose();
+  };
+}
+function init(modules) {
+  const typescriptVersion = modules.typescript.version;
+  return {
+    create(info) {
+      const service = getOrCreateService(info, typescriptVersion);
+      return (0, import_ts_plugin.createLanguageServiceProxy)(
+        info.languageService,
+        service.getSemanticService()
+      );
+    }
+  };
+}
+
+// src/server/server.ts
+var import_language_server = require("@formspec/language-server");
+var import_extensibility_jsonschema_tools = require("@stripe/extensibility-jsonschema-tools");
+function createServer(options = {}) {
+  return (0, import_language_server.createServer)({ config: import_extensibility_jsonschema_tools._stripeFormSpecConfig, ...options });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createServer,
+  init
+});

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Extensibility Language Server
+ *
+ * Provides a tsserver plugin and standalone LSP language server for the
+ * Stripe extensibility SDK, built on formspec building blocks.
+ *
+ * Consumers should import from subpath exports:
+ * - `extensibility-language-server/plugin` — tsserver plugin
+ * - `extensibility-language-server/server` — LSP language server
+ *
+ * @packageDocumentation
+ */
+export { init } from './plugin/index.js';
+export { createServer } from './server/index.js';
+export type { CreateServerOptions } from './server/index.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":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,97 @@
+// src/plugin/index.ts
+import { createLanguageServiceProxy, FormSpecPluginService } from "@formspec/ts-plugin";
+var services = /* @__PURE__ */ new Map();
+var PERF_LOG_ENV_VAR = "EXTENSIBILITY_PLUGIN_PROFILE";
+var PERF_LOG_THRESHOLD_ENV_VAR = "EXTENSIBILITY_PLUGIN_PROFILE_THRESHOLD_MS";
+function formatPluginError(error) {
+  return error instanceof Error ? error.stack ?? error.message : String(error);
+}
+function readBooleanEnvFlag(name) {
+  const rawValue = process.env[name];
+  return rawValue === "1" || rawValue === "true";
+}
+function readNumberEnvFlag(name) {
+  const rawValue = process.env[name];
+  if (rawValue === void 0 || rawValue.trim() === "") {
+    return void 0;
+  }
+  const parsed = Number(rawValue);
+  return Number.isFinite(parsed) ? parsed : void 0;
+}
+function getOrCreateService(info, typescriptVersion) {
+  const workspaceRoot = info.project.getCurrentDirectory();
+  const existing = services.get(workspaceRoot);
+  if (existing !== void 0) {
+    existing.referenceCount += 1;
+    attachProjectCloseHandler(info, workspaceRoot, existing);
+    return existing.service;
+  }
+  const performanceLogThresholdMs = readNumberEnvFlag(PERF_LOG_THRESHOLD_ENV_VAR);
+  const service = new FormSpecPluginService({
+    workspaceRoot,
+    typescriptVersion,
+    getProgram: () => info.languageService.getProgram(),
+    logger: info.project.projectService.logger,
+    enablePerformanceLogging: readBooleanEnvFlag(PERF_LOG_ENV_VAR),
+    ...performanceLogThresholdMs === void 0 ? {} : { performanceLogThresholdMs }
+  });
+  const serviceEntry = {
+    service,
+    referenceCount: 1
+  };
+  attachProjectCloseHandler(info, workspaceRoot, serviceEntry);
+  service.start().catch((error) => {
+    info.project.projectService.logger.info(
+      `[Extensibility] Plugin service failed to start for ${workspaceRoot}: ${formatPluginError(error)}`
+    );
+    services.delete(workspaceRoot);
+  });
+  services.set(workspaceRoot, serviceEntry);
+  return service;
+}
+function attachProjectCloseHandler(info, workspaceRoot, serviceEntry) {
+  const originalClose = info.project.close.bind(info.project);
+  let closed = false;
+  info.project.close = () => {
+    if (closed) {
+      originalClose();
+      return;
+    }
+    closed = true;
+    serviceEntry.referenceCount -= 1;
+    if (serviceEntry.referenceCount <= 0) {
+      services.delete(workspaceRoot);
+      void serviceEntry.service.stop().catch((error) => {
+        info.project.projectService.logger.info(
+          `[Extensibility] Failed to stop plugin service for ${workspaceRoot}: ${formatPluginError(error)}`
+        );
+      });
+    }
+    originalClose();
+  };
+}
+function init(modules) {
+  const typescriptVersion = modules.typescript.version;
+  return {
+    create(info) {
+      const service = getOrCreateService(info, typescriptVersion);
+      return createLanguageServiceProxy(
+        info.languageService,
+        service.getSemanticService()
+      );
+    }
+  };
+}
+
+// src/server/server.ts
+import {
+  createServer as createFormSpecServer
+} from "@formspec/language-server";
+import { _stripeFormSpecConfig } from "@stripe/extensibility-jsonschema-tools";
+function createServer(options = {}) {
+  return createFormSpecServer({ config: _stripeFormSpecConfig, ...options });
+}
+export {
+  createServer,
+  init
+};

package/dist/plugin/index.d.ts

@@ -0,0 +1,8 @@
+import type * as tsServer from 'typescript/lib/tsserverlibrary.js';
+/**
+ * Initializes the Extensibility TypeScript language service plugin.
+ *
+ * @public
+ */
+export declare function init(modules: { readonly typescript: typeof tsServer }): tsServer.server.PluginModule;
+//# sourceMappingURL=index.d.ts.map

package/dist/plugin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugin/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,QAAQ,MAAM,mCAAmC,CAAC;AAiGnE;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE;IAC5B,QAAQ,CAAC,UAAU,EAAE,OAAO,QAAQ,CAAC;CACtC,GAAG,QAAQ,CAAC,MAAM,CAAC,YAAY,CAW/B"}