@stripe/extensibility-custom-objects-tools 0.40.0

package/dist/transformer/classify-fields.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Classifies JSON Schema properties into `FieldClassification` trees for
+ * wire↔native type conversion descriptor generation.
+ *
+ * Custom objects don't have proto-parsed `TransformedField` objects like
+ * extension interfaces. Instead, field classification is driven by the
+ * JSON Schema output of the FormSpec extraction pipeline.
+ *
+ * @internal
+ */
+/**
+ * Field classification tree — a subset of the internal-codegen
+ * `FieldClassification` type (omits `union`), defined locally to avoid a
+ * cross-package import from the codegen library (which is a build-time-only tool).
+ * @internal
+ */
+export type FieldClassification = {
+    kind: 'primitive';
+} | {
+    kind: 'decimal';
+} | {
+    kind: 'datetime';
+} | {
+    kind: 'enum';
+    typeName: string;
+} | {
+    kind: 'interface';
+    typeName: string;
+} | {
+    kind: 'array';
+    element: FieldClassification;
+} | {
+    kind: 'map';
+    value: FieldClassification;
+};
+/**
+ * Minimal JSON Schema shape we inspect during classification.
+ * Only the fields relevant to classification are typed — the full
+ * `JsonSchema2020` type from `@formspec/build` is a superset.
+ * @internal
+ */
+export interface JsonSchemaNode {
+    readonly type?: string | undefined;
+    readonly format?: string | undefined;
+    readonly enum?: readonly unknown[] | undefined;
+    readonly properties?: Readonly<Record<string, JsonSchemaNode>> | undefined;
+    readonly required?: readonly string[] | undefined;
+    readonly items?: JsonSchemaNode | undefined;
+    readonly additionalProperties?: JsonSchemaNode | boolean | undefined;
+    readonly title?: string | undefined;
+    /** Allow extra JSON Schema properties without breaking assignability */
+    readonly [key: string]: unknown;
+}
+/**
+ * Classifies a single JSON Schema property node into a `FieldClassification`.
+ *
+ * Classification rules (applied in order):
+ * - `{ type: "string", format: "date-time" }` → `datetime`
+ * - `{ type: "string", format: "decimal" }` → `decimal`
+ * - `{ type: "string", enum: [...] }` → `enum`
+ * - `{ type: "array", items: {...} }` → `array` (recursive)
+ * - `{ type: "object", additionalProperties: {...} }` → `map` (recursive)
+ * - `{ type: "object", properties: {...} }` → `interface` (recursive)
+ * - primitives (string, number, boolean, integer) → `primitive`
+ *
+ * @param schema - A JSON Schema node to classify
+ * @param typeName - An optional type name for object/enum types (used in
+ *   descriptor generation to reference the descriptor constant)
+ * @returns The field classification
+ * @internal
+ */
+export declare function classifyJsonSchemaProperty(schema: JsonSchemaNode, typeName?: string): FieldClassification;
+/**
+ * Result of classifying a JSON Schema object's properties for descriptor generation.
+ * @internal
+ */
+export interface ClassifiedSchema {
+    /** Per-property classification keyed by property name */
+    fields: Record<string, FieldClassification>;
+    /** Per-property optionality (true = optional) */
+    optionality: Record<string, boolean>;
+    /** Nested object schemas that need their own descriptors */
+    nestedSchemas: NestedSchemaInfo[];
+}
+/**
+ * Info about a nested object schema that requires its own descriptor.
+ * @internal
+ */
+export interface NestedSchemaInfo {
+    /** Descriptor constant name prefix */
+    typeName: string;
+    /** The JSON Schema node for the nested object */
+    schema: JsonSchemaNode;
+}
+/**
+ * Classifies all properties of a JSON Schema object and collects nested
+ * schemas that need their own descriptor constants.
+ *
+ * @param schema - A JSON Schema node with `type: "object"` and `properties`
+ * @param prefix - A name prefix for generating nested type names
+ * @returns Classification result with per-field classifications and nested schemas
+ * @internal
+ */
+export declare function classifyObjectSchema(schema: JsonSchemaNode, prefix: string): ClassifiedSchema;
+//# sourceMappingURL=classify-fields.d.ts.map

package/dist/transformer/classify-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify-fields.d.ts","sourceRoot":"","sources":["../../src/transformer/classify-fields.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAC3B;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACpB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,mBAAmB,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,GAAG,SAAS,CAAC;IAC3E,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAClD,QAAQ,CAAC,KAAK,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,oBAAoB,CAAC,EAAE,cAAc,GAAG,OAAO,GAAG,SAAS,CAAC;IACrE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,wEAAwE;IACxE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,cAAc,EACtB,QAAQ,CAAC,EAAE,MAAM,GAChB,mBAAmB,CA6CrB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAC5C,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,4DAA4D;IAC5D,aAAa,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,MAAM,EAAE,cAAc,CAAC;CACxB;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,MAAM,GACb,gBAAgB,CAmBlB"}

package/dist/transformer/generate-descriptors.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Generates `_ShapeDescriptor` TypeScript code strings from classified
+ * JSON Schema for custom object wire↔native conversion.
+ *
+ * Follows the same pattern as `internal/codegen/src/generate-converters.ts`
+ * but adapted for custom objects where:
+ * - Wire names equal SDK names (no snake_case→camelCase rename needed)
+ * - There are no enums, unions, or discriminated unions from proto definitions
+ * - Classification is driven by JSON Schema rather than proto parsed types
+ *
+ * @internal
+ */
+/**
+ * Input for generating all descriptors for a single custom object.
+ * @internal
+ */
+export interface DescriptorGenerationInput {
+    /** The class name (e.g. `Invoice`) */
+    className: string;
+    /**
+     * JSON Schema for the fields surface (point-read hydration).
+     * Typed as `unknown` — the transformer carries schemas through the transform
+     * plan without coupling to `@formspec/build`'s `JsonSchema2020` type (which
+     * lacks an index signature). Cast to `JsonSchemaNode | null` happens inside
+     * `generateDescriptors` at this boundary.
+     */
+    fieldsSchema: unknown;
+    /** Maps schema property names → TS property names for the fields surface */
+    fieldsPropertyNameMap?: Record<string, string> | undefined;
+    /** Per-action schemas keyed by apiName */
+    actions: Record<string, {
+        apiName: string;
+        /** JSON Schema for the action's input type. Typed as `unknown` — see `fieldsSchema`. */
+        inputSchema: unknown;
+        /** JSON Schema for the action's output type. Typed as `unknown` — see `fieldsSchema`. */
+        outputSchema: unknown;
+        /** Maps schema property names → TS property names for the input surface */
+        inputPropertyNameMap?: Record<string, string> | undefined;
+        /** Maps schema property names → TS property names for the output surface */
+        outputPropertyNameMap?: Record<string, string> | undefined;
+    }>;
+}
+/**
+ * Result of generating descriptors for a single custom object.
+ * @internal
+ */
+export interface DescriptorGenerationResult {
+    /** All generated descriptor code lines */
+    code: string[];
+    /** Names of all descriptors generated (for reference in the wrapper class) */
+    descriptorNames: {
+        fields: string | null;
+        actions: Record<string, {
+            input: string | null;
+            output: string | null;
+        }>;
+    };
+}
+/**
+ * Generates all `_ShapeDescriptor` constants for one custom object.
+ *
+ * Produces:
+ * - `{ClassName}_FieldsDescriptor` for point-read hydration (wire→native)
+ * - `{ClassName}_{apiName}_InputDescriptor` per action (wire→native)
+ * - `{ClassName}_{apiName}_OutputDescriptor` per action (native→wire)
+ *
+ * Also generates descriptors for any nested object types discovered
+ * during classification.
+ * @internal
+ */
+export declare function generateDescriptors(input: DescriptorGenerationInput): DescriptorGenerationResult;
+//# sourceMappingURL=generate-descriptors.d.ts.map

package/dist/transformer/generate-descriptors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-descriptors.d.ts","sourceRoot":"","sources":["../../src/transformer/generate-descriptors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAyFH;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,YAAY,EAAE,OAAO,CAAC;IACtB,4EAA4E;IAC5E,qBAAqB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAC3D,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CACb,MAAM,EACN;QACE,OAAO,EAAE,MAAM,CAAC;QAChB,wFAAwF;QACxF,WAAW,EAAE,OAAO,CAAC;QACrB,yFAAyF;QACzF,YAAY,EAAE,OAAO,CAAC;QACtB,2EAA2E;QAC3E,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;QAC1D,4EAA4E;QAC5E,qBAAqB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;KAC5D,CACF,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC,0CAA0C;IAC1C,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,8EAA8E;IAC9E,eAAe,EAAE;QACf,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;YAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE,CAAC,CAAC;KAC1E,CAAC;CACH;AAwCD;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,yBAAyB,GAC/B,0BAA0B,CAiE5B"}

package/dist/transformer/metadata.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Converts a string to snake_case.
+ * @param str - The string to convert
+ * @returns The snake_case version of the string
+ * @alpha
+ *
+ * @example
+ * toSnakeCase('camelCase') // 'camel_case'
+ * toSnakeCase('PascalCase') // 'pascal_case'
+ * toSnakeCase('XMLParser') // 'xml_parser'
+ */
+export declare function toSnakeCase(str: string): string;
+/**
+ * Converts a snake_case string to PascalCase.
+ * @param str - The string to convert
+ * @returns The PascalCase version of the string
+ * @alpha
+ *
+ * @example
+ * toPascalCase('my_type') // 'MyType'
+ * toPascalCase('type_a') // 'TypeA'
+ * toPascalCase('shipment') // 'Shipment'
+ */
+export declare function toPascalCase(str: string): string;
+//# sourceMappingURL=metadata.d.ts.map

package/dist/transformer/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/transformer/metadata.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM/C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKhD"}

package/dist/transformer/transform.d.ts

@@ -0,0 +1,35 @@
+import type { ModuleTransformPlan, TransformResult } from './types.js';
+/**
+ * Transforms TypeScript source code with custom object decorators.
+ * Injects runtime code and extracts platform metadata.
+ *
+ * @param sourceCode - The TypeScript source code to transform
+ * @param fileName - Optional file name for error reporting
+ * @returns Transform result with code, metadata, and errors
+ * @deprecated Use `buildCustomObjectPackage` + `transformWithPlan` instead. This
+ * function performs source-only discovery without build-time schema analysis, so it
+ * cannot generate wire conversion descriptors and falls back to the legacy passthrough
+ * wrapper (no Decimal/DateTime hydration).
+ * @alpha
+ */
+export declare function transform(sourceCode: string, fileName?: string): TransformResult;
+/**
+ * Transforms TypeScript source code using a precomputed module transform plan.
+ *
+ * @param sourceCode - The TypeScript source code to transform
+ * @param plan - Precomputed transform plan
+ * @param fileName - Optional file name for error reporting
+ * @returns Transform result with code, metadata, and errors
+ * @internal
+ */
+export declare function transformWithPlan(sourceCode: string, plan: ModuleTransformPlan, fileName?: string): TransformResult;
+/**
+ * Transforms a TypeScript file from disk.
+ *
+ * @param filePath - Path to the TypeScript file
+ * @returns Transform result with code, metadata, and errors
+ * @deprecated Delegates to the deprecated `transform()`. Use `buildCustomObjectPackage` instead.
+ * @alpha
+ */
+export declare function transformFile(filePath: string): Promise<TransformResult>;
+//# sourceMappingURL=transform.d.ts.map

package/dist/transformer/transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../src/transformer/transform.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,mBAAmB,EAGnB,eAAe,EAChB,MAAM,YAAY,CAAC;AAcpB;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,eAAe,CA4BhF;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,mBAAmB,EACzB,QAAQ,CAAC,EAAE,MAAM,GAChB,eAAe,CAmBjB;AAsLD;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAkB9E"}

package/dist/transformer/types.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Metadata for a single action (method).
+ * @alpha
+ */
+export interface ActionMetadata {
+    /** The method name */
+    methodName: string;
+    /** String representation of argument types */
+    argType: string;
+    /** String representation of return type */
+    returnType: string;
+    /** API name for the action (defaults to snake_case of method name) */
+    apiName: string;
+}
+/**
+ * Actions metadata for a custom object.
+ * Only instance methods are supported — static methods cannot be actions.
+ * @alpha
+ */
+export interface ActionsMetadata {
+    /** Instance-level actions */
+    instance: Record<string, ActionMetadata>;
+}
+/**
+ * Platform metadata for a custom object class.
+ * @alpha
+ */
+export interface PlatformMetadata {
+    /** Module path that defined this custom object */
+    modulePath?: string;
+    /** Original TypeScript class name */
+    className?: string;
+    /** Canonical class api name */
+    classApiName?: string;
+    /** The api name of the custom object */
+    apiName: string;
+    /** All actions for this custom object */
+    actions: ActionsMetadata;
+}
+/**
+ * JSON Schema for one action's input/output surfaces, used by the
+ * descriptor generator to produce `_ShapeDescriptor` constants.
+ *
+ * Schema values are typed as `unknown` to avoid structural incompatibility
+ * with the `JsonSchema2020` interface from `@formspec/build` (which lacks
+ * an index signature). The transformer casts to its internal `JsonSchemaNode`
+ * at the `generateDescriptors` boundary.
+ *
+ * @internal
+ */
+export interface ActionSchemaData {
+    /** API name of the action (snake_case) */
+    apiName: string;
+    /** JSON Schema for the action's input type (null if no input parameter) */
+    inputSchema: unknown;
+    /** JSON Schema for the action's output type */
+    outputSchema: unknown;
+    /**
+     * Maps schema property names (apiName / snake_case) to original TypeScript
+     * property names (camelCase) for the input surface. Used to emit `wire`
+     * clauses in descriptor field entries when the names differ.
+     */
+    inputPropertyNameMap?: Record<string, string> | undefined;
+    /**
+     * Maps schema property names (apiName / snake_case) to original TypeScript
+     * property names (camelCase) for the output surface.
+     */
+    outputPropertyNameMap?: Record<string, string> | undefined;
+}
+/**
+ * Schema data needed by the transformer to generate wire conversion descriptors.
+ * @internal
+ */
+export interface TransformSchemaData {
+    /**
+     * JSON Schema for the fields surface (point-read hydration).
+     *
+     * Typed as `unknown` to avoid structural incompatibility with the `JsonSchema2020`
+     * interface from `@formspec/build` (which lacks an index signature). The transformer
+     * casts to its internal `JsonSchemaNode` at the `generateDescriptors` boundary —
+     * the same pattern used for `ActionSchemaData.inputSchema` / `outputSchema`.
+     */
+    fieldsSchema: unknown;
+    /**
+     * Maps schema property names (apiName / snake_case) to original TypeScript
+     * property names (camelCase) for the fields surface.
+     */
+    fieldsPropertyNameMap?: Record<string, string> | undefined;
+    /** Per-action schema data keyed by apiName */
+    actions: Record<string, ActionSchemaData>;
+}
+/**
+ * Planned transformation for one custom object class within a module.
+ * @internal
+ */
+export interface PlannedCustomObjectTransform {
+    /** Original class name in the source file */
+    className: string;
+    /** Precomputed platform metadata for this class */
+    platformMetadata: PlatformMetadata;
+    /** Schema data for wire conversion descriptor generation */
+    schemaData?: TransformSchemaData;
+}
+/**
+ * Planned transformation for one source module.
+ * @internal
+ */
+export interface ModuleTransformPlan {
+    /** Custom object classes to transform within the module */
+    objects: PlannedCustomObjectTransform[];
+}
+/**
+ * Result of transforming source code.
+ * @alpha
+ */
+export interface TransformResult {
+    /** Transformed source code */
+    code: string;
+    /** Platform metadata extracted from all custom objects */
+    metadata: PlatformMetadata[];
+    /** Any errors encountered during transformation */
+    errors: TransformError[];
+}
+/**
+ * An error that occurred during transformation.
+ * @alpha
+ */
+export interface TransformError {
+    /** Error message */
+    message: string;
+    /** File path (if available) */
+    file?: string;
+    /** Line number (if available) */
+    line?: number;
+    /** Column number (if available) */
+    column?: number;
+}
+/**
+ * Metadata extracted from a decorator.
+ * @internal
+ */
+export interface DecoratorMetadata {
+    /** Decorator name */
+    name: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/transformer/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/transformer/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,sBAAsB;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC1C;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,OAAO,EAAE,eAAe,CAAC;CAC1B;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,WAAW,EAAE,OAAO,CAAC;IACrB,+CAA+C;IAC/C,YAAY,EAAE,OAAO,CAAC;IACtB;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAC1D;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CAC5D;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;;OAOG;IACH,YAAY,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAC3D,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC3C;AAED;;;GAGG;AACH,MAAM,WAAW,4BAA4B;IAC3C,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,4DAA4D;IAC5D,UAAU,CAAC,EAAE,mBAAmB,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,2DAA2D;IAC3D,OAAO,EAAE,4BAA4B,EAAE,CAAC;CACzC;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,mDAAmD;IACnD,MAAM,EAAE,cAAc,EAAE,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/transformer/visitors.d.ts

@@ -0,0 +1,99 @@
+import type { ClassDeclaration, MethodDeclaration, SourceFile } from 'ts-morph';
+import type { PlatformMetadata, TransformSchemaData } from './types.js';
+/**
+ * Checks if a class has the `@CustomObject` decorator.
+ * @param classDecl - The class declaration
+ * @returns true if the class has `@CustomObject`
+ * @internal
+ */
+export declare function hasCustomObjectDecorator(classDecl: ClassDeclaration): boolean;
+/**
+ * Checks if a method has the `@Action` decorator.
+ * @param method - The method declaration
+ * @returns true if the method has `@Action`
+ * @internal
+ */
+export declare function hasActionDecorator(method: MethodDeclaration): boolean;
+/**
+ * Extracts all platform metadata from a custom object class.
+ * @param classDecl - The class declaration
+ * @returns Platform metadata
+ * @internal
+ */
+export declare function extractPlatformMetadata(classDecl: ClassDeclaration): PlatformMetadata;
+/**
+ * Injects platform metadata as a static property into a class.
+ * @param classDecl - The class declaration
+ * @param metadata - The platform metadata to inject
+ * @internal
+ */
+export declare function injectPlatformMetadata(classDecl: ClassDeclaration, metadata: PlatformMetadata): void;
+/**
+ * Injects proxy return statement into the constructor of a `@CustomObject` class.
+ * This causes `new MyClass()` to return a proxy that tracks mutations.
+ * @param classDecl - The class declaration
+ * @throws Error if the constructor already contains return statements
+ * @internal
+ */
+export declare function injectConstructorProxy(classDecl: ClassDeclaration): void;
+/**
+ * Injects auto-save logic at the end of an `@Action` method.
+ * After the method body executes, if there are pending changes, queue a save.
+ * @param method - The method declaration
+ * @internal
+ */
+export declare function injectAutoSave(method: MethodDeclaration): void;
+/**
+ * Injects runtime imports at the top of the source file.
+ * These imports provide the functions needed by the injected code.
+ *
+ * When `hasDescriptors` is true, also injects stdlib imports for wire
+ * conversion primitives from `@stripe/extensibility-sdk/stdlib`.
+ *
+ * @param sourceFile - The source file
+ * @param hasDescriptors - Whether wire conversion descriptors were generated
+ * @internal
+ */
+export declare function injectRuntimeImports(sourceFile: SourceFile, hasDescriptors?: boolean): void;
+/**
+ * Removes all decorators from a class and its members.
+ * @param classDecl - The class declaration
+ * @internal
+ */
+export declare function removeDecorators(classDecl: ClassDeclaration): void;
+/**
+ * Removes decorator imports from a source file.
+ * Removes decorator-specific named imports from the extensibility-custom-objects package.
+ * @param sourceFile - The source file node
+ * @internal
+ */
+export declare function removeDecoratorImports(sourceFile: SourceFile): void;
+/**
+ * Generates the InstanceMethodTypeMap type declaration.
+ * @param metadata - The platform metadata containing action information
+ * @returns The type declaration as a string
+ * @internal
+ */
+export declare function generateInstanceMethodTypeMap(metadata: PlatformMetadata): string;
+/**
+ * Generates the wrapper class with wire-converting executeMethod.
+ * Only instance methods are supported — static methods cannot be actions.
+ *
+ * When `schemaData` is provided, the wrapper includes:
+ * - `_ShapeDescriptor` constants for fields, inputs, and outputs
+ * - A private `hydrate()` method that converts wire-format fields to native types
+ * - An `executeMethod(request, config, context)` entry point that extracts
+ *   `objectRecord`, `methodName`, `methodArgs` from the request, then handles
+ *   both input and output wire conversion
+ *
+ * When `schemaData` is not provided (legacy path), generates the simpler
+ * passthrough wrapper for backward compatibility.
+ *
+ * @param metadata - The platform metadata
+ * @param className - The original TypeScript class name
+ * @param schemaData - Optional schema data for wire conversion descriptor generation
+ * @returns The wrapper class (and descriptors) as a string
+ * @internal
+ */
+export declare function generateWrapperClass(metadata: PlatformMetadata, className: string, schemaData?: TransformSchemaData): string;
+//# sourceMappingURL=visitors.d.ts.map

package/dist/transformer/visitors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visitors.d.ts","sourceRoot":"","sources":["../../src/transformer/visitors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAEhB,iBAAiB,EACjB,UAAU,EACX,MAAM,UAAU,CAAC;AAElB,OAAO,KAAK,EAIV,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAwBpB;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAK7E;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAKrE;AAoJD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,gBAAgB,GAAG,gBAAgB,CAmBrF;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,gBAAgB,EAC3B,QAAQ,EAAE,gBAAgB,GACzB,IAAI,CAgBN;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,gBAAgB,GAAG,IAAI,CA8BxE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAG9D;AA8BD;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,UAAU,EACtB,cAAc,UAAQ,GACrB,IAAI,CAwDN;AAKD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,gBAAgB,GAAG,IAAI,CA4BlE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAqBnE;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAYhF;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,mBAAmB,GAC/B,MAAM,CAMR"}