@stripe/extensibility-jsonschema-tools 0.6.3

package/dist/extract-config-schemas.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Extract config type schemas from extension class exports.
+ *
+ * Given a file path and export name, resolves the class declaration,
+ * walks its `implements` clause to find generic type arguments, and
+ * extracts JSON Schema + UI Schema from each config type.
+ */
+import type { JsonSchema2020, UISchema } from '@formspec/build';
+/**
+ * Options for extracting config schemas from a class export.
+ *
+ * @internal
+ */
+export interface _ExtractConfigSchemasOptions {
+    /** Absolute path to the TypeScript source file */
+    filePath: string;
+    /**
+     * Export name to resolve. Use `"default"` for the file's default export,
+     * or a named export identifier (e.g., `"LoyaltyDiscount"`).
+     */
+    exportName: string;
+}
+/**
+ * UI schema describing how to render a configuration form.
+ *
+ * @internal
+ */
+export type _ConfigUiSchema = UISchema;
+/**
+ * A single config schema extracted from a generic type argument.
+ *
+ * @internal
+ */
+export interface _ConfigSchemaResult {
+    /** Name of the interface whose generic type argument was resolved */
+    interfaceName: string;
+    /** Name of the resolved config type */
+    typeName: string;
+    /** Absolute path to the source file that defines the config type */
+    sourceFilePath: string;
+    /** JSON Schema for validation */
+    jsonSchema: JsonSchema2020;
+    /** UI Schema for rendering */
+    uiSchema: _ConfigUiSchema;
+}
+/**
+ * Result of extracting config schemas from a class export.
+ *
+ * @internal
+ */
+export interface _ExtractConfigSchemasResult {
+    /** Config schemas extracted from the class's `implements` clauses */
+    schemas: _ConfigSchemaResult[];
+}
+/**
+ * A resolved type argument from an `implements` clause.
+ *
+ * @internal
+ */
+export interface _ConfigTypeRef {
+    /** Name of the interface whose generic type argument was resolved */
+    interfaceName: string;
+    /** Name of the resolved config type */
+    typeName: string;
+    /** Absolute path to the source file that defines the config type */
+    sourceFilePath: string;
+}
+/**
+ * Resolves the generic type arguments from a class's `implements` clause.
+ *
+ * Given a file and export name, this function:
+ * 1. Resolves the exported class declaration
+ * 2. Walks its `implements` clauses to find generic type arguments
+ * 3. Returns a `ConfigTypeRef` for each resolved type argument
+ *
+ * Primitive and anonymous type arguments (no resolvable symbol) are silently
+ * skipped. Use this when you need the type locations but not the JSON Schema.
+ *
+ * @example
+ * ```typescript
+ * // Given: export class LoyaltyDiscount implements DiscountCalculation<LoyaltyDiscountConfig>
+ * const refs = resolveConfigTypeArgs({ filePath: '...', exportName: 'default' });
+ * // refs[0].typeName === 'LoyaltyDiscountConfig'
+ * ```
+ *
+ * @param options - File path and export name
+ * @returns Array of resolved config type references
+ * @throws If the export name is not found (lists available exports).
+ * @throws If the export exists but is not a class declaration.
+ *
+ * @internal
+ */
+export declare function _resolveConfigTypeArgs(options: _ExtractConfigSchemasOptions): _ConfigTypeRef[];
+/**
+ * Extracts config schemas from the generic type arguments in a class's
+ * `implements` clause.
+ *
+ * Calls `resolveConfigTypeArgs` then runs `generateSchemas` on each result.
+ * Use `resolveConfigTypeArgs` directly when you need the type locations but
+ * not the JSON Schema.
+ *
+ * @param options - File path and export name
+ * @returns Envelope containing an array of config schema results
+ * @throws If the export name is not found (lists available exports).
+ * @throws If the export exists but is not a class declaration.
+ *
+ * @internal
+ */
+export declare function _extractConfigSchemas(options: _ExtractConfigSchemasOptions): _ExtractConfigSchemasResult;
+//# sourceMappingURL=extract-config-schemas.d.ts.map

package/dist/extract-config-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-config-schemas.d.ts","sourceRoot":"","sources":["../src/extract-config-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAOhE;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAC3C,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;AAEvC;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,qEAAqE;IACrE,aAAa,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,cAAc,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,UAAU,EAAE,cAAc,CAAC;IAC3B,8BAA8B;IAC9B,QAAQ,EAAE,eAAe,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IAC1C,qEAAqE;IACrE,OAAO,EAAE,mBAAmB,EAAE,CAAC;CAChC;AAkBD;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,qEAAqE;IACrE,aAAa,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,cAAc,EAAE,MAAM,CAAC;CACxB;AA2BD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,4BAA4B,GACpC,cAAc,EAAE,CAqDlB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,4BAA4B,GACpC,2BAA2B,CAc7B"}

package/dist/fixup-decimal-path-constraints.d.ts

@@ -0,0 +1,13 @@
+import type { JsonSchema2020 } from '@formspec/build';
+/**
+ * Post-processes a generated JSON Schema to fix path-targeted constraints on
+ * Decimal sub-properties. Mutates the schema in place for efficiency.
+ *
+ * When formspec emits `$ref` + sibling `properties` for path-targeted
+ * constraints, any numeric constraint keywords targeting a Decimal sub-property
+ * must be broadened to the corresponding `decimal*` keyword with a string value.
+ *
+ * @internal
+ */
+export declare function _fixupDecimalPathConstraints(schema: JsonSchema2020): JsonSchema2020;
+//# sourceMappingURL=fixup-decimal-path-constraints.d.ts.map

package/dist/fixup-decimal-path-constraints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixup-decimal-path-constraints.d.ts","sourceRoot":"","sources":["../src/fixup-decimal-path-constraints.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AActD;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAgBnF"}

package/dist/generate-schemas.d.ts

@@ -0,0 +1,12 @@
+import { type GenerateSchemasOptions } from '@formspec/build';
+/**
+ * Generates JSON Schema and UI Schema using Stripe's canonical config.
+ *
+ * Passes {@link _stripeFormSpecConfig} via the `config` field so formspec's
+ * internal `resolveOptions` handles extension registry, metadata policy,
+ * and enum serialization consistently.
+ *
+ * @internal
+ */
+export declare function _generateSchemas(options: Omit<GenerateSchemasOptions, 'errorReporting'>): import("@formspec/build").GenerateFromClassResult;
+//# sourceMappingURL=generate-schemas.d.ts.map

package/dist/generate-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-schemas.d.ts","sourceRoot":"","sources":["../src/generate-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,iBAAiB,CAAC;AAIzB;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,IAAI,CAAC,sBAAsB,EAAE,gBAAgB,CAAC,qDAoBxD"}