@artinstack/migrator 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Prashant Naik
+
+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/README.md

@@ -0,0 +1,71 @@
+# @artinstack/migrator
+
+Stateless content normalizer and migration framework for transforming **WordPress**, **SmugMug**, **Squarespace**, and similar sources into a platform-agnostic schema.
+
+**Public from day one.** Portable parsers and JSON export are useful without any specific host. Job orchestration, credentials, and UI are implemented separately via `MigrationSink`.
+
+See [docs/architecture.md](./docs/architecture.md) for the high-level blueprint: data flow, DTOs, sink contract, and source mappings.
+
+## Package layout
+
+```
+src/
+  parsers/          WordPress, SmugMug, Squarespace → normalizer DTOs
+  normalizer/       Canonical DTOs + portable idempotency types
+  sinks/            filesystem export, MigrationSink interface
+  cli/              artinstack-migrate
+  transformers/     HtmlToGrapes, css-to-styles, rewrite-inline-images
+```
+
+## Install
+
+**From npm** (after publish):
+
+```bash
+pnpm add @artinstack/migrator
+# or: npm install @artinstack/migrator
+```
+
+**From source** (development):
+
+```bash
+pnpm install
+pnpm build
+```
+
+Requires **Node.js 20+**.
+
+## CLI
+
+```bash
+pnpm build
+
+# Installed / linked binary
+artinstack-migrate wordpress export.xml --out ./output
+artinstack-migrate validate wordpress ./export.xml
+
+# Local clone — no global install
+pnpm cli wordpress export.xml --dry-run
+node dist/cli/index.js wordpress export.xml --dry-run
+```
+
+## Development
+
+```bash
+pnpm typecheck
+pnpm test
+pnpm dev          # watch build
+```
+
+## What lives here vs the host
+
+| Piece | `@artinstack/migrator` | Host application |
+|-------|------------------------|------------------|
+| Parsers + normalizer DTOs | Yes | No |
+| CLI + filesystem JSON export | Yes | No |
+| `MigrationSink` interface | Yes | Implementation |
+| Jobs, worker, credentials, UI | No | Yes |
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

package/dist/bundle-BfZqiKV_.d.ts

@@ -0,0 +1,153 @@
+type MigrationPlatform = "wordpress" | "smugmug" | "squarespace";
+type EntityType = "post" | "page" | "asset" | "portfolio" | "category" | "tag";
+type PublishStatus = "draft" | "published" | "archived";
+interface SourceMetadata {
+    platform: MigrationPlatform;
+    id: string;
+    url?: string;
+    path?: string;
+    exportedAt?: string;
+}
+/** Canonical post DTO — raw HTML; sanitize at host sink. */
+interface NormalizedPost {
+    type: "post";
+    source: SourceMetadata;
+    sourceId: string;
+    title: string;
+    slug: string;
+    excerpt?: string;
+    contentHtml: string;
+    publishedAt?: string;
+    status: PublishStatus;
+    categorySlugs?: string[];
+    tagSlugs?: string[];
+    /** WordPress attachment id before two-pass resolution. */
+    sourceFeaturedMediaId?: string;
+    featuredAssetSourceId?: string;
+    seoTitle?: string;
+    seoDescription?: string;
+}
+/** Canonical page DTO — raw HTML snapshot. */
+interface NormalizedPage {
+    type: "page";
+    source: SourceMetadata;
+    sourceId: string;
+    title: string;
+    slug: string;
+    contentHtml: string;
+    contentCss?: string;
+    isHomePage?: boolean;
+    status: PublishStatus;
+    seoTitle?: string;
+    seoDescription?: string;
+}
+/** EXIF fields preserved from SmugMug / camera metadata when present. */
+interface NormalizedAssetExif {
+    iso?: number;
+    aperture?: number;
+    shutter?: string;
+    focalLength?: number;
+}
+/** Remote asset to stream into the host sink. */
+interface NormalizedAsset {
+    type: "asset";
+    source: SourceMetadata;
+    sourceId: string;
+    sourceUrl: string;
+    filename: string;
+    mimeType?: string;
+    caption?: string;
+    altText?: string;
+    keywords?: string[];
+    exif?: NormalizedAssetExif;
+    portfolioSourceId?: string;
+    sort?: number;
+}
+/** M2M index: portfolio ↔ asset membership and sort order. */
+interface PortfolioMediaLink {
+    portfolioSourceId: string;
+    assetSourceId: string;
+    sort: number;
+}
+interface NormalizedPortfolio {
+    type: "portfolio";
+    source: SourceMetadata;
+    sourceId: string;
+    title: string;
+    slug: string;
+    description?: string;
+    parentSourceId?: string;
+}
+interface NormalizedCategory {
+    type: "category";
+    source: SourceMetadata;
+    sourceId: string;
+    name: string;
+    slug: string;
+}
+interface NormalizedTag {
+    type: "tag";
+    source: SourceMetadata;
+    sourceId: string;
+    name: string;
+    slug: string;
+}
+type NormalizedEntity = NormalizedPost | NormalizedPage | NormalizedAsset | NormalizedPortfolio | NormalizedCategory | NormalizedTag;
+interface ValidationIssue {
+    code: string;
+    message: string;
+    path?: string;
+}
+interface ValidationResult {
+    ok: boolean;
+    issues: ValidationIssue[];
+    summary?: {
+        posts?: number;
+        pages?: number;
+        assets?: number;
+        portfolios?: number;
+        categories?: number;
+        tags?: number;
+    };
+}
+interface AdapterContext {
+    input: unknown;
+    cursor?: MigrationCursor;
+}
+interface MigrationAdapter {
+    platform: MigrationPlatform;
+    validateInput(input: unknown): ValidationResult | Promise<ValidationResult>;
+    enumerateEntities(ctx: AdapterContext): AsyncIterable<NormalizedEntity>;
+}
+interface MigrationCursor {
+    lastEntityKey?: EntityKey;
+    state?: Record<string, unknown>;
+}
+interface EntityKey {
+    platform: MigrationPlatform;
+    entityType: EntityType;
+    sourceId: string;
+}
+declare function entityKey(entity: NormalizedEntity, platform: MigrationPlatform): EntityKey;
+
+interface EntityBundle {
+    posts: NormalizedPost[];
+    pages: NormalizedPage[];
+    media: NormalizedAsset[];
+    portfolios: NormalizedPortfolio[];
+    categories: NormalizedCategory[];
+    tags: NormalizedTag[];
+}
+declare function emptyBundle(): EntityBundle;
+declare function collectEntities(entities: AsyncIterable<NormalizedEntity>): Promise<EntityBundle>;
+interface BundleCounts {
+    posts: number;
+    pages: number;
+    assets: number;
+    portfolios: number;
+    categories: number;
+    tags: number;
+}
+declare function bundleCounts(bundle: EntityBundle): BundleCounts;
+
+export { type AdapterContext as A, type BundleCounts as B, type EntityBundle as E, type MigrationAdapter as M, type NormalizedAsset as N, type PortfolioMediaLink as P, type SourceMetadata as S, type ValidationIssue as V, type MigrationPlatform as a, type EntityKey as b, type EntityType as c, type MigrationCursor as d, type NormalizedAssetExif as e, type NormalizedCategory as f, type NormalizedEntity as g, type NormalizedPage as h, type NormalizedPortfolio as i, type NormalizedPost as j, type NormalizedTag as k, type PublishStatus as l, type ValidationResult as m, bundleCounts as n, collectEntities as o, emptyBundle as p, entityKey as q };

package/dist/chunk-2RWAXT6O.js

@@ -0,0 +1 @@
+//# sourceMappingURL=chunk-2RWAXT6O.js.map

package/dist/chunk-2RWAXT6O.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}