@stripe/extensibility-tool-utils 0.6.2

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/cli/cli-ux.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Thin output abstraction used by CLI entry points and the functions they call.
+ *
+ * Inject a `_CliUx` constructed with `PassThrough` streams in tests to capture
+ * output without spying on `process.stdout`/`process.stderr`.
+ *
+ * @internal
+ */
+export declare class _CliUx {
+    #private;
+    constructor(options?: {
+        /** Stream for product output (defaults to process.stdout). */
+        readonly stdout?: NodeJS.WritableStream;
+        /** Stream for status/error output (defaults to process.stderr). */
+        readonly stderr?: NodeJS.WritableStream;
+    });
+    /** Write a product output line to stdout (or the configured stream). */
+    print(message: string): void;
+    /** Write a status/progress line to stderr (or the configured stream). */
+    log(message: string): void;
+    /**
+     * Error message to **stderr** (or the configured stderr stream).
+     *
+     * Behaviorally identical to {@link _CliUx.log} today. Use `error()` for failures
+     * and `log()` for progress/status — the distinction supports future
+     * formatting differentiation (color, prefixes, severity filtering).
+     */
+    error(message: string): void;
+}
+//# sourceMappingURL=cli-ux.d.ts.map

package/dist/cli/cli-ux.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-ux.d.ts","sourceRoot":"","sources":["../../src/cli/cli-ux.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,qBAAa,MAAM;;gBAIL,OAAO,CAAC,EAAE;QACpB,8DAA8D;QAC9D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;QACxC,mEAAmE;QACnE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;KACzC;IAKD,wEAAwE;IACxE,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI5B,yEAAyE;IACzE,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI1B;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAG7B"}

package/dist/cli/context.d.ts

@@ -0,0 +1,24 @@
+import { _CliUx } from './cli-ux.js';
+/**
+ * Shared context threaded through CLI operations.
+ *
+ * Carry this through call chains so that output can be redirected in tests
+ * without patching global `process.stdout`/`process.stderr`.
+ *
+ * @internal
+ */
+export interface _CliContext {
+    /** Output abstraction for writing to stdout/stderr. */
+    readonly ux: _CliUx;
+}
+/**
+ * Create a `_CliContext` with default or injected collaborators.
+ *
+ * @param options - Optional options. Pass a pre-constructed `_CliUx` to redirect output
+ *   streams (e.g., for testing or RPC transports that must not write to stdout).
+ * @internal
+ */
+export declare function _createCliContext(options?: {
+    ux?: _CliUx;
+}): _CliContext;
+//# sourceMappingURL=context.d.ts.map

package/dist/cli/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/cli/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW;IAC1B,uDAAuD;IACvD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,WAAW,CAExE"}

package/dist/cli/guards.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Reusable type guards for CLI argument validation.
+ *
+ * @internal
+ */
+/**
+ * Returns `true` if `value` is a non-null, non-array object.
+ * @internal
+ */
+export declare function _isRecord(value: unknown): value is Record<string, unknown>;
+/**
+ * Higher-order type guard that checks every value in a record satisfies a
+ * predicate.
+ *
+ * @example
+ * ```ts
+ * const isStringRecord = _isRecordWithValueType(
+ *   (v): v is string => typeof v === 'string'
+ * );
+ * ```
+ * @internal
+ */
+export declare function _isRecordWithValueType<T>(guard: (v: unknown) => v is T): (value: unknown) => value is Record<string, T>;
+//# sourceMappingURL=guards.d.ts.map

package/dist/cli/guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../src/cli/guards.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE1E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EACtC,KAAK,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,CAAC,IAAI,CAAC,GAC5B,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAKhD"}

package/dist/cli/index.d.ts

@@ -0,0 +1,6 @@
+export { _CliUx } from './cli-ux.js';
+export type { _CliContext } from './context.js';
+export { _createCliContext } from './context.js';
+export { _writeJsonOutput } from './output-path.js';
+export { _isRecord, _isRecordWithValueType } from './guards.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC"}

package/dist/cli/output-path.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Write a JSON result to the given file path, or no-op if no path is provided.
+ *
+ * Used by CLI binaries that support `--output-path <file>` for structured
+ * output. When the flag is omitted the caller handles human-readable output
+ * to stdout instead.
+ *
+ * @internal
+ */
+export declare function _writeJsonOutput(outputPath: string | undefined, data: unknown): void;
+//# sourceMappingURL=output-path.d.ts.map

package/dist/cli/output-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-path.d.ts","sourceRoot":"","sources":["../../src/cli/output-path.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAGpF"}

package/dist/extensibility-tool-utils-alpha.d.ts

@@ -0,0 +1,383 @@
+/**
+ * `@stripe/extensibility-tool-utils`
+ *
+ * Internal standalone utilities shared across Stripe extensibility tooling.
+ *
+ * @packageDocumentation
+ * @internal
+ */
+
+import type { MetadataInferenceContext } from '@formspec/core';
+import type { MetadataPolicyInput } from '@formspec/core';
+import pino from 'pino';
+
+/**
+ * Branded string types with validating smart constructors.
+ *
+ * Brands use symbol keys so they do not appear in IDE autocomplete
+ * (per project convention).
+ */
+declare const __semverRangeBrand: unique symbol;
+
+/** A well-formed semver version string (e.g. `"1.2.3"`, `"4.0.0-rc.1"`). */
+declare const __semverVersionBrand: unique symbol;
+
+/* Excluded from this release type: _AfterExecuteResult */
+
+/* Excluded from this release type: _ApiExtractorConfig */
+
+/* Excluded from this release type: _ApiExtractorDoc */
+
+/* Excluded from this release type: _ApiNameValidationResult */
+
+/* Excluded from this release type: _Assertion */
+
+/* Excluded from this release type: _AssertionContext */
+
+/* Excluded from this release type: _AssertionError */
+
+/* Excluded from this release type: _AssertOpts */
+
+/* Excluded from this release type: _AsyncAssertion */
+
+/* Excluded from this release type: _BeforeExecuteResult */
+
+/* Excluded from this release type: _beginTransaction */
+
+/* Excluded from this release type: _canonicalNormalize */
+
+/* Excluded from this release type: _canonicalStringify */
+
+/* Excluded from this release type: _check */
+
+/* Excluded from this release type: _CliContext */
+
+/* Excluded from this release type: _CliUx */
+
+/* Excluded from this release type: _CommitOptions */
+
+/* Excluded from this release type: _CommitReport */
+
+/* Excluded from this release type: _compilePointer */
+
+/* Excluded from this release type: _CompilerOptionKey */
+
+/* Excluded from this release type: _CompilerOptions */
+
+/* Excluded from this release type: _CompilerOptionValue */
+
+/* Excluded from this release type: _compositeGenerator */
+
+/* Excluded from this release type: _ConfirmationPolicy */
+
+/* Excluded from this release type: _Conflict */
+
+/* Excluded from this release type: _ConflictAbortedError */
+
+/* Excluded from this release type: _ConflictError */
+
+/* Excluded from this release type: _ConflictPolicy */
+
+/* Excluded from this release type: _ConflictResolution */
+
+/* Excluded from this release type: _ConflictResolver */
+
+/* Excluded from this release type: _createCliContext */
+
+/* Excluded from this release type: _createFilesystemTemplateFS */
+
+/* Excluded from this release type: _createInMemoryTemplateFS */
+
+/* Excluded from this release type: _createLogger */
+
+/* Excluded from this release type: _createSimpleSingleFileTemplate */
+
+/* Excluded from this release type: _createSimpleTemplate */
+
+/* Excluded from this release type: _defaultMeta */
+
+/* Excluded from this release type: _DepKind */
+
+/* Excluded from this release type: _detectFormat */
+
+/* Excluded from this release type: _detectMeta */
+
+/* Excluded from this release type: _Diagnostic */
+
+/* Excluded from this release type: _DiffHunk */
+
+/* Excluded from this release type: _diffHunks */
+
+/* Excluded from this release type: _DiffLine */
+
+/* Excluded from this release type: _DiffOptions */
+
+/* Excluded from this release type: _diffUnified */
+
+/* Excluded from this release type: _Document */
+
+/* Excluded from this release type: _escapeToken */
+
+/* Excluded from this release type: _FileEditorError */
+
+/* Excluded from this release type: _FileWriteOutcome */
+
+/* Excluded from this release type: _fingerprint */
+
+/* Excluded from this release type: _Format */
+
+/* Excluded from this release type: _FormatAdapter */
+
+/* Excluded from this release type: _FormatMeta */
+
+/* Excluded from this release type: _FormatNotSupportedError */
+
+/* Excluded from this release type: _FsCentralManifestStore */
+
+/* Excluded from this release type: _FsCentralManifestStoreOptions */
+
+/* Excluded from this release type: _GeneratedFile */
+
+/* Excluded from this release type: _Generator */
+
+/* Excluded from this release type: _GeneratorContext */
+
+/* Excluded from this release type: _GeneratorDefectError */
+
+/* Excluded from this release type: _GeneratorExecuteContext */
+
+/* Excluded from this release type: _GeneratorExecuteResult */
+
+/* Excluded from this release type: _GeneratorInputError */
+
+/* Excluded from this release type: _GeneratorPlanResult */
+
+/* Excluded from this release type: _GeneratorRunner */
+
+/* Excluded from this release type: _GeneratorWriteResult */
+
+/* Excluded from this release type: _getAdapter */
+
+/* Excluded from this release type: _hasPointer */
+
+/* Excluded from this release type: _inferStripeApiName */
+
+/* Excluded from this release type: _InMemoryStateStore */
+
+/* Excluded from this release type: _InMemoryTemplateFS */
+
+/* Excluded from this release type: _isRecord */
+
+/* Excluded from this release type: _isRecordWithValueType */
+
+/* Excluded from this release type: _isSemverRange */
+
+/* Excluded from this release type: _isSemverVersion */
+
+/* Excluded from this release type: _IsUnknown */
+
+/* Excluded from this release type: _jsonAdapter */
+
+/* Excluded from this release type: _jsoncAdapter */
+
+/* Excluded from this release type: _JsonPointer */
+
+/* Excluded from this release type: _LoggerOptions */
+
+/* Excluded from this release type: _LogLevel */
+
+/* Excluded from this release type: _looksPlural */
+
+/* Excluded from this release type: _looksSingular */
+
+/* Excluded from this release type: _MergeOptions */
+
+/* Excluded from this release type: _MutationOptions */
+
+/* Excluded from this release type: _NarrowedElement */
+
+/* Excluded from this release type: _NarrowedPartial */
+
+/* Excluded from this release type: _NarrowedValue */
+
+/* Excluded from this release type: _openApiExtractor */
+
+/* Excluded from this release type: _openDocument */
+
+/* Excluded from this release type: _openDocumentFromDisk */
+
+/* Excluded from this release type: _OpenDocumentOptions */
+
+/* Excluded from this release type: _openPackageJson */
+
+/* Excluded from this release type: _openStripeAppManifest */
+
+/* Excluded from this release type: _openTsConfig */
+
+/* Excluded from this release type: _PackageJson */
+
+/* Excluded from this release type: _PackageJsonDoc */
+
+/* Excluded from this release type: _parseArrayIndex */
+
+/* Excluded from this release type: _ParseError */
+
+/* Excluded from this release type: _parseLogLevel */
+
+/* Excluded from this release type: _parsePointer */
+
+/* Excluded from this release type: _PathError */
+
+/* Excluded from this release type: _PendingEdit */
+
+/* Excluded from this release type: _PlannedFile */
+
+/* Excluded from this release type: _pointer */
+
+/* Excluded from this release type: _POINTER_STRING */
+
+/* Excluded from this release type: _PointerBuilder */
+
+/* Excluded from this release type: _PointerSegments */
+
+/* Excluded from this release type: _ProjectExecuteContext */
+
+/* Excluded from this release type: _ProjectGeneratorContext */
+
+/* Excluded from this release type: _registerFormatAdapter */
+
+/* Excluded from this release type: _resolvePointer */
+
+/* Excluded from this release type: _runAssertions */
+
+/* Excluded from this release type: _runAsyncAssertions */
+
+/* Excluded from this release type: _SchemaValidationError */
+
+/* Excluded from this release type: _SemverRange */
+
+/* Excluded from this release type: _semverRange */
+
+/* Excluded from this release type: _SemverVersion */
+
+/* Excluded from this release type: _semverVersion */
+
+/* Excluded from this release type: _Severity */
+
+/* Excluded from this release type: _sha256Hex */
+
+/* Excluded from this release type: _SingleTemplateManager */
+
+/* Excluded from this release type: _SplitPointer */
+
+/* Excluded from this release type: _SplitRest */
+
+/* Excluded from this release type: _StandaloneExecuteContext */
+
+/* Excluded from this release type: _StandaloneGeneratorContext */
+
+/* Excluded from this release type: _StandardSchemaV1 */
+
+/* Excluded from this release type: _StateRecord */
+
+/* Excluded from this release type: _StateStore */
+
+/* Excluded from this release type: _StepInto */
+
+/* Excluded from this release type: _StripeAppManifest */
+
+/* Excluded from this release type: _StripeAppManifestDoc */
+
+/* Excluded from this release type: _stripeMetadataPolicy */
+
+/* Excluded from this release type: _StripePermission */
+
+/* Excluded from this release type: _Template */
+
+/* Excluded from this release type: _TemplateContext */
+
+/* Excluded from this release type: _TemplateFS */
+
+/* Excluded from this release type: _TemplateFSImageEntry */
+
+/* Excluded from this release type: _TemplateManager */
+
+/* Excluded from this release type: _TemplateOutput */
+
+/* Excluded from this release type: _toCapitalized */
+
+/* Excluded from this release type: _tokenizeIdentifier */
+
+/* Excluded from this release type: _toPascalCase */
+
+/* Excluded from this release type: _toPlural */
+
+/* Excluded from this release type: _toSentenceDisplayName */
+
+/* Excluded from this release type: _toSingular */
+
+/* Excluded from this release type: _toSnakeCase */
+
+/* Excluded from this release type: _toStripeApiCase */
+
+/* Excluded from this release type: _Transaction */
+
+/* Excluded from this release type: _TransactionOptions */
+
+/* Excluded from this release type: _truncateName */
+
+/* Excluded from this release type: _tryParseSemverRange */
+
+/* Excluded from this release type: _tryParseSemverVersion */
+
+/* Excluded from this release type: _tryValidateWithSchema */
+
+/* Excluded from this release type: _TsConfig */
+
+/* Excluded from this release type: _TsConfigDoc */
+
+/* Excluded from this release type: _TsJsx */
+
+/* Excluded from this release type: _TsModule */
+
+/* Excluded from this release type: _TsModuleResolution */
+
+/* Excluded from this release type: _TsTarget */
+
+/* Excluded from this release type: _TypeMismatchError */
+
+/* Excluded from this release type: _UnescapeToken */
+
+/* Excluded from this release type: _unescapeToken */
+
+/* Excluded from this release type: _validateApiName */
+
+/* Excluded from this release type: _validateDisplayName */
+
+/* Excluded from this release type: _validateWithSchema */
+
+/* Excluded from this release type: _ValueAtPointer */
+
+/* Excluded from this release type: _ValueAtSegments */
+
+/* Excluded from this release type: _workspaceVersion */
+
+/* Excluded from this release type: _WriteAbortedError */
+
+/* Excluded from this release type: _WriteCapability */
+
+/* Excluded from this release type: _WriteConfirm */
+
+/* Excluded from this release type: _WriteDecision */
+
+/* Excluded from this release type: _WriteError */
+
+/* Excluded from this release type: _writeJsonOutput */
+
+/* Excluded from this release type: _WriteReason */
+
+/* Excluded from this release type: _WriteRequest */
+
+/* Excluded from this release type: _yamlAdapter */
+
+export { }