@stripe/extensibility-custom-objects 0.7.4

package/dist/runtime/base-object.d.ts

@@ -0,0 +1,84 @@
+import { type SaveResult } from './types.js';
+/**
+ * Abstract base class for all custom objects.
+ *
+ * Provides built-in platform fields (id, object, created, updated, livemode)
+ * and a typed `fields` container for user-defined fields. The generic parameter
+ * `T` describes the shape of user fields accessible via `this.fields`.
+ *
+ * @remarks
+ * **Definite assignment assertions (`!`)**: All platform fields (`id`, `object`,
+ * `created`, `updated`, `livemode`, `fields`) use the TypeScript definite assignment
+ * assertion operator. This suppresses the "property has no initializer" error because
+ * these fields are intentionally left unset by the zero-argument constructor.
+ *
+ * The runtime (`executeInstanceMethod` in `invoke.ts`) is solely responsible for
+ * populating these fields via `Object.assign` and `hydrateInstance` **before** the
+ * dirty-tracking proxy is installed. Code that constructs a subclass directly
+ * (bypassing the runtime) will have `undefined` values for all platform fields at
+ * runtime, despite the types suggesting otherwise.
+ *
+ * @typeParam T - Shape of user-defined fields stored in `fields`
+ * @public
+ */
+export declare abstract class BaseObject<T extends Record<string, unknown> = Record<string, unknown>> {
+    /** Unique identifier assigned by the platform */
+    readonly id: string;
+    /** Object type identifier assigned by the platform */
+    readonly object: string;
+    /** Timestamp when the object was created */
+    readonly created: Date;
+    /** Timestamp when the object was last updated */
+    readonly updated: Date;
+    /** Whether the object exists in live mode (true) or test mode (false). @public */
+    readonly livemode: boolean;
+    /**
+     * User-defined fields container. Populated during hydration via Object.assign
+     * before the dirty-tracking proxy is installed.
+     * Access individual fields as `this.fields.fieldName`.
+     *
+     * @remarks
+     * The generic type `T` describes the shape of available fields after
+     * hydration, not at construction time. Fields may be undefined before
+     * the instance is hydrated with data from the platform.
+     *
+     * @public
+     */
+    readonly fields: T;
+    /**
+     * Flushes pending field mutations into the slated-updates accumulator.
+     *
+     * When called from a transformed action (no save handler configured), this
+     * records which fields were mutated so that the Logic wrapper can include them
+     * in the response envelope's `updatedFields`. No network call is made.
+     *
+     * When a save handler is configured (runtime invoke path), the handler is
+     * called for actual persistence and its result is returned.
+     *
+     * @returns The save result including `updatedFieldCount` (unique fields flushed)
+     * @throws Error if the object is not proxied
+     * @public
+     */
+    save(): Promise<SaveResult>;
+    /**
+     * Discard all pending changes and restore field values to their
+     * last-saved state. Has no effect if the object is not proxied.
+     *
+     * @public
+     */
+    revert(): void;
+}
+/**
+ * Fields that are not tracked for changes by the proxy.
+ * These are system-managed fields that should not appear in pendingUpdates.
+ *
+ * @internal
+ */
+export declare const _UNTRACKED_FIELDS: Set<string>;
+/**
+ * Checks if a field should be tracked for changes.
+ *
+ * @internal
+ */
+export declare function _isTrackedField(field: string): boolean;
+//# sourceMappingURL=base-object.d.ts.map

package/dist/runtime/base-object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-object.d.ts","sourceRoot":"","sources":["../../src/runtime/base-object.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4C,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAMvF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,8BAAsB,UAAU,CAE9B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAE3D,iDAAiD;IACjD,QAAQ,CAAC,EAAE,EAAG,MAAM,CAAC;IACrB,sDAAsD;IACtD,QAAQ,CAAC,MAAM,EAAG,MAAM,CAAC;IACzB,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,EAAG,IAAI,CAAC;IACxB,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAG,IAAI,CAAC;IACxB,kFAAkF;IAClF,QAAQ,CAAC,QAAQ,EAAG,OAAO,CAAC;IAC5B;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,MAAM,EAAG,CAAC,CAAC;IAKpB;;;;;;;;;;;;;OAaG;IACG,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC;IA6BjC;;;;;OAKG;IACH,MAAM,IAAI,IAAI;CAyCf;AAED;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,aAM5B,CAAC;AAEH;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEtD"}

package/dist/runtime/deep-clone.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Deep-clone a JSON-serializable value.
+ *
+ * Prefers `structuredClone` when available (Node 17+, modern Deno).
+ * Falls back to `JSON.parse(JSON.stringify())` for restricted runtimes
+ * (e.g., the Stripe apps Deno sandbox) where `structuredClone` is not
+ * exposed.
+ *
+ * This is safe for custom object field values because they are always
+ * JSON-serializable plain data (strings, numbers, booleans, arrays,
+ * plain objects) — no Date, Map, Set, or circular references.
+ *
+ * @internal
+ */
+export declare function deepClone<T>(value: T): T;
+//# sourceMappingURL=deep-clone.d.ts.map

package/dist/runtime/deep-clone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-clone.d.ts","sourceRoot":"","sources":["../../src/runtime/deep-clone.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAWxC"}

package/dist/runtime/events.d.ts

@@ -0,0 +1,161 @@
+import type { _ExecuteMethodRequest } from './types.js';
+/**
+ * Event emitted when a field is set through the proxy.
+ *
+ * @internal
+ */
+export interface _ProxySetEvent {
+    /** Discriminant for the proxy:set event. */
+    type: 'proxy:set';
+    /** Name of the field that was set. */
+    field: string;
+    /** New value assigned to the field. */
+    value: unknown;
+    /** Unix epoch milliseconds when the set occurred. */
+    timestamp: number;
+}
+/**
+ * Event emitted when a save operation begins.
+ *
+ * @internal
+ */
+export interface _SaveBeginEvent {
+    /** Discriminant for the save:begin event. */
+    type: 'save:begin';
+    /** Field data being submitted to the platform. */
+    payload: Record<string, unknown>;
+}
+/**
+ * Event emitted when a save operation completes successfully.
+ *
+ * @internal
+ */
+export interface _SaveCompleteEvent {
+    /** Discriminant for the save:complete event. */
+    type: 'save:complete';
+    /** Raw response returned by the platform after a successful save. */
+    response: Record<string, unknown>;
+}
+/**
+ * Event emitted when a method invocation begins.
+ *
+ * @internal
+ */
+export interface _InvokeBeginEvent {
+    /** Discriminant for the invoke:begin event. */
+    type: 'invoke:begin';
+    /** The method invocation request being dispatched. */
+    request: _ExecuteMethodRequest;
+}
+/**
+ * Event emitted when a method invocation completes successfully.
+ *
+ * @internal
+ */
+export interface _InvokeCompleteEvent {
+    /** Discriminant for the invoke:complete event. */
+    type: 'invoke:complete';
+    /** Value returned by the method. */
+    result: unknown;
+}
+/**
+ * Event emitted when a method invocation throws an error.
+ *
+ * @internal
+ */
+export interface _InvokeErrorEvent {
+    /** Discriminant for the invoke:error event. */
+    type: 'invoke:error';
+    /** The thrown error value. */
+    error: unknown;
+}
+/**
+ * Event emitted when a method execution span begins.
+ *
+ * @internal
+ */
+export interface _SpanBeginEvent {
+    /** Discriminant for the span:begin event. */
+    type: 'span:begin';
+    /** Unique identifier for correlating begin/end/error events within a single span. */
+    spanId: string;
+    /** Name of the method being executed. */
+    name: string;
+    /** Arguments passed to the method. */
+    params?: unknown;
+    /** Whether the method is a static class method. */
+    isStatic?: boolean;
+    /** Nesting depth for recursive or nested method calls. */
+    depth?: number;
+}
+/**
+ * Event emitted when a method execution span ends successfully.
+ *
+ * @internal
+ */
+export interface _SpanEndEvent {
+    /** Discriminant for the span:end event. */
+    type: 'span:end';
+    /** Unique identifier correlating this event to the matching span:begin. */
+    spanId: string;
+    /** Name of the method that completed. */
+    name: string;
+    /** Elapsed time in milliseconds from span:begin to span:end. */
+    duration: number;
+    /** Value returned by the method, if any. */
+    result?: unknown;
+    /** Whether the method is a static class method. */
+    isStatic?: boolean;
+    /** Nesting depth for recursive or nested method calls. */
+    depth?: number;
+}
+/**
+ * Event emitted when a method execution span encounters an error.
+ *
+ * @internal
+ */
+export interface _SpanErrorEvent {
+    /** Discriminant for the span:error event. */
+    type: 'span:error';
+    /** Unique identifier correlating this event to the matching span:begin. */
+    spanId: string;
+    /** Name of the method that threw. */
+    name: string;
+    /** Elapsed time in milliseconds from span:begin to the point of failure. */
+    duration: number;
+    /** Serializable representation of the thrown error. */
+    error: {
+        message: string;
+        name: string;
+        stack?: string;
+    };
+    /** Whether the method is a static class method. */
+    isStatic?: boolean;
+    /** Nesting depth for recursive or nested method calls. */
+    depth?: number;
+}
+/**
+ * Union of all runtime events.
+ *
+ * @internal
+ */
+export type _RuntimeEvent = _InvokeBeginEvent | _InvokeCompleteEvent | _InvokeErrorEvent | _ProxySetEvent | _SaveBeginEvent | _SaveCompleteEvent | _SpanBeginEvent | _SpanEndEvent | _SpanErrorEvent;
+/**
+ * Event emitter interface for runtime telemetry.
+ *
+ * @internal
+ */
+export interface _RuntimeEventEmitter {
+    /** Broadcasts an event to all subscribed listeners */
+    emit(event: _RuntimeEvent): void;
+    /** Registers a listener; returns an unsubscribe function */
+    subscribe(listener: (event: _RuntimeEvent) => void): () => void;
+}
+/**
+ * Creates a new runtime event emitter.
+ * Listeners are isolated: if one throws, others still receive the event.
+ *
+ * @internal
+ */
+export declare function _createEventEmitter(): _RuntimeEventEmitter;
+//# sourceMappingURL=events.d.ts.map

package/dist/runtime/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/runtime/events.ts"],"names":[],"mappings":"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"}

package/dist/runtime/flush-helpers.d.ts

@@ -0,0 +1,9 @@
+import type { _ProxyState } from './types.js';
+/**
+ * Flushes pending field updates into the slated-updates accumulator.
+ * Strips the fields. prefix from keys so the response envelope uses bare property names.
+ * Returns the number of unique fields flushed.
+ * @internal
+ */
+export declare function _flushPendingToSlated(state: _ProxyState): number;
+//# sourceMappingURL=flush-helpers.d.ts.map

package/dist/runtime/flush-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flush-helpers.d.ts","sourceRoot":"","sources":["../../src/runtime/flush-helpers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAWhE"}

package/dist/runtime/invoke.d.ts

@@ -0,0 +1,19 @@
+import type { _ExecuteMethodRequest } from './types.js';
+import type { _RuntimeEventEmitter } from './events.js';
+/**
+ * Options for executing a custom object method.
+ *
+ * @internal
+ */
+export interface _ExecuteMethodOptions {
+    /** Event emitter for telemetry */
+    eventEmitter?: _RuntimeEventEmitter;
+}
+/**
+ * Executes a custom object method (instance or class/static).
+ * Dispatches to the appropriate handler based on whether instanceId is present.
+ *
+ * @internal
+ */
+export declare function _executeMethod(request: _ExecuteMethodRequest, options?: _ExecuteMethodOptions): Promise<unknown>;
+//# sourceMappingURL=invoke.d.ts.map

package/dist/runtime/invoke.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoke.d.ts","sourceRoot":"","sources":["../../src/runtime/invoke.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAoDxD;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,kCAAkC;IAClC,YAAY,CAAC,EAAE,oBAAoB,CAAC;CACrC;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,qBAAqB,EAC9B,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,OAAO,CAAC,CAyClB"}

package/dist/runtime/persist.d.ts

@@ -0,0 +1,44 @@
+import type { BaseObject } from './base-object.js';
+import type { _RuntimeEventEmitter } from './events.js';
+/**
+ * Options for persistence operations.
+ *
+ * @internal
+ */
+export interface _PersistOptions {
+    /** Event emitter for telemetry */
+    eventEmitter?: _RuntimeEventEmitter;
+    /** Fetch function (for testing with mocks) */
+    fetchFn?: typeof fetch;
+    /** Base URL for the persistence API */
+    baseUrl?: string;
+}
+/**
+ * Assembles an update payload from pending proxy updates.
+ *
+ * Fields prefixed with `fields.` are grouped into a nested `fields` object.
+ * All other fields appear at the top level.
+ *
+ * @example
+ * ```typescript
+ * assemblePayload([
+ *   { field: 'status', value: 'active' },
+ *   { field: 'fields.email', value: 'alice@example.com' },
+ * ]);
+ * // Returns: { status: 'active', fields: { email: 'alice@example.com' } }
+ * ```
+ *
+ * @internal
+ */
+export declare function _assemblePayload(pendingUpdates: {
+    field: string;
+    value: unknown;
+}[]): Record<string, unknown>;
+/**
+ * Persists a custom object instance to the platform.
+ * Throws if the object is not proxied.
+ *
+ * @internal
+ */
+export declare function _persistObject(obj: BaseObject, options?: _PersistOptions): Promise<void>;
+//# sourceMappingURL=persist.d.ts.map

package/dist/runtime/persist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persist.d.ts","sourceRoot":"","sources":["../../src/runtime/persist.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGxD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,YAAY,CAAC,EAAE,oBAAoB,CAAC;IACpC,8CAA8C;IAC9C,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAC9B,cAAc,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,EAAE,GAClD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoBzB;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,UAAU,EACf,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,IAAI,CAAC,CAqDf"}

package/dist/runtime/proxy/constants.d.ts

@@ -0,0 +1,5 @@
+/** Keys that must never be set or deleted via proxies to prevent prototype pollution. @internal */
+export declare const STRIPE_CONTROLLED_KEYS: Set<string>;
+/** Prefix for user-defined fields in the proxy state map. @internal */
+export declare const FIELDS_PREFIX = "fields.";
+//# sourceMappingURL=constants.d.ts.map

package/dist/runtime/proxy/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/runtime/proxy/constants.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,eAAO,MAAM,sBAAsB,aAAqD,CAAC;AAEzF,uEAAuE;AACvE,eAAO,MAAM,aAAa,YAAY,CAAC"}

package/dist/runtime/proxy/fields-proxy.d.ts

@@ -0,0 +1,19 @@
+import type { _ProxyState } from '../types.js';
+import type { _RuntimeEventEmitter } from '../events.js';
+/**
+ * Creates a proxy over the fields object that tracks changes as "fields.key" updates.
+ * The getEventEmitter function allows for lazy/dynamic binding of the event emitter.
+ *
+ * When a property is read and its value is an object, a recursive nested proxy is
+ * returned so that mutations to any depth of sub-properties are recorded against
+ * the top-level fields key. Proxy instances are cached in a Map per top-level
+ * field so that repeated `.get` accesses return a stable reference.
+ *
+ * Array mutations (push, splice, index assignment) are tracked automatically because
+ * arrays are objects — the recursive `get` trap wraps the array in a proxy whose
+ * `set` trap fires on index assignment and on mutation-method internal writes.
+ *
+ * @internal
+ */
+export declare function createFieldsProxy<T extends Record<string, unknown>>(target: T, state: _ProxyState, getEventEmitter?: () => _RuntimeEventEmitter | undefined): T;
+//# sourceMappingURL=fields-proxy.d.ts.map

package/dist/runtime/proxy/fields-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields-proxy.d.ts","sourceRoot":"","sources":["../../../src/runtime/proxy/fields-proxy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAGzD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,MAAM,EAAE,CAAC,EACT,KAAK,EAAE,WAAW,EAClB,eAAe,CAAC,EAAE,MAAM,oBAAoB,GAAG,SAAS,GACvD,CAAC,CAoKH"}

package/dist/runtime/proxy/index.d.ts

@@ -0,0 +1,5 @@
+export type { _CreateProxyOptions, _ProxiedObject } from './types.js';
+export { _createInstanceProxy, _getProxyState, _commitProxyState, __hasPendingChanges, __queueSave, _getSlatedUpdates, _clearSlatedUpdates, _buildMethodResponse, setGlobalEventEmitter, getGlobalEventEmitter, } from './instance-proxy.js';
+export { createFieldsProxy } from './fields-proxy.js';
+export { STRIPE_CONTROLLED_KEYS, FIELDS_PREFIX } from './constants.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/proxy/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/proxy/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/runtime/proxy/instance-proxy.d.ts

@@ -0,0 +1,81 @@
+import { type _ProxyState } from '../types.js';
+import type { BaseObject } from '../base-object.js';
+import type { _RuntimeEventEmitter } from '../events.js';
+import type { _CreateProxyOptions, _ProxiedObject } from './types.js';
+/**
+ * Sets the global event emitter used during method execution.
+ *
+ * @internal
+ */
+export declare function setGlobalEventEmitter(emitter: _RuntimeEventEmitter | undefined): void;
+/**
+ * Gets the global event emitter, if set.
+ *
+ * @internal
+ */
+export declare function getGlobalEventEmitter(): _RuntimeEventEmitter | undefined;
+/**
+ * Creates a proxied custom object instance with change tracking.
+ *
+ * @internal
+ */
+export declare function _createInstanceProxy<T extends BaseObject>(instance: T, options?: _CreateProxyOptions): _ProxiedObject<T>;
+/**
+ * Extracts the proxy state from a proxied object.
+ * Returns undefined if the object is not proxied.
+ *
+ * @internal
+ */
+export declare function _getProxyState(obj: BaseObject): _ProxyState | undefined;
+/**
+ * Commits the proxy state: clears pending updates and updates the saved snapshot.
+ *
+ * @internal
+ */
+export declare function _commitProxyState(state: _ProxyState): void;
+/**
+ * Checks if a proxied object has pending changes.
+ *
+ * @internal
+ */
+export declare function __hasPendingChanges(obj: BaseObject): boolean;
+/**
+ * Flushes pending field changes into the proxy's slated-updates accumulator.
+ *
+ * Called by the auto-save code injected at the end of each `@Action` method.
+ * BaseObject.save() performs an equivalent flush directly via the shared
+ * _flushPendingToSlated helper.
+ *
+ * @internal
+ */
+export declare function __queueSave(obj: BaseObject): void;
+/**
+ * Returns a snapshot of the accumulated slated updates from save() or
+ * __queueSave() calls during an action. Callers should call
+ * _clearSlatedUpdates after reading to reset for the next invocation.
+ *
+ * @internal
+ */
+export declare function _getSlatedUpdates(obj: BaseObject): Record<string, unknown>;
+/**
+ * Clears the slated-updates accumulator on an instance.
+ *
+ * Called twice during executeMethod: once before the action (to ensure
+ * no stale state from a previous invocation leaks in) and once inside
+ * buildEnvelope after the accumulated updates have been read.
+ *
+ * @internal
+ */
+export declare function _clearSlatedUpdates(obj: BaseObject): void;
+/**
+ * Builds the ExecuteMethodResponse envelope for a completed action.
+ * Reads and clears the slated-updates accumulator, returning
+ * `{ methodReturnValue, updatedFields }`.
+ *
+ * @internal
+ */
+export declare function _buildMethodResponse(obj: BaseObject, methodReturnValue: unknown): {
+    methodReturnValue: unknown;
+    updatedFields: Record<string, unknown>;
+};
+//# sourceMappingURL=instance-proxy.d.ts.map

package/dist/runtime/proxy/instance-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-proxy.d.ts","sourceRoot":"","sources":["../../../src/runtime/proxy/instance-proxy.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,WAAW,EAEjB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAyCtE;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,oBAAoB,GAAG,SAAS,GAAG,IAAI,CAErF;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,oBAAoB,GAAG,SAAS,CAExE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,UAAU,EACvD,QAAQ,EAAE,CAAC,EACX,OAAO,CAAC,EAAE,mBAAmB,GAC5B,cAAc,CAAC,CAAC,CAAC,CAgKnB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,UAAU,GAAG,WAAW,GAAG,SAAS,CAEvE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAK1D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAG5D;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,CAajD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAG1E;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,CAKzD;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,UAAU,EACf,iBAAiB,EAAE,OAAO,GACzB;IAAE,iBAAiB,EAAE,OAAO,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAIxE"}

package/dist/runtime/proxy/types.d.ts

@@ -0,0 +1,25 @@
+import type { _ProxyState, _SaveHandler } from '../types.js';
+import type { _RuntimeEventEmitter } from '../events.js';
+/**
+ * Options for creating a proxied custom object instance.
+ *
+ * @internal
+ */
+export interface _CreateProxyOptions {
+    /** Event emitter for telemetry */
+    eventEmitter?: _RuntimeEventEmitter;
+    /** Save handler for persistence */
+    saveHandler?: _SaveHandler;
+}
+/**
+ * Result of creating a proxied instance.
+ *
+ * @internal
+ */
+export interface _ProxiedObject<T> {
+    /** The proxied instance */
+    proxy: T;
+    /** The proxy state for change tracking */
+    state: _ProxyState;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/runtime/proxy/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/runtime/proxy/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEzD;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,kCAAkC;IAClC,YAAY,CAAC,EAAE,oBAAoB,CAAC;IACpC,mCAAmC;IACnC,WAAW,CAAC,EAAE,YAAY,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,2BAA2B;IAC3B,KAAK,EAAE,CAAC,CAAC;IACT,0CAA0C;IAC1C,KAAK,EAAE,WAAW,CAAC;CACpB"}

package/dist/runtime/registry.d.ts

@@ -0,0 +1,40 @@
+import type { BaseObject } from './base-object.js';
+import type { _PlatformMetadata } from './types.js';
+/**
+ * Constructor type for custom object classes.
+ *
+ * @internal
+ */
+export interface _CustomObjectConstructor<T extends BaseObject = BaseObject> {
+    /** Constructs a new instance of the custom object class. */
+    new (): T;
+    /** Platform metadata attached by the `CustomObject` decorator at build time */
+    __platformMeta__?: _PlatformMetadata;
+}
+/**
+ * Registers a custom object class by its api name.
+ * Validates that the class has platform metadata attached.
+ *
+ * @internal
+ */
+export declare function _registerClass<T extends BaseObject>(constructor: _CustomObjectConstructor<T>): void;
+/**
+ * Retrieves a registered custom object constructor by api name.
+ *
+ * @internal
+ */
+export declare function _getRegisteredClass(apiName: string): _CustomObjectConstructor | undefined;
+/**
+ * Clears all registered classes.
+ * Primarily for testing.
+ *
+ * @internal
+ */
+export declare function _clearRegistry(): void;
+/**
+ * Returns all registered API names.
+ *
+ * @internal
+ */
+export declare function _getRegisteredApiNames(): string[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/runtime/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/runtime/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD;;;;GAIG;AACH,MAAM,WAAW,wBAAwB,CAAC,CAAC,SAAS,UAAU,GAAG,UAAU;IACzE,4DAA4D;IAC5D,QAAQ,CAAC,CAAC;IACV,+EAA+E;IAC/E,gBAAgB,CAAC,EAAE,iBAAiB,CAAC;CACtC;AAOD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,UAAU,EACjD,WAAW,EAAE,wBAAwB,CAAC,CAAC,CAAC,GACvC,IAAI,CASN;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,GACd,wBAAwB,GAAG,SAAS,CAEtC;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,EAAE,CAEjD"}

package/dist/runtime/symbol-helpers.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Gets a symbol-keyed property from an object.
+ * TypeScript's type system cannot express `Record<symbol, T>` lookups without a cast;
+ * centralizing the cast here keeps all other call sites lint-clean.
+ *
+ * @internal
+ */
+export declare function getSymbolProp<T>(obj: object, sym: symbol): T | undefined;
+/**
+ * Sets a symbol-keyed property on an object.
+ * TypeScript's type system cannot express `Record<symbol, T>` assignments without a cast;
+ * centralizing the cast here keeps all other call sites lint-clean.
+ *
+ * @internal
+ */
+export declare function setSymbolProp(obj: object, sym: symbol, value: unknown): void;
+//# sourceMappingURL=symbol-helpers.d.ts.map

package/dist/runtime/symbol-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbol-helpers.d.ts","sourceRoot":"","sources":["../../src/runtime/symbol-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,wBAAgB,aAAa,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;AAO1E;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAG5E"}