@artinstack/migrator 0.1.17 → 0.1.19

package/dist/index.d.ts

@@ -57,9 +57,21 @@ declare const SMUGMUG_OAUTH_ENDPOINTS: {
     readonly authorize: "https://api.smugmug.com/services/oauth/1.0a/authorize";
     readonly accessToken: "https://api.smugmug.com/services/oauth/1.0a/getAccessToken";
 };
+declare const smugMugConsumerCredentialsSchema: z.ZodObject<{
+    consumerKey: z.ZodString;
+    consumerSecret: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    consumerKey: string;
+    consumerSecret: string;
+}, {
+    consumerKey: string;
+    consumerSecret: string;
+}>;
+type SmugMugConsumerCredentials = z.infer<typeof smugMugConsumerCredentialsSchema>;
 declare const smugMugCredentialsSchema: z.ZodObject<{
     consumerKey: z.ZodString;
     consumerSecret: z.ZodString;
+} & {
     accessToken: z.ZodString;
     accessTokenSecret: z.ZodString;
 }, "strip", z.ZodTypeAny, {
@@ -74,10 +86,44 @@ declare const smugMugCredentialsSchema: z.ZodObject<{
     accessTokenSecret: string;
 }>;
 type SmugMugCredentials = z.infer<typeof smugMugCredentialsSchema>;
+/** Material for HMAC-SHA1 signing — token fields omitted/empty during request-token phase. */
+type SmugMugOAuthSigningMaterial = {
+    consumerKey: string;
+    consumerSecret: string;
+    accessToken?: string;
+    /** Empty string (or omitted) for `getRequestToken`. */
+    accessTokenSecret?: string;
+};
+type SmugMugOAuthTokenPair = {
+    token: string;
+    tokenSecret: string;
+};
+type SmugMugRequestTokenResult = SmugMugOAuthTokenPair & {
+    callbackConfirmed: boolean;
+};
+type SmugMugAccessLevel = "Full" | "Public";
+type SmugMugPermissionLevel = "Read" | "Add" | "Modify";
+type SmugMugAuthorizeUrlOptions = {
+    requestToken: string;
+    /** SmugMug Access query param (default Full for migration crawl). */
+    access?: SmugMugAccessLevel;
+    /** SmugMug Permissions query param (default Modify for migration crawl). */
+    permissions?: SmugMugPermissionLevel;
+    allowThirdPartyLogin?: boolean;
+    showSignUpButton?: boolean;
+    username?: string;
+};
+type SmugMugOAuthSession = {
+    requestToken: string;
+    requestTokenSecret: string;
+    authorizeUrl: string;
+    callbackConfirmed: boolean;
+};
 declare const smugMugClientOptionsSchema: z.ZodObject<{
     credentials: z.ZodObject<{
         consumerKey: z.ZodString;
         consumerSecret: z.ZodString;
+    } & {
         accessToken: z.ZodString;
         accessTokenSecret: z.ZodString;
     }, "strip", z.ZodTypeAny, {
@@ -125,23 +171,75 @@ declare const smugMugClientOptionsSchema: z.ZodObject<{
     pageSize?: number | undefined;
 }>;
 type SmugMugClientOptions = z.input<typeof smugMugClientOptionsSchema>;
-/** Build OAuth 1.0a HMAC-SHA1 signature for a SmugMug API request. */
+/** SmugMug URI link — string when `_shorturis` is used, otherwise `{ Uri }`. */
+type SmugMugUriLink = string | {
+    Uri?: string;
+};
+/** Build OAuth 1.0a HMAC-SHA1 signature for a SmugMug API or handshake request. */
 declare function signSmugMugOAuthRequest(input: {
     method: string;
     url: string;
-    credentials: SmugMugCredentials;
+    credentials: SmugMugOAuthSigningMaterial;
     oauthParams: Record<string, string>;
     bodyParams?: Record<string, string>;
 }): string;
 declare function buildSmugMugAuthorizationHeader(input: {
     method: string;
     url: string;
-    credentials: SmugMugCredentials;
+    credentials: SmugMugOAuthSigningMaterial;
     nonce?: string;
     timestamp?: string;
     bodyParams?: Record<string, string>;
+    /** Extra oauth_* params (e.g. oauth_callback, oauth_verifier). */
+    oauthExtras?: Record<string, string>;
 }): string;
+/** Parse `application/x-www-form-urlencoded` OAuth token responses. */
+declare function parseSmugMugOAuthFormBody(body: string): Record<string, string>;
+/**
+ * Step 1 — temporary credentials.
+ * Signs with consumer secret + empty token secret; includes `oauth_callback` (URL or `oob`).
+ */
+declare function getSmugMugRequestToken(input: {
+    consumer: SmugMugConsumerCredentials;
+    callbackUrl: string;
+    fetchImpl?: typeof fetch;
+    nonce?: string;
+    timestamp?: string;
+}): Promise<SmugMugRequestTokenResult>;
+/** Step 2 — browser authorize URL (host redirects the photographer here). */
+declare function buildSmugMugAuthorizeUrl(options: SmugMugAuthorizeUrlOptions): string;
+/**
+ * Step 3 — exchange request token + verifier for long-lived access credentials.
+ * Signs with consumer secret + request token secret.
+ */
+declare function getSmugMugAccessToken(input: {
+    consumer: SmugMugConsumerCredentials;
+    requestToken: SmugMugOAuthTokenPair;
+    verifier: string;
+    fetchImpl?: typeof fetch;
+    nonce?: string;
+    timestamp?: string;
+}): Promise<SmugMugOAuthTokenPair>;
+/**
+ * Connect-UI start helper: request token + authorize URL.
+ * Host stores `requestTokenSecret` in session/cookie for the callback → `getSmugMugAccessToken`.
+ */
+declare function createSmugMugOAuthSession(input: {
+    consumerKey: string;
+    consumerSecret: string;
+    callbackUrl: string;
+    access?: SmugMugAccessLevel;
+    permissions?: SmugMugPermissionLevel;
+    fetchImpl?: typeof fetch;
+    nonce?: string;
+    timestamp?: string;
+}): Promise<SmugMugOAuthSession>;
 declare function readSmugMugCredentialsFromEnv(env?: Record<string, string | undefined>): SmugMugCredentials;
+/**
+ * Resolve a SmugMug URI link. Default API responses use `{ Uri, Locator, … }`;
+ * `_shorturis` responses use a bare string.
+ */
+declare function resolveSmugMugUriLink(link: SmugMugUriLink | null | undefined, label: string): string;
 /** Signed SmugMug API client — recursively discovers folders, albums, and images. */
 declare class SmugMugApiClient {
     readonly credentials: SmugMugCredentials;
@@ -509,4 +607,4 @@ declare const wixAdapter: MigrationAdapter;
 
 declare function getAdapter(platform: MigrationPlatform): MigrationAdapter;
 
-export { MigrationAdapter, MigrationPlatform, SMUGMUG_API_BASE, SMUGMUG_OAUTH_ENDPOINTS, SQUARESPACE_JSON_FORMAT, SmugMugApiClient, type SmugMugClientOptions, type SmugMugCredentials, type SquarespaceClientOptions, type SquarespaceCollectTarget, SquarespaceCollectionClient, WixCollectionClient, WixPageSnapshotCollector, buildJsonPrettyUrl, buildSmugMugAuthorizationHeader, getAdapter, mapJsonPrettyWire, readSmugMugCredentialsFromEnv, signSmugMugOAuthRequest, smugMugCredentialsSchema, smugmugAdapter, squarespaceAdapter, wixAdapter, wordpressAdapter };
+export { MigrationAdapter, MigrationPlatform, SMUGMUG_API_BASE, SMUGMUG_OAUTH_ENDPOINTS, SQUARESPACE_JSON_FORMAT, type SmugMugAccessLevel, SmugMugApiClient, type SmugMugAuthorizeUrlOptions, type SmugMugClientOptions, type SmugMugConsumerCredentials, type SmugMugCredentials, type SmugMugOAuthSession, type SmugMugOAuthSigningMaterial, type SmugMugOAuthTokenPair, type SmugMugPermissionLevel, type SmugMugRequestTokenResult, type SquarespaceClientOptions, type SquarespaceCollectTarget, SquarespaceCollectionClient, WixCollectionClient, WixPageSnapshotCollector, buildJsonPrettyUrl, buildSmugMugAuthorizationHeader, buildSmugMugAuthorizeUrl, createSmugMugOAuthSession, getAdapter, getSmugMugAccessToken, getSmugMugRequestToken, mapJsonPrettyWire, parseSmugMugOAuthFormBody, readSmugMugCredentialsFromEnv, resolveSmugMugUriLink, signSmugMugOAuthRequest, smugMugConsumerCredentialsSchema, smugMugCredentialsSchema, smugmugAdapter, squarespaceAdapter, wixAdapter, wordpressAdapter };

package/dist/index.js

@@ -5,15 +5,22 @@ import {
   WixCollectionClient,
   WixPageSnapshotCollector,
   buildSmugMugAuthorizationHeader,
+  buildSmugMugAuthorizeUrl,
+  createSmugMugOAuthSession,
   getAdapter,
+  getSmugMugAccessToken,
+  getSmugMugRequestToken,
+  parseSmugMugOAuthFormBody,
   readSmugMugCredentialsFromEnv,
+  resolveSmugMugUriLink,
   signSmugMugOAuthRequest,
+  smugMugConsumerCredentialsSchema,
   smugMugCredentialsSchema,
   smugmugAdapter,
   squarespaceAdapter,
   wixAdapter,
   wordpressAdapter
-} from "./chunk-RLMYUUNK.js";
+} from "./chunk-5RKHB6GI.js";
 import {
   normalizedAssetExifSchema,
   normalizedAssetSchema,
@@ -135,12 +142,14 @@ export {
   buildPortfolioMediaLinks,
   buildRedirectMap,
   buildSmugMugAuthorizationHeader,
+  buildSmugMugAuthorizeUrl,
   bundleCounts,
   bundleToCombinedJson,
   canonicalizeInlineAssetUrl,
   collectEntities,
   createFilesystemMigrationSink,
   createMigrationMediaRefReplaceWith,
+  createSmugMugOAuthSession,
   createWpContentGatewayRewrite,
   cssToStyles,
   detectRedirectLoops,
@@ -156,6 +165,8 @@ export {
   extractInlineImageSrcs,
   formatMigrationMediaRef,
   getAdapter,
+  getSmugMugAccessToken,
+  getSmugMugRequestToken,
   grapesComponentSchema,
   grapesProjectSnapshotSchema,
   grapesStyleRuleSchema,
@@ -180,11 +191,13 @@ export {
   normalizedPostSchema,
   normalizedTagSchema,
   parseMigrationMediaRef,
+  parseSmugMugOAuthFormBody,
   portfolioMediaMatchesBundle,
   readSmugMugCredentialsFromEnv,
   resolveAdapterImportSummary,
   resolveFeaturedContentAssetUrl,
   resolveMigrationMediaSourceId,
+  resolveSmugMugUriLink,
   rewriteInlineImages,
   rewriteOriginUrlsInText,
   runDryRun,
@@ -193,6 +206,7 @@ export {
   sanitizeSlug,
   shouldProcessEntity,
   signSmugMugOAuthRequest,
+  smugMugConsumerCredentialsSchema,
   smugMugCredentialsSchema,
   smugmugAdapter,
   sourceMetadataSchema,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@artinstack/migrator",
-  "version": "0.1.17",
-  "description": "Stateless content normalizer and migration framework — WordPress, SmugMug, Squarespace → platform-agnostic schema",
+  "version": "0.1.19",
+  "description": "MIT OSS migration framework — WordPress, SmugMug, Squarespace, Wix to portable DTOs. CLI + MigrationSink for any host; also powers import on artinstack.com",
   "license": "MIT",
   "author": "ArtInStack",
   "homepage": "https://github.com/naikondev/artinstack-migrator#readme",