@stripe/extensibility-sdk 0.22.4

package/dist/extensibility-sdk-config-values-internal.d.ts

@@ -0,0 +1,118 @@
+import type { Project } from 'ts-morph';
+
+/**
+ * Analyzes a named config type in a source file, producing a descriptor
+ * for runtime transformation.
+ *
+ * Creates a ts-morph Project from the file system. For testing with
+ * in-memory files, use `analyzeConfigTypeInProject` directly.
+ * @internal
+ */
+export declare function analyzeConfigType(options: {
+    filePath: string;
+    typeName: string;
+}): ConfigAnalysisResult;
+
+/**
+ * Analyzes a named config type using a caller-supplied ts-morph Project.
+ * Use this in tests to pass an in-memory project.
+ * @internal
+ */
+export declare function analyzeConfigTypeInProject(project: Project, filePath: string, typeName: string): ConfigAnalysisResult;
+
+/**
+ * The result of analyzing a config type.
+ *
+ * `interfaces` is in DFS post-order: inner types appear before the types that
+ * reference them, so the root type is always last.
+ * `enums` is in discovery order, deduplicated by name.
+ * @internal
+ */
+export declare interface ConfigAnalysisResult {
+    rootTypeName: string;
+    interfaces: ConfigInterfaceDescriptor[];
+    enums: ConfigEnumDescriptor[];
+}
+
+/** @internal */
+export declare interface ConfigEnumDescriptor {
+    name: string;
+    values: readonly string[];
+}
+
+/** @internal */
+export declare interface ConfigField {
+    name: string;
+    classification: FieldClassification;
+    optional: boolean;
+}
+
+/** @internal */
+export declare interface ConfigInterfaceDescriptor {
+    name: string;
+    fields: ConfigField[];
+}
+
+/** @internal */
+export declare type FieldClassification = ScalarFieldClassification | StructuralFieldClassification;
+
+/**
+ * Generates TypeScript code for a config descriptor.
+ *
+ * Emits enum value constants first, then one `_ShapeDescriptor` constant per
+ * interface (in DFS post-order, so inner types appear before their references),
+ * followed by an exported `transformX(raw: unknown): X` function.
+ *
+ * @internal
+ */
+export declare function generateConfigDescriptor(result: ConfigAnalysisResult): GeneratedConfigDescriptor;
+
+/**
+ * Generated TypeScript source and imports for a config descriptor.
+ *
+ * @internal
+ */
+export declare interface GeneratedConfigDescriptor {
+    /** TypeScript code lines for the descriptor constant(s) and transform function */
+    lines: string[];
+    /** Value symbol names required from the stdlib module */
+    requiredImports: ReadonlySet<string>;
+    /** Type-only symbol names required from the stdlib module */
+    requiredTypeImports: ReadonlySet<string>;
+}
+
+/** @internal */
+export declare type ScalarFieldClassification = {
+    kind: 'primitive';
+} | {
+    kind: 'decimal';
+} | {
+    kind: 'datetime';
+} | {
+    kind: 'enum';
+    typeName: string;
+};
+
+/**
+ * The package specifier for the stdlib module used in generated import lines.
+ *
+ * @internal
+ */
+export declare const STDLIB_IMPORT_PATH = "@stripe/extensibility-sdk/stdlib";
+
+/** @internal */
+export declare type StructuralFieldClassification = {
+    kind: 'interface';
+    typeName: string;
+} | {
+    kind: 'union';
+    typeName: string;
+} | {
+    kind: 'array';
+    element: FieldClassification;
+} | {
+    kind: 'map';
+    value: FieldClassification;
+};
+
+export { }

package/dist/extensibility-sdk-config-values-public.d.ts

@@ -0,0 +1,27 @@
+import type { Project } from 'ts-morph';
+
+/* Excluded from this release type: analyzeConfigType */
+
+/* Excluded from this release type: analyzeConfigTypeInProject */
+
+/* Excluded from this release type: ConfigAnalysisResult */
+
+/* Excluded from this release type: ConfigEnumDescriptor */
+
+/* Excluded from this release type: ConfigField */
+
+/* Excluded from this release type: ConfigInterfaceDescriptor */
+
+/* Excluded from this release type: FieldClassification */
+
+/* Excluded from this release type: generateConfigDescriptor */
+
+/* Excluded from this release type: GeneratedConfigDescriptor */
+
+/* Excluded from this release type: ScalarFieldClassification */
+
+/* Excluded from this release type: STDLIB_IMPORT_PATH */
+
+/* Excluded from this release type: StructuralFieldClassification */
+
+export { }