@commercetools-frontend-extensions/operations 0.0.0-canary-20251209161906

package/CHANGELOG.md

@@ -0,0 +1,61 @@
+# @commercetools-frontend-extensions/operations
+
+## 0.0.0-canary-20251209161906
+
+### Major Changes
+
+- [#1646](https://github.com/commercetools/merchant-center-operations/pull/1646) [`c1c381d`](https://github.com/commercetools/merchant-center-operations/commit/c1c381da4aa5c47c6fcc63940f164defe08170bd) Thanks [@yassinejebli](https://github.com/yassinejebli)! - feat: introduce the new Import job flow
+
+## 2.0.1
+
+### Patch Changes
+
+- [#1640](https://github.com/commercetools/merchant-center-operations/pull/1640) [`f857821`](https://github.com/commercetools/merchant-center-operations/commit/f857821ffebd12a90b02ab5b6f77cf4cb08a495c) Thanks [@yassinejebli](https://github.com/yassinejebli)! - chore: enable npm publication for operations shared package
+
+## 2.0.0
+
+### Major Changes
+
+- [#1638](https://github.com/commercetools/merchant-center-operations/pull/1638) [`516f918`](https://github.com/commercetools/merchant-center-operations/commit/516f9189854c90c9d30242d2b724f0882ebbebee) Thanks [@yassinejebli](https://github.com/yassinejebli)! - Publish shared operations package and update modals
+
+## 1.1.3
+
+### Patch Changes
+
+- [#1423](https://github.com/commercetools/merchant-center-operations/pull/1423) [`d3da143`](https://github.com/commercetools/merchant-center-operations/commit/d3da1439618f27b4804b7293b0d8419508c6639a) Thanks [@renovate](https://github.com/apps/renovate)! - update all dependencies
+
+## 1.1.2
+
+### Patch Changes
+
+- [#1382](https://github.com/commercetools/merchant-center-operations/pull/1382) [`67fde7a`](https://github.com/commercetools/merchant-center-operations/commit/67fde7aee9c41631d2e703f009fdfb3bbb091868) Thanks [@renovate](https://github.com/apps/renovate)! - update all dependencies
+
+## 1.1.1
+
+### Patch Changes
+
+- [#1344](https://github.com/commercetools/merchant-center-operations/pull/1344) [`0ee84d2`](https://github.com/commercetools/merchant-center-operations/commit/0ee84d2d6a8c3f34f53ac750890c9f7ab68cfedf) Thanks [@renovate](https://github.com/apps/renovate)! - chore: update deps
+
+## 1.1.0
+
+### Minor Changes
+
+- [#1282](https://github.com/commercetools/merchant-center-operations/pull/1282) [`1a8828c`](https://github.com/commercetools/merchant-center-operations/commit/1a8828c14baff2512819872a5dd895a70861185f) Thanks [@mustafaasif2](https://github.com/mustafaasif2)! - remove support for locale `zh-CN`
+
+## 1.0.3
+
+### Patch Changes
+
+- [#1243](https://github.com/commercetools/merchant-center-operations/pull/1243) [`da123a8`](https://github.com/commercetools/merchant-center-operations/commit/da123a824ce028794562865c4d047478fcdf0812) Thanks [@renovate](https://github.com/apps/renovate)! - chore: update all dependencies
+
+## 1.0.2
+
+### Patch Changes
+
+- [#1243](https://github.com/commercetools/merchant-center-operations/pull/1243) [`da123a8`](https://github.com/commercetools/merchant-center-operations/commit/da123a824ce028794562865c4d047478fcdf0812) Thanks [@renovate](https://github.com/apps/renovate)! - chore: update all dependencies
+
+## 1.0.1
+
+### Patch Changes
+
+- [#1189](https://github.com/commercetools/merchant-center-operations/pull/1189) [`7e1b60f`](https://github.com/commercetools/merchant-center-operations/commit/7e1b60f9b220dc7b79d5e21f9d1ec8880b7caeac) Thanks [@renovate](https://github.com/apps/renovate)! - update all dependencies

package/README.md

@@ -0,0 +1,178 @@
+# Shared operations package
+
+Shared functionality for import/export operations across multiple frontend applications and extensions.
+
+## Hooks
+
+### `useFileUpload`
+
+A unified hook for file uploads that handles both the old flow (import container) and new flow (file import job).
+
+```typescript
+const { upload, isUploading, progress, validationProgress } = useFileUpload({
+  projectKey: string,
+  useJobBasedFlow?: boolean,
+  pollingInterval?: number,
+  maxPollingAttempts?: number
+})
+```
+
+**Parameters:**
+- `projectKey` (required): The commercetools project key
+- `useJobBasedFlow` (optional): Whether to use the job-based flow. Default: `false`
+- `pollingInterval` (optional): Polling interval in ms for job-based flow. Default: `5000`
+- `maxPollingAttempts` (optional): Maximum polling attempts. Default: `120`
+
+**Returns:**
+- `upload` - Function to start the upload
+- `isUploading` - Whether upload is in progress
+- `progress` - Upload progress (0-100)
+- `validationProgress` - `{ processed: number, isValidating: boolean }` (job-based flow only)
+
+**Usage:**
+```typescript
+import { useFileUpload } from '@commercetools-frontend-extensions/operations'
+
+const { upload, isUploading, progress, validationProgress } = useFileUpload({ 
+  projectKey,
+  useJobBasedFlow: isFeatureFlagEnabled
+})
+
+const abortController = new AbortController()
+
+await upload({
+  file: File,
+  resourceType: 'product' | 'category' | ...,
+  settings?: {
+    format?: 'CSV' | 'JSON',
+    decimalSeparator?: '.' | ',',
+    resourceType?: 'product-draft' | 'category' | ...,
+    options?: {
+      publishAllChanges?: boolean,
+      unpublishAllChanges?: boolean
+    }
+  },
+  abortSignal: abortController.signal,
+  onSuccess: (result) => {
+    // result.containerKey - Import container key
+    // result.summary - { total, valid, invalid, fields, ignoredFields, results }
+    // result.jobId - Job ID (job-based flow only)
+    // result.job - Full job object (job-based flow only)
+  },
+  onError: (error) => { /* ... */ },
+  onProgress: (progress) => { /* 0-100 */ },
+  onValidationProgress: (job) => { /* job-based flow only */ }
+})
+
+// To cancel:
+abortController.abort()
+```
+
+---
+
+### `useFetchImportOperations`
+
+Fetches import operations for a container with optional polling.
+
+```typescript
+const { data, error, isLoading, refetch } = useFetchImportOperations({
+  projectKey,
+  importContainerKey,
+  queryParams?: { limit, offset, ... },
+  pollingInterval?: number,
+  shouldContinuePolling?: (data) => boolean
+})
+```
+
+---
+
+### `useFetchImportSummaries`
+
+Fetches import summaries (containers) with optional polling.
+
+```typescript
+const { data, error, isLoading, refetch } = useFetchImportSummaries({
+  projectKey,
+  queryParams?: { limit, offset, states, ... },
+  pollingInterval?: number,
+  shouldContinuePolling?: (data) => boolean
+})
+```
+
+---
+
+### `useFetchImportContainerDetails`
+
+Fetches details for a specific import container.
+
+```typescript
+const { data, error, isLoading, refetch } = useFetchImportContainerDetails({
+  projectKey,
+  importContainerKey,
+  pollingInterval?: number,
+  shouldContinuePolling?: (data) => boolean
+})
+```
+
+---
+
+### `useFetchExportOperations`
+
+Fetches export operations with optional polling.
+
+```typescript
+const { data, error, isLoading, refetch } = useFetchExportOperations({
+  projectKey,
+  queryParams?: { limit, offset, resourceTypes, ... },
+  pollingInterval?: number,
+  shouldContinuePolling?: (data) => boolean
+})
+```
+
+---
+
+### `useFetchFileImportJob`
+
+Polls a File Import Job for status updates.
+
+```typescript
+const { data, error, isLoading, refetch } = useFetchFileImportJob({
+  projectKey,
+  importContainerKey,
+  jobId,
+  pollingInterval?: number,
+  shouldContinuePolling?: (job) => boolean
+})
+```
+
+**Job states:** `queued` → `processing` → `validated` → `initialising` → `ready`
+
+---
+
+## Helper Functions
+
+```typescript
+import {
+  isImportJobQueued,
+  isImportJobProcessing,
+  isImportJobValidated,
+  isImportJobInitializing,
+  isImportJobReady,
+  shouldContinuePollingForImportValidation
+} from '@commercetools-frontend-extensions/operations'
+```
+
+---
+
+## Polling Example
+
+```typescript
+const { data, isLoading } = useFetchImportOperations({
+  projectKey,
+  importContainerKey,
+  pollingInterval: 5000,
+  shouldContinuePolling: (data) => {
+    return data?.results?.some(op => op.state === 'processing') ?? false
+  }
+})
+```

package/babel.config.js

@@ -0,0 +1,6 @@
+module.exports = {
+  presets: [
+    '@commercetools-frontend/babel-preset-mc-app',
+    ['@babel/preset-react', { runtime: 'automatic' }],
+  ],
+}

package/dist/commercetools-frontend-extensions-operations.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./declarations/src/index.js";
+//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29tbWVyY2V0b29scy1mcm9udGVuZC1leHRlbnNpb25zLW9wZXJhdGlvbnMuY2pzLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuL2RlY2xhcmF0aW9ucy9zcmMvaW5kZXguZC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSJ9