@asteby/metacore-dataload 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for describing the origin of the Work and
+      reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 Asteby, Inc.
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -1,3 +1,90 @@
-# Temporary Holding Version
+# @asteby/metacore-dataload
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Typed client, hooks and UI for the kernel's generic bulk-load engine (`metacore-kernel/dataload`): declarative profiles and per-organization overrides, **dry-run and diff**, idempotent asynchronous runs with progress and history, a **review queue** for rows the extract stage held, **chunked uploads** for big files, and the status of the **immutable sha256 media backup**.
+
+No niche, source-platform or flavor logic lives here: everything specific (a mapping from some source, an org's ignored columns, review codes) is a declarative profile / override / extract document registered by the host.
+
+## Contract
+
+The kernel package has no HTTP layer; the host (ops / an addon) mounts a handler at `basePath` (default `/dataload`) wrapping `dataload.Runner`, `Ledger`, `ReviewStore`, `Manifest` and `MediaQueue`. Responses use the usual `{ success, data }` envelope; errors carry `{ message }` and an HTTP status.
+
+| Method | Path | Kernel call | Returns |
+| --- | --- | --- | --- |
+| GET | `/profiles` | every published version (shared base catalog + the organization's) | `ProfileSummary[]` |
+| GET | `/profiles/:name/versions/:version[?base=1]` | one full version | `StoredProfileVersion` |
+| POST | `/profiles` `{ name, version, profile? \| base + overrides, extract?, note? }` | `Registry.Publish` (immutable; same content = no-op, other content = 409) | `StoredProfileVersion` |
+| POST | `/dry-run` | `Runner.DryRun` | `{ plan, run, source }` (`source` = id of the stored source) |
+| POST | `/runs` | `Runner.Start` (returns at once) | `DataloadRun` |
+| GET | `/runs?limit=` | `Ledger.List` | `DataloadRun[]` |
+| GET | `/runs/:id` | `Runner.Status` | `DataloadRun` |
+| GET | `/runs/:id/plan?action=&offset=&limit=` | page of the plan stored with the run (server default 100) | `PlanPage` |
+| POST | `/runs/:id/cancel` | `Runner.Cancel` | `DataloadRun` |
+| GET | `/reviews?entity=&state=&run_id=&code=&limit=&cursor=` | `ReviewStore.List` (cursor pages, limit ≤ 500) | `ReviewPage` (`items`, `counts`, `next`) |
+| POST | `/reviews/decide` `{ decisions: ReviewDecision[] }` | `Runner.Decide` (all or nothing) | `ReviewEntry[]` |
+| POST | `/reviews/apply` `{ entity }` | `Runner.ApplyApproved` | `DataloadRun` (`mode: apply_reviewed`) |
+| POST | `/uploads` `{ name, size, contentType?, chunkSize? }` | host storage | `UploadSession` |
+| GET | `/uploads/:id` | host storage | `UploadSession` (with `received` parts) |
+| POST | `/uploads/:id/parts/:index` raw bytes | host storage | — |
+| POST | `/uploads/:id/complete` `{ sha256? }` | host storage | `UploadSession` (with `sha256`) |
+| POST | `/uploads/:id/abort` | host storage | — |
+| GET | `/media/status?run_id=` | `MediaQueue.Stats` + manifest summary + dead jobs | `MediaBackupStatus` |
+| GET | `/media/manifest` | `ExportManifest` | `ManifestEntry[]` |
+| POST | `/media/verify` | `Backuper.VerifyAll` | `VerifyReport` |
+| POST | `/media/retry` `{ run_id? }` | `MediaQueue.RetryFailed` | `{ requeued }` |
+
+`dry-run` and `runs` take `{ profile: ref | inline profile, overrides?, source }`, where `ref` is `name@version` (the organization's) or `base/name@version` (the shared catalog, see `profileRef`) and `source` is `{ id }` (a source the server already stored: what the first dry-run returns), `{ format: 'csv'|'json'|'bundle', name, content, path? }` (inline text) or `{ format, name, uploadId, path? }` (a completed chunked upload); `runs` also takes `force`, `failOnInvalid` and **`expectPlanHash`**. The launcher applies exactly what was simulated: the registry version the dry-run resolved (`run.registry`), the stored source id (nothing is re-sent, so an import costs one upload) and the reviewed `planHash`; if the plan the server would apply now is different it answers **409** (`isPlanChanged`) and the UI drops the plan and asks to simulate again. Edited overrides are the complete set and go over the full base profile of the selected version. `src/__fixtures__/ops/` holds the server's real responses and `contract.test.ts` checks the client against them. An explicit `overrides: {}` means "no overrides" (omitting it lets the server use the ones stored with the profile). The organization and the actor always come from the session, never from the body. Tokens and passwords are never part of any payload.
+
+**Reviews.** A decision carries the `hash` of the row the person saw; the server answers **409** when the row changed since (`ErrReviewStale`) or is closed (`ErrReviewClosed`), and the UI reloads the queue. Approved rows are written only by `/reviews/apply`.
+
+**Chunked uploads.** The server chooses (or caps) `chunkSize` and answers which parts it already has, so an interrupted upload resumes without resending them. Each part is sent as `application/octet-stream` with `X-Content-Sha256` (hex) when the browser has WebCrypto, so the server can reject a corrupted part; parts can arrive again (idempotent by index). `complete` assembles the file and returns its sha256. The client never continues an upload whose `size` or `name` differ from the picked file (it discards it and starts a new one, so parts of two files are never mixed), and it refuses a `chunkSize` above 64 MB (each part is held in memory to hash it). The server should expire unfinished uploads. The row cap of the profile (`maxRows`) still applies when the file is read.
+
+## Use
+
+```tsx
+import { createDataloadApi, DataloadLauncher, DataloadProvider } from '@asteby/metacore-dataload'
+
+const api = createDataloadApi(axiosInstance) // or { basePath: '/api/dataload' }
+
+<DataloadProvider locale='es-MX' capabilities={capsFromRole} notify={toast}>
+  <DataloadLauncher api={api} defaultProfile='catalogo' onFinished={(run) => ...} />
+</DataloadProvider>
+```
+
+A complete host page (roles to capabilities, review screen, settings screen, plugging i18next) is in [`example/dataload-page.tsx`](./example/dataload-page.tsx).
+
+Components: `DataloadLauncher` (everything below in one flow), `PlanReview`, `RunProgressView`, `ReviewQueue`, `OverridesEditor`, `MediaBackupPanel`. Each accepts `t`, `locale`, `messages`, `capabilities` and `notify`, which win over `DataloadProvider`.
+
+Hooks for custom screens: `useDataloadLauncher` (pick -> dry-run -> review -> execute state machine, with `setOverrides`), `useSourceFile` (inline or chunked, with `cancel` / `retry`), `useDataloadProfiles`, `useDataloadRuns`, `useDataloadRun` (polls until terminal), `useDataloadRunPlan`, `useDataloadReviews`, `useReviewActions` (decide, apply approved), `useMediaBackupStatus`, `useDataloadActions` (cancel, verify, retry media).
+
+Pure helpers: `summarizePlan`, `filterRows`, `canApply`, `progressPercent`, `parseTime` (the kernel serializes unset times as `0001-01-01`), `mediaHealth`, `readSourceFile`, `uploadSourceFile`, `validateOverrides`, `resolveProfile`, `compactOverrides`, `resolveCapabilities`, `makeT`.
+
+### Review queue
+
+`ReviewQueue` lists the rows held for review (filter by state and reason code) in a table: row, identity, reasons (`revisar` / `info` with their code, field and detail from the extract document), what applying would do, and the state of the decision (who, when, comment). "Details" shows the field diff from the plan stored with the run that held the row (only if that plan still has the same version of the row) and the record that would be written. Select one or many, add a comment, approve or reject; "Apply approved (N)" writes them. With `hideWhenEmpty` it renders nothing while there is nothing to decide, or when the host has not mounted `/reviews` (404/405/501).
+
+### Overrides editor
+
+`OverridesEditor` edits one organization's overrides over a base profile: columns to ignore (exact or `prefix*`), extra headers per field, removed fields (never the identity), default values (typed by the field), and cleaning (replace the global rules, add rules per field, `drop_lines:<regex>`). Full field replacements and value translations are kept as they came. It validates as you type with the kernel's rules (`validateOverrides`: unknown or removed targets, unknown rules, invalid regexes, identity removal, another org's overrides), shows the resolved profile summary, runs a dry-run preview of the plan with the edited overrides when it has a `source`, and saves by publishing a NEW immutable version (`publishVersion`, base + overrides; versions are never rewritten). The server validates again and is the authority (JS RegExp only approximates Go RE2).
+
+### Permissions
+
+The host passes what the person may do; the UI hides or disables accordingly (the server must enforce the same rules):
+
+| Capability | Without it |
+| --- | --- |
+| `launch` | dry-run is still offered; "Apply" is disabled with an explanation |
+| `cancel` | no "Cancel load" button |
+| `approve` | the review queue is read-only (no selection, decisions or apply) |
+| `retryMedia` | no "Retry failed" in the media panel |
+| `verifyMedia` | no "Verify backup" |
+| `editOverrides` | the overrides editor is read-only and cannot save |
+
+Without `capabilities` everything is offered. Once the host passes an object, **any capability it leaves out is denied**, so a capability added in a later version never appears enabled by accident.
+
+### i18n
+
+Components never write user-facing text of their own: every string is a key. Built-in catalogs: `DATALOAD_MESSAGES_ES_MX` (default) and `DATALOAD_MESSAGES_EN_US`, picked by `locale` (`en*` -> en-US, anything else -> es-MX). Resolution order per key: `messages[key]` -> `t(key, catalogText)` -> catalog. A `t` that returns the key itself (a missing translation in most libraries) falls back to the catalog. To add a language, pass a full catalog typed as `DataloadMessages` in `messages`. Server messages (validation errors) are shown as the server sends them.
+
+## UI
+
+Built on `@asteby/metacore-ui` and the host's design tokens (`bg-card`, `text-muted-foreground`, status badges), so light/dark themes apply with no extra CSS. Single column on phones; diff rows are cards, and wide tables (review queue, fields of a profile) scroll inside a focusable region instead of the page. Fields have labels, focus is visible, tables have a caption and column/row headers, progress is `role=progressbar`, and upload progress, run state and review decisions are announced through `aria-live`.

package/dist/api.d.ts

@@ -0,0 +1,87 @@
+import type { DataloadHttpClient, DataloadPlan, DataloadRequest, DataloadRun, DryRunResult, ExecuteRequest, MediaBackupStatus, ManifestEntry, PlanPage, PlanPageQuery, ProfileKey, ProfileSummary, PublishVersionRequest, ReviewDecision, ReviewEntry, ReviewFilter, ReviewPage, StoredProfileVersion, UploadSession, VerifyReport } from './types';
+/** Reference to send as `profile` in a request: `base/name@version` for the host's shared catalog. */
+export declare function profileRef(p: {
+    name: string;
+    version: string;
+    shared?: boolean;
+    org?: string;
+}): string;
+export interface DataloadApi {
+    /** Every published version: the host's shared base catalog (`shared`) and the organization's own. */
+    listProfiles(): Promise<ProfileSummary[]>;
+    /**
+     * Publishes a new immutable version (full profile, or base + overrides).
+     * Same content again is a no-op; the same name+version with other content is 409.
+     */
+    publishVersion(body: PublishVersionRequest): Promise<StoredProfileVersion>;
+    /** One full published version (`base/` for the host's shared catalog). */
+    profileVersion(key: ProfileKey & {
+        shared?: boolean;
+    }): Promise<StoredProfileVersion>;
+    /** Dry-run: reads, maps and diffs against the destination. Writes and downloads nothing. */
+    dryRun(body: DataloadRequest): Promise<DryRunResult>;
+    /** Starts an async apply and returns immediately; poll `run(id)` for progress. */
+    execute(body: ExecuteRequest): Promise<DataloadRun>;
+    run(id: string): Promise<DataloadRun>;
+    /** One page of the plan stored with a run (dry-run or apply); paginated on the server. */
+    runPlan(id: string, query?: PlanPageQuery): Promise<PlanPage>;
+    /** History, newest first. */
+    runs(limit?: number): Promise<DataloadRun[]>;
+    cancel(id: string): Promise<DataloadRun>;
+    mediaStatus(runId?: string): Promise<MediaBackupStatus>;
+    /** Exports the manifest (source url, sha256, bytes, type, dates, status). */
+    mediaManifest(): Promise<ManifestEntry[]>;
+    /** Re-reads every backed-up original and compares sha256. */
+    mediaVerify(): Promise<VerifyReport>;
+    /** Requeues dead media jobs ("retry media"). Returns how many. */
+    mediaRetry(runId?: string): Promise<number>;
+    /** One page of the rows held for a decision, by row order, with the counts by state. */
+    reviews(filter?: ReviewFilter): Promise<ReviewPage>;
+    /** Records decisions without writing to the destination. All or nothing (`Runner.Decide`). */
+    decideReviews(decisions: ReviewDecision[]): Promise<ReviewEntry[]>;
+    /** Writes the approved rows of an entity (`Runner.ApplyApproved`); returns its `apply_reviewed` run. */
+    applyApproved(entity: string): Promise<DataloadRun>;
+    /** Opens a chunked upload. The server picks (or caps) `chunkSize`. */
+    createUpload(body: {
+        name: string;
+        size: number;
+        contentType?: string;
+        chunkSize?: number;
+    }): Promise<UploadSession>;
+    /** Current state of an upload (which parts the server has), to resume. */
+    upload(id: string): Promise<UploadSession>;
+    /** Sends one part as raw bytes. `sha256` (hex) lets the server reject a corrupted part. */
+    uploadPart(id: string, index: number, chunk: Blob, opts?: {
+        sha256?: string;
+        signal?: AbortSignal;
+    }): Promise<void>;
+    /** Assembles the parts; the server checks `sha256` when given. */
+    completeUpload(id: string, opts?: {
+        sha256?: string;
+    }): Promise<UploadSession>;
+    /** Discards an unfinished upload. */
+    abortUpload(id: string): Promise<void>;
+}
+/** The kernel serializes nil slices as null; the UI wants arrays. */
+export declare function normalizePlan<P extends DataloadPlan | PlanPage>(p: P): P;
+export declare function planQuery(q?: PlanPageQuery): string;
+export declare function normalizeRun(r: DataloadRun): DataloadRun;
+export declare function normalizeReview(e: ReviewEntry): ReviewEntry;
+/** Query string for a review filter (snake_case like the rest of the contract). */
+export declare function reviewQuery(f?: ReviewFilter): string;
+/** REST client for the dataload handler that the host mounts at `basePath` (default `/dataload`). */
+export declare function createDataloadApi(http: DataloadHttpClient, opts?: {
+    basePath?: string;
+}): DataloadApi;
+/** Extracts the server message from an axios-like error. */
+export declare function apiErrorMessage(err: unknown, fallback: string): string;
+/** HTTP status of an axios-like error, if any. */
+export declare function apiErrorStatus(err: unknown): number | undefined;
+/**
+ * The plan the person reviewed is no longer the one the server would apply (409 on
+ * execute with `expectPlanHash`): simulate again before applying.
+ */
+export declare function isPlanChanged(err: unknown): boolean;
+/** Every page of the review queue (follows `next`), up to `max` rows. */
+export declare function listAllReviews(api: DataloadApi, filter?: ReviewFilter, max?: number): Promise<ReviewPage>;
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

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

package/dist/api.js

@@ -0,0 +1,141 @@
+import { parseTime } from './utils';
+const unwrap = (res) => res.data.data;
+/** Reference to send as `profile` in a request: `base/name@version` for the host's shared catalog. */
+export function profileRef(p) {
+    return `${p.shared || p.org === '' ? 'base/' : ''}${p.name}@${p.version}`;
+}
+const nz = (v) => v ?? [];
+/** The kernel serializes nil slices as null; the UI wants arrays. */
+export function normalizePlan(p) {
+    return {
+        ...p,
+        counts: p.counts ?? {},
+        rows: nz(p.rows).map((r) => ({ ...r, diffs: nz(r.diffs), issues: nz(r.issues), review: nz(r.review) })),
+    };
+}
+export function planQuery(q = {}) {
+    const p = new URLSearchParams();
+    if (q.action)
+        p.set('action', q.action);
+    if (q.offset)
+        p.set('offset', String(q.offset));
+    if (q.limit)
+        p.set('limit', String(q.limit));
+    const s = p.toString();
+    return s ? `?${s}` : '';
+}
+/** Go serializes an unset `time.Time` as 0001-01-01T00:00:00Z even with omitempty: drop those fields. */
+function dropUnsetTimes(o, keys) {
+    const out = { ...o };
+    for (const k of keys) {
+        const v = out[k];
+        if (v == null || (typeof v === 'string' && !parseTime(v)))
+            delete out[k];
+    }
+    return out;
+}
+export function normalizeRun(r) {
+    return dropUnsetTimes({ ...r, issues: nz(r.issues), review: nz(r.review).map((n) => ({ ...n, items: nz(n.items) })) }, ['startedAt', 'finishedAt']);
+}
+export function normalizeReview(e) {
+    return dropUnsetTimes({ ...e, items: nz(e.items), record: e.record ?? {} }, ['decidedAt']);
+}
+function normalizeUpload(u) {
+    return { ...u, received: nz(u.received) };
+}
+/** Query string for a review filter (snake_case like the rest of the contract). */
+export function reviewQuery(f = {}) {
+    const p = new URLSearchParams();
+    if (f.entity)
+        p.set('entity', f.entity);
+    if (f.state)
+        p.set('state', f.state);
+    if (f.runId)
+        p.set('run_id', f.runId);
+    if (f.code)
+        p.set('code', f.code);
+    if (f.limit)
+        p.set('limit', String(f.limit));
+    if (f.cursor)
+        p.set('cursor', f.cursor);
+    const s = p.toString();
+    return s ? `?${s}` : '';
+}
+function normalizeStatus(s) {
+    return { ...s, dead: nz(s.dead) };
+}
+/** REST client for the dataload handler that the host mounts at `basePath` (default `/dataload`). */
+export function createDataloadApi(http, opts = {}) {
+    const base = (opts.basePath ?? '/dataload').replace(/\/$/, '');
+    const id = (v) => encodeURIComponent(v);
+    const q = (runId) => (runId ? `?run_id=${encodeURIComponent(runId)}` : '');
+    return {
+        listProfiles: async () => nz(unwrap(await http.get(`${base}/profiles`))),
+        publishVersion: async (body) => unwrap(await http.post(`${base}/profiles`, body)),
+        profileVersion: async (k) => unwrap(await http.get(`${base}/profiles/${id(k.name)}/versions/${id(k.version)}${k.shared || k.org === '' ? '?base=1' : ''}`)),
+        dryRun: async (body) => {
+            const r = unwrap(await http.post(`${base}/dry-run`, body));
+            return { plan: normalizePlan(r.plan), run: normalizeRun(r.run), ...(r.source ? { source: r.source } : {}) };
+        },
+        execute: async (body) => normalizeRun(unwrap(await http.post(`${base}/runs`, body))),
+        run: async (v) => normalizeRun(unwrap(await http.get(`${base}/runs/${id(v)}`))),
+        runPlan: async (v, query) => normalizePlan(unwrap(await http.get(`${base}/runs/${id(v)}/plan${planQuery(query)}`))),
+        runs: async (limit = 30) => nz(unwrap(await http.get(`${base}/runs?limit=${limit}`))).map(normalizeRun),
+        cancel: async (v) => normalizeRun(unwrap(await http.post(`${base}/runs/${id(v)}/cancel`))),
+        mediaStatus: async (runId) => normalizeStatus(unwrap(await http.get(`${base}/media/status${q(runId)}`))),
+        mediaManifest: async () => nz(unwrap(await http.get(`${base}/media/manifest`))),
+        mediaVerify: async () => {
+            const r = unwrap(await http.post(`${base}/media/verify`));
+            return { ...r, missing: nz(r.missing), corrupt: nz(r.corrupt) };
+        },
+        mediaRetry: async (runId) => unwrap(await http.post(`${base}/media/retry`, runId ? { run_id: runId } : {})).requeued,
+        reviews: async (f) => {
+            const page = unwrap(await http.get(`${base}/reviews${reviewQuery(f)}`));
+            return { items: nz(page?.items).map(normalizeReview), counts: page?.counts ?? {}, ...(page?.next ? { next: page.next } : {}) };
+        },
+        decideReviews: async (decisions) => nz(unwrap(await http.post(`${base}/reviews/decide`, { decisions }))).map(normalizeReview),
+        applyApproved: async (entity) => normalizeRun(unwrap(await http.post(`${base}/reviews/apply`, { entity }))),
+        createUpload: async (body) => normalizeUpload(unwrap(await http.post(`${base}/uploads`, body))),
+        upload: async (v) => normalizeUpload(unwrap(await http.get(`${base}/uploads/${id(v)}`))),
+        uploadPart: async (v, index, chunk, o = {}) => {
+            const headers = { 'Content-Type': 'application/octet-stream' };
+            if (o.sha256)
+                headers['X-Content-Sha256'] = o.sha256;
+            await http.post(`${base}/uploads/${id(v)}/parts/${index}`, chunk, { headers, ...(o.signal ? { signal: o.signal } : {}) });
+        },
+        completeUpload: async (v, o = {}) => normalizeUpload(unwrap(await http.post(`${base}/uploads/${id(v)}/complete`, o.sha256 ? { sha256: o.sha256 } : {}))),
+        abortUpload: async (v) => {
+            await http.post(`${base}/uploads/${id(v)}/abort`);
+        },
+    };
+}
+/** Extracts the server message from an axios-like error. */
+export function apiErrorMessage(err, fallback) {
+    const e = err;
+    return e?.response?.data?.message || fallback;
+}
+/** HTTP status of an axios-like error, if any. */
+export function apiErrorStatus(err) {
+    return err?.response?.status;
+}
+/**
+ * The plan the person reviewed is no longer the one the server would apply (409 on
+ * execute with `expectPlanHash`): simulate again before applying.
+ */
+export function isPlanChanged(err) {
+    return apiErrorStatus(err) === 409 && /plan/i.test(apiErrorMessage(err, ''));
+}
+/** Every page of the review queue (follows `next`), up to `max` rows. */
+export async function listAllReviews(api, filter = {}, max = 5000) {
+    const items = [];
+    let page = await api.reviews({ limit: 500, ...filter });
+    const counts = page.counts;
+    for (;;) {
+        items.push(...page.items);
+        if (!page.next || items.length >= max)
+            break;
+        page = await api.reviews({ limit: 500, ...filter, cursor: page.next });
+    }
+    return { items: items.slice(0, max), counts, ...(page.next && items.length >= max ? { next: page.next } : {}) };
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

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

package/dist/capabilities.d.ts

@@ -0,0 +1,27 @@
+/**
+ * What the current person may do, as decided by the host (from its roles or
+ * permissions). The UI only hides or disables controls: the server must still
+ * enforce every rule, this is not a security boundary.
+ */
+export interface DataloadCapabilities {
+    /** Apply a load (dry-run is read-only and is always offered). */
+    launch: boolean;
+    /** Cancel a run in flight. */
+    cancel: boolean;
+    /** Approve or reject rows in the review queue, and apply the approved ones. */
+    approve: boolean;
+    /** Requeue media that could not be backed up. */
+    retryMedia: boolean;
+    /** Re-read every backed-up original and compare its sha256. */
+    verifyMedia: boolean;
+    /** Edit and save an organization's overrides. */
+    editOverrides: boolean;
+}
+export declare const ALL_CAPABILITIES: DataloadCapabilities;
+/**
+ * Without `capabilities` the UI offers everything (the server decides). Once the
+ * host passes an object, anything it leaves out is denied: a new capability added
+ * to the SDK never appears enabled by accident.
+ */
+export declare function resolveCapabilities(c?: Partial<DataloadCapabilities>): DataloadCapabilities;
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,iEAAiE;IACjE,MAAM,EAAE,OAAO,CAAA;IACf,8BAA8B;IAC9B,MAAM,EAAE,OAAO,CAAA;IACf,+EAA+E;IAC/E,OAAO,EAAE,OAAO,CAAA;IAChB,iDAAiD;IACjD,UAAU,EAAE,OAAO,CAAA;IACnB,+DAA+D;IAC/D,WAAW,EAAE,OAAO,CAAA;IACpB,iDAAiD;IACjD,aAAa,EAAE,OAAO,CAAA;CACvB;AAED,eAAO,MAAM,gBAAgB,EAAE,oBAO9B,CAAA;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,oBAAoB,CAU3F"}

package/dist/capabilities.js

@@ -0,0 +1,26 @@
+export const ALL_CAPABILITIES = {
+    launch: true,
+    cancel: true,
+    approve: true,
+    retryMedia: true,
+    verifyMedia: true,
+    editOverrides: true,
+};
+/**
+ * Without `capabilities` the UI offers everything (the server decides). Once the
+ * host passes an object, anything it leaves out is denied: a new capability added
+ * to the SDK never appears enabled by accident.
+ */
+export function resolveCapabilities(c) {
+    if (!c)
+        return ALL_CAPABILITIES;
+    return {
+        launch: !!c.launch,
+        cancel: !!c.cancel,
+        approve: !!c.approve,
+        retryMedia: !!c.retryMedia,
+        verifyMedia: !!c.verifyMedia,
+        editOverrides: !!c.editOverrides,
+    };
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAoBA,MAAM,CAAC,MAAM,gBAAgB,GAAyB;IACpD,MAAM,EAAE,IAAI;IACZ,MAAM,EAAE,IAAI;IACZ,OAAO,EAAE,IAAI;IACb,UAAU,EAAE,IAAI;IAChB,WAAW,EAAE,IAAI;IACjB,aAAa,EAAE,IAAI;CACpB,CAAA;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,CAAiC;IACnE,IAAI,CAAC,CAAC;QAAE,OAAO,gBAAgB,CAAA;IAC/B,OAAO;QACL,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM;QAClB,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM;QAClB,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO;QACpB,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU;QAC1B,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW;QAC5B,aAAa,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa;KACjC,CAAA;AACH,CAAC"}