@el-j/google-sheet-translations 2.2.0 → 3.0.0-beta.2

package/dist/migration/migrateV3.d.ts

@@ -0,0 +1,57 @@
+import type { ProviderRuntimeConfig } from '../providers/config';
+/**
+ * Options controlling the automated migration from v2 to v3 provider architecture.
+ */
+export interface MigrateV3Options {
+    /** Root directory of the project being migrated. Defaults to process.cwd(). */
+    projectRoot?: string;
+    /** Relative destination path for generated provider config JSON (defaults to 'provider.config.json'). */
+    providerConfigPath?: string;
+    /** Preview changes without writing any files. */
+    dryRun?: boolean;
+    /** Rewrite legacy `uses: el-j/google-sheet-translations@...` workflow steps to `provider-config-path` mode. */
+    writeWorkflows?: boolean;
+    /** Overwrite an existing provider config file at `providerConfigPath` instead of warning and skipping. */
+    force?: boolean;
+    /** Cross-check the generated provider config against the legacy option mapping and report any drift. */
+    parityCheck?: boolean;
+}
+/** Result of comparing the generated provider config against {@link mapLegacyGoogleOptionsToProviderConfig}. */
+export interface MigrationParityCheck {
+    passed: boolean;
+    differences: string[];
+    expectedConfig: ProviderRuntimeConfig;
+}
+/**
+ * Summary of actions taken and files modified during v3 project migration.
+ */
+export interface MigrateV3Result {
+    /** Resolved project root directory. */
+    projectRoot: string;
+    /** Relative path to the generated provider configuration file. */
+    providerConfigPath: string;
+    /** Concrete runtime configuration object generated from existing project setup. */
+    providerConfig: ProviderRuntimeConfig;
+    /** Paths of GitHub Actions workflows containing legacy configurations found. */
+    legacyWorkflowsFound: string[];
+    /** Paths of workflows rewritten to reference provider-config-path. */
+    rewrittenWorkflows: string[];
+    /** Paths of newly created files on disk. */
+    createdFiles: string[];
+    /** Warning messages produced during migration (e.g. conflicting settings). */
+    warnings: string[];
+    /** Detailed parity check outcome when parityCheck option was enabled. */
+    parityCheck?: MigrationParityCheck;
+}
+/**
+ * Auto-migrates a project from the legacy GitHub Action inputs to the v3 provider
+ * runtime: scans `.github/workflows/*.yml` for steps using the legacy action inputs,
+ * generates a {@link ProviderRuntimeConfig} from the first legacy step found, writes
+ * it to `providerConfigPath` (unless it already exists and `force` is not set), and —
+ * when `writeWorkflows` is set — rewrites each matching step in place to reference
+ * that config file instead of the legacy inputs. Workflows using Drive-folder mode
+ * (which has no v3 equivalent yet) are left untouched with a warning rather than
+ * being rewritten. Throws if no workflow files exist, or if none use the legacy action.
+ */
+export declare function migrateProjectToV3(options?: MigrateV3Options): MigrateV3Result;
+//# sourceMappingURL=migrateV3.d.ts.map

package/dist/migration/migrateV3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrateV3.d.ts","sourceRoot":"","sources":["../../src/migration/migrateV3.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAIjE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yGAAyG;IACzG,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iDAAiD;IACjD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,+GAA+G;IAC/G,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,0GAA0G;IAC1G,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wGAAwG;IACxG,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,gHAAgH;AAChH,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,cAAc,EAAE,qBAAqB,CAAC;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mFAAmF;IACnF,cAAc,EAAE,qBAAqB,CAAC;IACtC,gFAAgF;IAChF,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,sEAAsE;IACtE,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,4CAA4C;IAC5C,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,yEAAyE;IACzE,WAAW,CAAC,EAAE,oBAAoB,CAAC;CACpC;AA4TD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,gBAAqB,GAAG,eAAe,CAwGlF"}

package/dist/providers/assetContracts.d.ts

@@ -0,0 +1,88 @@
+import type { ProviderCapabilitySet } from './capabilities';
+/**
+ * Provider-side contracts for binary/static asset handling, parallel to the
+ * table-oriented contracts in {@link ./contracts}. An asset provider deals in
+ * files described by a manifest rather than translation rows.
+ */
+export type AssetProviderKind = 'asset-input' | 'asset-output' | 'asset-sync';
+/** One file entry in an asset manifest: where it lives locally/remotely and where it should land. */
+export interface CanonicalAssetEntry {
+    assetId: string;
+    /** Destination path relative to the sync target directory. */
+    relativePath: string;
+    /** SHA-256 hash, if already known; used to dedupe fetches across entries. */
+    hash?: string;
+    sourceUrl?: string;
+    sourcePath?: string;
+    modifiedTime?: string;
+    sizeBytes?: number;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Result returned when retrieving an asset manifest.
+ */
+export interface AssetManifestResult {
+    /** List of asset entries contained in the manifest. */
+    assets: CanonicalAssetEntry[];
+    /** Optional manifest-level metadata. */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Parameters for performing an asset synchronization operation.
+ */
+export interface AssetSyncRequest {
+    /** Local target directory where assets will be synchronized. */
+    targetDirectory: string;
+    /** When true, local files under `targetDirectory` not named in the manifest are deleted. */
+    deleteMissing?: boolean;
+    /** Optional abort signal for early cancellation. */
+    signal?: AbortSignal;
+}
+/**
+ * Statistics and affected paths resulting from an asset sync execution.
+ */
+export interface AssetSyncResult {
+    /** Total number of assets listed in the input manifest. */
+    manifestCount: number;
+    /** Relative paths of assets downloaded fresh. */
+    downloaded: string[];
+    /** Relative paths of assets modified / updated. */
+    updated: string[];
+    /** Relative paths of orphaned local assets deleted (when deleteMissing was true). */
+    deleted: string[];
+    /** Relative paths of unchanged assets skipped due to matching hash or size. */
+    skipped: string[];
+    /** Optional provider-specific execution metadata. */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Common metadata attributes shared across all asset provider interfaces.
+ */
+export interface AssetProviderMetadata {
+    /** Unique provider identifier (e.g. 'cryptpad-assets'). */
+    providerId: string;
+    /** Human-readable provider name. */
+    displayName: string;
+    /** Capability set declaring which asset operations are supported. */
+    capabilities: ProviderCapabilitySet;
+}
+/** An asset provider that can list a manifest of assets available to read. */
+export interface AssetInputProvider extends AssetProviderMetadata {
+    kind: 'asset-input';
+    readAssetManifest(): Promise<AssetManifestResult>;
+}
+/** An asset provider that can write a given manifest of assets to a target directory. */
+export interface AssetOutputProvider extends AssetProviderMetadata {
+    kind: 'asset-output';
+    writeAssets(manifest: CanonicalAssetEntry[], targetDirectory: string): Promise<AssetSyncResult>;
+}
+/**
+ * An asset provider that owns both reading its manifest and syncing assets to a
+ * target directory in one call. This is the shape used by the CryptPad asset
+ * sync provider and by {@link ProviderPipelineOptions.assetSyncProvider}.
+ */
+export interface AssetSyncProvider extends AssetProviderMetadata {
+    kind: 'asset-sync';
+    syncAssets(request: AssetSyncRequest): Promise<AssetSyncResult>;
+}
+//# sourceMappingURL=assetContracts.d.ts.map

package/dist/providers/assetContracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assetContracts.d.ts","sourceRoot":"","sources":["../../src/providers/assetContracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE5D;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,aAAa,GAAG,cAAc,GAAG,YAAY,CAAC;AAE9E,qGAAqG;AACrG,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,YAAY,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,uDAAuD;IACvD,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gEAAgE;IAChE,eAAe,EAAE,MAAM,CAAC;IACxB,4FAA4F;IAC5F,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,oDAAoD;IACpD,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2DAA2D;IAC3D,aAAa,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,mDAAmD;IACnD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,qFAAqF;IACrF,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,+EAA+E;IAC/E,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,YAAY,EAAE,qBAAqB,CAAC;CACrC;AAED,8EAA8E;AAC9E,MAAM,WAAW,kBAAmB,SAAQ,qBAAqB;IAC/D,IAAI,EAAE,aAAa,CAAC;IACpB,iBAAiB,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACnD;AAED,yFAAyF;AACzF,MAAM,WAAW,mBAAoB,SAAQ,qBAAqB;IAChE,IAAI,EAAE,cAAc,CAAC;IACrB,WAAW,CAAC,QAAQ,EAAE,mBAAmB,EAAE,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CACjG;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAkB,SAAQ,qBAAqB;IAC9D,IAAI,EAAE,YAAY,CAAC;IACnB,UAAU,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CACjE"}

package/dist/providers/capabilities.d.ts

@@ -0,0 +1,50 @@
+/**
+ * The full set of capability flags a provider can declare. A provider that
+ * doesn't support an operation simply leaves the corresponding flag `false`
+ * (see {@link EMPTY_PROVIDER_CAPABILITIES}), rather than omitting it.
+ */
+export declare const PROVIDER_CAPABILITIES: readonly ['readTables', 'writeTables', 'syncBack', 'readAssets', 'writeAssets', 'autoTranslateFormula', 'discoverByFolder', 'assetSync', 'publicReadNoAuth'];
+/**
+ * Union of capability flag identifiers supported by the provider platform.
+ */
+export type ProviderCapability = (typeof PROVIDER_CAPABILITIES)[number];
+/**
+ * Record mapping each {@link ProviderCapability} to a boolean indicating whether it is supported.
+ */
+export type ProviderCapabilitySet = Record<ProviderCapability, boolean>;
+/**
+ * Baseline capability set where all capabilities are explicitly disabled (`false`).
+ */
+export declare const EMPTY_PROVIDER_CAPABILITIES: ProviderCapabilitySet;
+/**
+ * A named pipeline operation (e.g. "read-input") that requires one or more
+ * capabilities to be present before it can run. See {@link OPERATION_CAPABILITY_REQUIREMENTS}.
+ */
+export type ProviderOperation = 'read-input' | 'write-output' | 'sync-back' | 'read-assets' | 'write-assets' | 'discover-sources' | 'sync-assets' | 'public-read';
+/**
+ * Mapping defining which capabilities are mandatory for each {@link ProviderOperation}.
+ */
+export declare const OPERATION_CAPABILITY_REQUIREMENTS: Record<ProviderOperation, ProviderCapability[]>;
+/**
+ * Builds a full {@link ProviderCapabilitySet}, defaulting every unspecified
+ * capability to `false`. Provider factories use this so they only need to
+ * name the capabilities they actually support.
+ */
+export declare function createCapabilitySet(overrides?: Partial<ProviderCapabilitySet>): ProviderCapabilitySet;
+/** Returns the subset of `required` that `capabilities` does not have set to `true`. */
+export declare function missingCapabilities(capabilities: ProviderCapabilitySet, required: ProviderCapability[]): ProviderCapability[];
+/** Returns `true` only if every capability in `required` is set to `true` on `capabilities`. */
+export declare function hasRequiredCapabilities(capabilities: ProviderCapabilitySet, required: ProviderCapability[]): boolean;
+/**
+ * Throws a descriptive error naming `providerName`, `operation` (if given), and every
+ * missing capability, unless `capabilities` already satisfies all of `required`.
+ */
+export declare function assertRequiredCapabilities(providerName: string, capabilities: ProviderCapabilitySet, required: ProviderCapability[], operation?: string): void;
+/**
+ * Convenience wrapper around {@link assertRequiredCapabilities} that looks up the
+ * required capabilities for a named {@link ProviderOperation} via
+ * {@link OPERATION_CAPABILITY_REQUIREMENTS}. This is the gate every pipeline stage
+ * (read/write/sync/asset-sync/discovery) runs through before it executes.
+ */
+export declare function assertOperationCapabilities(providerName: string, capabilities: ProviderCapabilitySet, operation: ProviderOperation): void;
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/providers/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/providers/capabilities.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,YAChC,YAAY,EACZ,aAAa,EACb,UAAU,EACV,YAAY,EACZ,aAAa,EACb,sBAAsB,EACtB,kBAAkB,EAClB,WAAW,EACX,kBAAkB,CACV,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,qBAUzC,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GACzB,YAAY,GACZ,cAAc,GACd,WAAW,GACX,aAAa,GACb,cAAc,GACd,kBAAkB,GAClB,aAAa,GACb,aAAa,CAAC;AAElB;;GAEG;AACH,eAAO,MAAM,iCAAiC,EAAE,MAAM,CAAC,iBAAiB,EAAE,kBAAkB,EAAE,CAS7F,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,GAAE,OAAO,CAAC,qBAAqB,CAAM,GAC7C,qBAAqB,CAKvB;AAED,wFAAwF;AACxF,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,qBAAqB,EACnC,QAAQ,EAAE,kBAAkB,EAAE,GAC7B,kBAAkB,EAAE,CAEtB;AAED,gGAAgG;AAChG,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,qBAAqB,EACnC,QAAQ,EAAE,kBAAkB,EAAE,GAC7B,OAAO,CAET;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,qBAAqB,EACnC,QAAQ,EAAE,kBAAkB,EAAE,EAC9B,SAAS,CAAC,EAAE,MAAM,GACjB,IAAI,CAQN;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,qBAAqB,EACnC,SAAS,EAAE,iBAAiB,GAC3B,IAAI,CAON"}

package/dist/providers/catalog.d.ts

@@ -0,0 +1,73 @@
+import type { ProviderCapabilitySet } from './capabilities';
+/**
+ * Classification of a discoverable resource within a provider catalog.
+ */
+export type ProviderSourceKind = 'table' | 'asset';
+/**
+ * Metadata descriptor describing a discoverable data source (sheet, table, or asset manifest).
+ */
+export interface ProviderSourceDescriptor {
+    /** Identifier of the provider that can read this source. */
+    providerId: string;
+    /** Unique identifier of the specific resource / document. */
+    sourceId: string;
+    /** Kind of resource represented by this descriptor. */
+    kind: ProviderSourceKind;
+    /** Human-readable display title or filename. */
+    name: string;
+    /** Additional provider-specific metadata (e.g. URLs, mime types). */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Filter and cancellation options for catalog source discovery.
+ */
+export interface ProviderDiscoveryRequest {
+    /** Optional search query or filter string. */
+    query?: string;
+    /** Optional cancellation signal. */
+    signal?: AbortSignal;
+}
+/**
+ * Result returned by a catalog source discovery operation.
+ */
+export interface ProviderDiscoveryResult {
+    /** Discovered source descriptors matching the request. */
+    sources: ProviderSourceDescriptor[];
+    /** Optional diagnostic or pagination metadata. */
+    metadata?: Record<string, unknown>;
+}
+/** A discovery-only provider: it lists available sources, but doesn't read/write/sync them itself. */
+export interface ProviderCatalogProvider {
+    kind: 'catalog';
+    providerId: string;
+    displayName: string;
+    capabilities: ProviderCapabilitySet;
+    discoverSources(request?: ProviderDiscoveryRequest): Promise<ProviderDiscoveryResult>;
+}
+/**
+ * Options for configuring an in-memory {@link ProviderCatalogProvider}.
+ */
+export interface InMemoryProviderCatalogOptions {
+    /** Custom provider identifier. Defaults to 'in-memory-catalog'. */
+    providerId?: string;
+    /** Custom human-friendly provider name. */
+    displayName?: string;
+    /** Fixed list of sources returned during discovery. */
+    sources: ProviderSourceDescriptor[];
+}
+/**
+ * Creates a {@link ProviderCatalogProvider} backed by a static, in-memory list of
+ * sources. `discoverSources({ query })` filters that list by substring match against
+ * each source's id, name, and kind (case-insensitive); an empty/absent query returns
+ * every source.
+ */
+export declare function createInMemoryProviderCatalogProvider(options: InMemoryProviderCatalogOptions): ProviderCatalogProvider;
+/**
+ * The built-in catalog listing every provider source shipped with this package
+ * (Google Drive folder discovery, CryptPad CSV export URL, CryptPad asset manifest).
+ * Each entry is descriptive metadata only — actually reading from a discovered
+ * source still goes through the matching input/output/sync/asset-sync provider
+ * factory (see {@link createProvidersFromRuntimeConfig}).
+ */
+export declare function createDefaultProviderCatalog(): ProviderCatalogProvider;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/providers/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/providers/catalog.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,OAAO,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,IAAI,EAAE,kBAAkB,CAAC;IACzB,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,0DAA0D;IAC1D,OAAO,EAAE,wBAAwB,EAAE,CAAC;IACpC,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,sGAAsG;AACtG,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,qBAAqB,CAAC;IACpC,eAAe,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;CACvF;AAED;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,OAAO,EAAE,wBAAwB,EAAE,CAAC;CACrC;AAED;;;;;GAKG;AACH,wBAAgB,qCAAqC,CACnD,OAAO,EAAE,8BAA8B,GACtC,uBAAuB,CAwBzB;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,IAAI,uBAAuB,CA4BtE"}

package/dist/providers/config.d.ts

@@ -0,0 +1,56 @@
+import type { SpreadsheetOptions } from '../utils/configurationHandler';
+/**
+ * A single provider slot: which provider implementation to instantiate
+ * (e.g. "google-sheets", "cryptpad-csv") and the options to pass to its factory.
+ */
+export interface ProviderReferenceConfig {
+    provider: string;
+    options?: Record<string, unknown>;
+}
+/**
+ * Declarative runtime configuration consumed by {@link createProvidersFromRuntimeConfig}.
+ * Only `input` is required; `output`, `sync`, and `assetSync` are opt-in per pipeline run.
+ */
+export interface ProviderRuntimeConfig {
+    input: ProviderReferenceConfig;
+    output?: ProviderReferenceConfig;
+    sync?: ProviderReferenceConfig;
+    /** Optional asset-sync provider slot (e.g. "cryptpad-assets"). See {@link AssetSyncProvider}. */
+    assetSync?: ProviderReferenceConfig;
+}
+/**
+ * Outcome returned by {@link validateProviderRuntimeConfig}.
+ */
+export interface ProviderConfigValidationResult {
+    /** True when the configuration satisfies all syntactic and structural requirements. */
+    valid: boolean;
+    /** List of validation error messages encountered during inspection. */
+    errors: string[];
+}
+/**
+ * Result returned when mapping legacy spreadsheet options to a v3 provider runtime configuration.
+ */
+export interface LegacyConfigMappingResult {
+    /** Generated modern provider runtime configuration. */
+    config: ProviderRuntimeConfig;
+    /** Explanatory deprecation warnings advising migration steps. */
+    deprecations: string[];
+}
+/**
+ * Validates the shape of an untrusted runtime config value (typically parsed from JSON)
+ * before it is trusted as a {@link ProviderRuntimeConfig}. Collects every error found
+ * rather than failing on the first one, so a config file can be fixed in one pass.
+ */
+export declare function validateProviderRuntimeConfig(config: unknown): ProviderConfigValidationResult;
+/**
+ * Maps legacy Google-first options to the provider runtime schema.
+ * This enables v3 adoption without forcing immediate option rewrites.
+ */
+export declare function mapLegacyGoogleOptionsToProviderConfig(options?: SpreadsheetOptions): LegacyConfigMappingResult;
+/**
+ * Validates `config` and returns it typed as {@link ProviderRuntimeConfig}, or throws
+ * with all collected validation errors joined into a single message. Use this at
+ * process boundaries (CLI, Action inputs) where a throw-on-invalid contract is wanted.
+ */
+export declare function assertValidProviderRuntimeConfig(config: unknown): ProviderRuntimeConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/providers/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/providers/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAExE;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,uBAAuB,CAAC;IAC/B,MAAM,CAAC,EAAE,uBAAuB,CAAC;IACjC,IAAI,CAAC,EAAE,uBAAuB,CAAC;IAC/B,iGAAiG;IACjG,SAAS,CAAC,EAAE,uBAAuB,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,uFAAuF;IACvF,KAAK,EAAE,OAAO,CAAC;IACf,uEAAuE;IACvE,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,uDAAuD;IACvD,MAAM,EAAE,qBAAqB,CAAC;IAC9B,iEAAiE;IACjE,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAMD;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,OAAO,GAAG,8BAA8B,CA6D7F;AAED;;;GAGG;AACH,wBAAgB,sCAAsC,CACpD,OAAO,GAAE,kBAAuB,GAC/B,yBAAyB,CAmC3B;AAED;;;;GAIG;AACH,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,OAAO,GAAG,qBAAqB,CAMvF"}

package/dist/providers/contracts.d.ts

@@ -0,0 +1,138 @@
+import type { SheetRow, TranslationData } from '../types';
+import type { ProviderCapabilitySet } from './capabilities';
+/**
+ * Role played by a translation provider in the pipeline.
+ */
+export type ProviderKind = 'input' | 'output' | 'sync';
+/**
+ * Common metadata attributes implemented by all translation providers.
+ */
+export interface ProviderMetadata {
+    /** Unique provider identifier (e.g. 'google-sheets', 'cryptpad-csv'). */
+    providerId: string;
+    /** Human-readable provider name. */
+    displayName: string;
+    /** Capability set declaring which pipeline operations this provider supports. */
+    capabilities: ProviderCapabilitySet;
+}
+/**
+ * Canonical representation of a single tabular sheet/sheet-tab read from a provider.
+ */
+export interface CanonicalTableInput {
+    /** Unique identifier of the table within the data source. */
+    tableId: string;
+    /** Human-readable name or tab title of the table. */
+    tableName: string;
+    /** Raw row objects extracted from the table. */
+    rows: SheetRow[];
+    /** Optional source file path or URL. */
+    sourcePath?: string;
+    /** ISO timestamp string representing the last modified time if known. */
+    modifiedTime?: string;
+    /** Provider-specific metadata associated with the table. */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Parameters for requesting tables from a {@link TranslationInputProvider}.
+ */
+export interface TranslationInputRequest {
+    /** Specific table names to fetch. If omitted, all available tables are returned. */
+    tableNames?: string[];
+    /** Optional abort signal for early cancellation. */
+    signal?: AbortSignal;
+}
+/**
+ * Result returned by a {@link TranslationInputProvider.readTables} call.
+ */
+export interface TranslationInputResult {
+    /** Array of canonical tables read from the input provider. */
+    tables: CanonicalTableInput[];
+    /** Optional provider-level execution metadata. */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Payload passed to a {@link TranslationOutputProvider.writeTranslations} call.
+ */
+export interface TranslationOutputPayload {
+    /** Merged translation data. */
+    translations: TranslationData;
+    /** List of locales to output. */
+    locales: string[];
+    /** Mapping of original header columns to normalized locale codes. */
+    localeMapping?: Record<string, string>;
+    /** Original locale mapping preserved for reverse lookup. */
+    originalLocaleMapping?: Record<string, string>;
+    /** Optional provider-specific metadata. */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Result returned by a {@link TranslationOutputProvider.writeTranslations} call.
+ */
+export interface TranslationOutputResult {
+    /** List of file paths or resource identifiers written. */
+    wroteFiles: string[];
+    /** Optional output execution metadata. */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Payload passed to a {@link TranslationSyncProvider.syncTranslations} call.
+ */
+export interface TranslationSyncPayload {
+    /** Local translation snapshot containing recent edits. */
+    localTranslations: TranslationData;
+    /** Authoritative remote translations snapshot from the provider. */
+    remoteTranslations: TranslationData;
+    /** Optional sync options and provider metadata. */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Result returned by a {@link TranslationSyncProvider.syncTranslations} call.
+ */
+export interface TranslationSyncResult {
+    /** Number of translation keys created or updated during sync. */
+    changedKeys: number;
+    /** Number of translation keys skipped (e.g. unmodified or conflict-deferred). */
+    skippedKeys: number;
+    /** Optional sync outcome metadata. */
+    metadata?: Record<string, unknown>;
+}
+/** A provider that reads canonical tables from a data source (e.g. Google Sheets, a CSV file). */
+export interface TranslationInputProvider extends ProviderMetadata {
+    kind: 'input';
+    readTables(request: TranslationInputRequest): Promise<TranslationInputResult>;
+}
+/** A provider that writes the merged translation set to a destination. */
+export interface TranslationOutputProvider extends ProviderMetadata {
+    kind: 'output';
+    writeTranslations(payload: TranslationOutputPayload): Promise<TranslationOutputResult>;
+}
+/** A provider that reconciles local translation edits with a remote source, resolving conflicts. */
+export interface TranslationSyncProvider extends ProviderMetadata {
+    kind: 'sync';
+    syncTranslations(payload: TranslationSyncPayload): Promise<TranslationSyncResult>;
+}
+/**
+ * Union of all standard translation provider types.
+ */
+export type AnyTranslationProvider = TranslationInputProvider | TranslationOutputProvider | TranslationSyncProvider;
+/**
+ * Typed provider registry contract for the orchestration layer.
+ * Implementations can provide in-memory, DI, or plugin-backed registries.
+ */
+export interface ProviderRegistry {
+    register(provider: AnyTranslationProvider): void;
+    get(providerId: string): AnyTranslationProvider | undefined;
+    list(): AnyTranslationProvider[];
+}
+/**
+ * A provider registry partitioned by provider role (`input`, `output`, `sync`).
+ */
+export interface SegmentedProviderRegistry {
+    registerInput(provider: TranslationInputProvider): void;
+    registerOutput(provider: TranslationOutputProvider): void;
+    registerSync(provider: TranslationSyncProvider): void;
+    getInput(providerId: string): TranslationInputProvider | undefined;
+    getOutput(providerId: string): TranslationOutputProvider | undefined;
+    getSync(providerId: string): TranslationSyncProvider | undefined;
+}
+//# sourceMappingURL=contracts.d.ts.map

package/dist/providers/contracts.d.ts.map

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

package/dist/providers/cryptpad/assetProvider.d.ts

@@ -0,0 +1,36 @@
+import { type ProviderCapabilitySet } from '../capabilities';
+import type { AssetSyncProvider, CanonicalAssetEntry } from '../assetContracts';
+/**
+ * Options for configuring a CryptPad asset synchronization provider.
+ */
+export interface CryptPadAssetSyncProviderOptions {
+    /** Path to a JSON file containing a {@link CanonicalAssetEntry}[] manifest. */
+    manifestPath: string;
+    /** Optional custom provider identifier. Defaults to 'cryptpad-assets'. */
+    providerId?: string;
+    /** Optional human-friendly provider name. */
+    displayName?: string;
+}
+interface CryptPadAssetSyncProviderDeps {
+    readManifest: (manifestPath: string) => Promise<CanonicalAssetEntry[]>;
+    readAssetBuffer: (asset: CanonicalAssetEntry, signal?: AbortSignal) => Promise<Buffer>;
+    fileExists: (filePath: string) => Promise<boolean>;
+    readFile: (filePath: string) => Promise<Buffer>;
+    writeFile: (filePath: string, content: Buffer) => Promise<void>;
+    listFiles: (directory: string) => Promise<string[]>;
+    deleteFile: (filePath: string) => Promise<void>;
+}
+declare const CRYPTPAD_ASSET_SYNC_CAPABILITIES: ProviderCapabilitySet;
+/**
+ * Creates an {@link AssetSyncProvider} that syncs binary/static assets described by a
+ * JSON manifest (`manifestPath`) into a local target directory. For each manifest
+ * entry it downloads a missing file, overwrites a file whose SHA-256 hash differs,
+ * or skips a file that is already up to date; entries sharing the same declared
+ * `hash` reuse one fetched buffer. When {@link AssetSyncRequest.deleteMissing} is
+ * set, local files under the target directory that are not named by the manifest
+ * are removed. All target paths are checked with {@link isSafePath} to reject
+ * manifest entries that would write outside the target directory.
+ */
+export declare function createCryptPadAssetSyncProvider(options: CryptPadAssetSyncProviderOptions, depsOverrides?: Partial<CryptPadAssetSyncProviderDeps>): AssetSyncProvider;
+export { CRYPTPAD_ASSET_SYNC_CAPABILITIES };
+//# sourceMappingURL=assetProvider.d.ts.map

package/dist/providers/cryptpad/assetProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assetProvider.d.ts","sourceRoot":"","sources":["../../../src/providers/cryptpad/assetProvider.ts"],"names":[],"mappings":"AAIA,OAAO,EAAuB,KAAK,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAClF,OAAO,KAAK,EACV,iBAAiB,EAGjB,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC/C,+EAA+E;IAC/E,YAAY,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,UAAU,6BAA6B;IACrC,YAAY,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC;IACvE,eAAe,EAAE,CAAC,KAAK,EAAE,mBAAmB,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACvF,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACnD,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAChD,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACpD,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD;AAED,QAAA,MAAM,gCAAgC,EAAE,qBAGtC,CAAC;AAgFH;;;;;;;;;GASG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,gCAAgC,EACzC,aAAa,GAAE,OAAO,CAAC,6BAA6B,CAAM,GACzD,iBAAiB,CAsEnB;AAED,OAAO,EAAE,gCAAgC,EAAE,CAAC"}

package/dist/providers/cryptpad/fullProvider.d.ts

@@ -0,0 +1,50 @@
+import type { TranslationOutputProvider, TranslationSyncProvider } from '../contracts';
+import { type ProviderCapabilitySet } from '../capabilities';
+import { type SyncConflictPolicy } from '../syncEngine';
+import type { TranslationData } from '../../types';
+interface CryptPadWorkspaceSnapshot {
+    revision: number;
+    translations: TranslationData;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Options for configuring CryptPad workspace output and sync providers.
+ */
+export interface CryptPadWorkspaceProviderOptions {
+    /** Path to the local JSON snapshot file acting as the CryptPad workspace state. */
+    filePath: string;
+    /** Optional authentication token for future remote write-back endpoints. */
+    authToken?: string;
+    /** Optimistic-concurrency guard: if set, writes fail unless the on-disk revision matches. */
+    expectedRevision?: number;
+    /** Conflict resolution strategy used by the sync provider; ignored by the output provider. */
+    conflictPolicy?: SyncConflictPolicy;
+    /** Custom provider identifier. */
+    providerId?: string;
+    /** Custom human-friendly provider name. */
+    displayName?: string;
+}
+interface CryptPadWorkspaceProviderDeps {
+    readSnapshot: (filePath: string, authToken?: string) => Promise<CryptPadWorkspaceSnapshot>;
+    writeSnapshot: (filePath: string, snapshot: CryptPadWorkspaceSnapshot, authToken?: string) => Promise<void>;
+}
+declare const CRYPTPAD_WORKSPACE_OUTPUT_CAPABILITIES: ProviderCapabilitySet;
+declare const CRYPTPAD_WORKSPACE_SYNC_CAPABILITIES: ProviderCapabilitySet;
+/**
+ * Creates a {@link TranslationOutputProvider} that writes translations into a local
+ * JSON snapshot file representing CryptPad workspace state. Each write reads the
+ * current snapshot, checks `expectedRevision` (if set) for optimistic-concurrency
+ * safety, deep-merges the new translations over the existing ones, and writes back
+ * with the revision incremented by one.
+ */
+export declare function createCryptPadWorkspaceOutputProvider(options: CryptPadWorkspaceProviderOptions, depsOverrides?: Partial<CryptPadWorkspaceProviderDeps>): TranslationOutputProvider;
+/**
+ * Creates a {@link TranslationSyncProvider} that reconciles local translation changes
+ * against the CryptPad workspace snapshot using {@link resolveSyncPlan} (three-way
+ * diff against `payload.metadata.baseTranslations`, falling back to the remote
+ * snapshot as base) and the configured `conflictPolicy`. Like the output provider,
+ * it checks `expectedRevision` before writing and increments the revision on write.
+ */
+export declare function createCryptPadWorkspaceSyncProvider(options: CryptPadWorkspaceProviderOptions, depsOverrides?: Partial<CryptPadWorkspaceProviderDeps>): TranslationSyncProvider;
+export { CRYPTPAD_WORKSPACE_OUTPUT_CAPABILITIES, CRYPTPAD_WORKSPACE_SYNC_CAPABILITIES };
+//# sourceMappingURL=fullProvider.d.ts.map

package/dist/providers/cryptpad/fullProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fullProvider.d.ts","sourceRoot":"","sources":["../../../src/providers/cryptpad/fullProvider.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,yBAAyB,EAGzB,uBAAuB,EAExB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAuB,KAAK,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAClF,OAAO,EAAmB,KAAK,kBAAkB,EAA2B,MAAM,eAAe,CAAC;AAClG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,UAAU,yBAAyB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,eAAe,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC/C,mFAAmF;IACnF,QAAQ,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6FAA6F;IAC7F,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,8FAA8F;IAC9F,cAAc,CAAC,EAAE,kBAAkB,CAAC;IACpC,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,UAAU,6BAA6B;IACrC,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAC3F,aAAa,EAAE,CACb,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,yBAAyB,EACnC,SAAS,CAAC,EAAE,MAAM,KACf,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAED,QAAA,MAAM,sCAAsC,EAAE,qBAE5C,CAAC;AAEH,QAAA,MAAM,oCAAoC,EAAE,qBAG1C,CAAC;AAqEH;;;;;;GAMG;AACH,wBAAgB,qCAAqC,CACnD,OAAO,EAAE,gCAAgC,EACzC,aAAa,GAAE,OAAO,CAAC,6BAA6B,CAAM,GACzD,yBAAyB,CAoC3B;AAaD;;;;;;GAMG;AACH,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,gCAAgC,EACzC,aAAa,GAAE,OAAO,CAAC,6BAA6B,CAAM,GACzD,uBAAuB,CAgDzB;AAED,OAAO,EAAE,sCAAsC,EAAE,oCAAoC,EAAE,CAAC"}

package/dist/providers/cryptpad/index.d.ts

@@ -0,0 +1,8 @@
+/** Barrel for the CryptPad provider family: CSV input (MVP), workspace output/sync, and asset sync. */
+export { createCryptPadCsvInputProvider, CRYPTPAD_CSV_INPUT_CAPABILITIES } from './provider';
+export { createCryptPadWorkspaceOutputProvider, createCryptPadWorkspaceSyncProvider, CRYPTPAD_WORKSPACE_OUTPUT_CAPABILITIES, CRYPTPAD_WORKSPACE_SYNC_CAPABILITIES, } from './fullProvider';
+export { createCryptPadAssetSyncProvider, CRYPTPAD_ASSET_SYNC_CAPABILITIES } from './assetProvider';
+export type { CryptPadCsvSource, CryptPadCsvInputProviderOptions } from './provider';
+export type { CryptPadWorkspaceProviderOptions } from './fullProvider';
+export type { CryptPadAssetSyncProviderOptions } from './assetProvider';
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/cryptpad/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/cryptpad/index.ts"],"names":[],"mappings":"AAAA,uGAAuG;AACvG,OAAO,EAAE,8BAA8B,EAAE,+BAA+B,EAAE,MAAM,YAAY,CAAC;AAE7F,OAAO,EACL,qCAAqC,EACrC,mCAAmC,EACnC,sCAAsC,EACtC,oCAAoC,GACrC,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,+BAA+B,EAAE,gCAAgC,EAAE,MAAM,iBAAiB,CAAC;AAEpG,YAAY,EAAE,iBAAiB,EAAE,+BAA+B,EAAE,MAAM,YAAY,CAAC;AAErF,YAAY,EAAE,gCAAgC,EAAE,MAAM,gBAAgB,CAAC;AACvE,YAAY,EAAE,gCAAgC,EAAE,MAAM,iBAAiB,CAAC"}