@inneropen/marvin-sdk 2.0.0-next.18 → 2.0.0-next.3

package/dist/chunk-GJNOYXUQ.js

@@ -1,980 +0,0 @@
-import {
-  BearerTokenAuth,
-  HttpClient,
-  MarvinCache,
-  MarvinNotFoundError,
-  __esm,
-  __export,
-  init_core,
-  init_errors
-} from "./chunk-WJC4X7TB.js";
-
-// src/client/config.ts
-var config_exports = {};
-__export(config_exports, {
-  createConfigFromEnv: () => createConfigFromEnv,
-  validateConfig: () => validateConfig
-});
-function validateConfig(config) {
-  const receivedKeys = Object.keys(config).join(", ");
-  if (!config.apiUrl) {
-    throw new Error(
-      `Missing required config: 'apiUrl'
-
-The API URL is the base URL of your Marvin server.
-
-Examples:
-  - Production: https://marvin.example.com
-  - Development: http://localhost:8080
-
-Solutions:
-  1. Set environment variable: MARVIN_API_URL=https://marvin.example.com
-  2. Pass directly: createMarvinClient({ apiUrl: 'https://marvin.example.com' })
-
-Received config keys: ${receivedKeys || "(none)"}`
-    );
-  }
-  if (!config.siteClientToken) {
-    throw new Error(
-      `Missing required config: 'siteClientToken'
-
-The site client token provides read-only access to published content.
-
-How to get it:
-  1. Log into Marvin admin panel
-  2. Navigate to: Settings \u2192 API Clients
-  3. Copy the token for your workspace
-
-Examples:
-  - site_client_abc123xyz
-  - sc_1234567890abcdef
-
-Solutions:
-  1. Set environment variable: MARVIN_SITE_CLIENT_TOKEN=site_client_abc123
-  2. Pass directly: createMarvinClient({ siteClientToken: 'site_client_abc123' })
-
-Received config keys: ${receivedKeys}`
-    );
-  }
-  if (!config.workspaceSlug) {
-    throw new Error(
-      `Missing required config: 'workspaceSlug'
-
-The workspace slug identifies which workspace to access.
-
-Examples:
-  - my-blog
-  - company-website
-  - acme-corp
-
-How to find it:
-  1. Check your workspace URL: https://marvin.example.com/workspace/[slug]
-  2. Or find it in: Settings \u2192 General \u2192 Workspace Slug
-
-Solutions:
-  1. Set environment variable: MARVIN_WORKSPACE_SLUG=my-blog
-  2. Pass directly: createMarvinClient({ workspaceSlug: 'my-blog' })
-
-Received config keys: ${receivedKeys}`
-    );
-  }
-  if (config.apiUrl) {
-    try {
-      new URL(config.apiUrl);
-    } catch {
-      throw new Error(
-        `Invalid 'apiUrl' format: "${config.apiUrl}"
-
-The API URL must be a valid HTTP or HTTPS URL.
-
-Valid examples:
-  \u2713 https://marvin.example.com
-  \u2713 http://localhost:8080
-  \u2713 https://api.marvin.io
-
-Invalid examples:
-  \u2717 marvin.example.com (missing protocol)
-  \u2717 ftp://marvin.example.com (wrong protocol)
-  \u2717 /api (not a full URL)`
-      );
-    }
-    const url = new URL(config.apiUrl);
-    if (!["http:", "https:"].includes(url.protocol)) {
-      throw new Error(
-        `Invalid 'apiUrl' protocol: "${url.protocol}"
-
-Only HTTP and HTTPS protocols are supported.
-
-Your URL: ${config.apiUrl}
-Change to: ${config.apiUrl.replace(url.protocol, "https:")}`
-      );
-    }
-  }
-}
-function createConfigFromEnv(overrides) {
-  return {
-    apiUrl: overrides?.apiUrl || process.env.MARVIN_API_URL || "",
-    siteClientToken: overrides?.siteClientToken || process.env.MARVIN_SITE_CLIENT_TOKEN || "",
-    workspaceSlug: overrides?.workspaceSlug || process.env.MARVIN_WORKSPACE_SLUG || "",
-    autoInitialize: overrides?.autoInitialize ?? false,
-    cacheDuration: overrides?.cacheDuration ?? 5 * 60 * 1e3,
-    // 5 minutes
-    debug: overrides?.debug ?? process.env.MARVIN_DEBUG === "true",
-    logger: overrides?.logger ?? console
-  };
-}
-var init_config = __esm({
-  "src/client/config.ts"() {
-    "use strict";
-  }
-});
-
-// src/entries/entry.ts
-var Entry;
-var init_entry = __esm({
-  "src/entries/entry.ts"() {
-    "use strict";
-    Entry = class {
-      constructor(data, http, workspaceSlug) {
-        this.data = data;
-        this.http = http;
-        this.workspaceSlug = workspaceSlug;
-      }
-      data;
-      http;
-      workspaceSlug;
-      // Expose all entry data as properties
-      get id() {
-        return this.data.id;
-      }
-      get title() {
-        return this.data.title;
-      }
-      get slug() {
-        return this.data.slug;
-      }
-      get summary() {
-        return this.data.summary;
-      }
-      get description() {
-        return this.data.description;
-      }
-      /**
-       * @deprecated Use field('body') or dataJson instead. Will be removed in v3.0.0
-       */
-      get contentMarkdown() {
-        return this.data.contentMarkdown;
-      }
-      /**
-       * Schema-driven content data (replaces contentMarkdown in v2.0.0).
-       * Access specific fields using the field() helper method.
-       * @since 2.0.0
-       */
-      get dataJson() {
-        return this.data.dataJson;
-      }
-      get metadata() {
-        return this.data.metadata;
-      }
-      get status() {
-        return this.data.status;
-      }
-      get publishedAt() {
-        return this.data.publishedAt;
-      }
-      get createdAt() {
-        return this.data.createdAt;
-      }
-      get updatedAt() {
-        return this.data.updatedAt;
-      }
-      get entryTypeId() {
-        return this.data.entryTypeId;
-      }
-      get entryType() {
-        return this.data.entryType;
-      }
-      /**
-       * Get entry assets
-       */
-      get assets() {
-        return this.data.assets || [];
-      }
-      /**
-       * Get entry collections
-       */
-      get collections() {
-        return this.data.collections || [];
-      }
-      /**
-       * Get a specific field value from the entry's schema-driven content (dataJson).
-       *
-       * @param key - Field key as defined in the entry type's schema
-       * @returns The field value, or undefined if not present
-       * @since 2.0.0
-       *
-       * @example
-       * ```typescript
-       * const entry = await client.entries.get('my-entry');
-       * const body = entry.field('body');           // Get markdown body
-       * const difficulty = entry.field('difficulty'); // Get difficulty level
-       * const heroImage = entry.field('heroImage');  // Get hero image UUID
-       * ```
-       */
-      field(key) {
-        return this.data.dataJson?.[key];
-      }
-      /**
-       * Get all fields from the entry's schema-driven content.
-       * @since 2.0.0
-       */
-      get fields() {
-        return this.data.dataJson || {};
-      }
-      /**
-       * Get related entries (future)
-       */
-      async relatedEntries() {
-        throw new Error("Related entries not yet implemented");
-      }
-      /**
-       * Get raw entry data
-       */
-      toJSON() {
-        return this.data;
-      }
-    };
-  }
-});
-
-// src/collections/collection.ts
-var Collection;
-var init_collection = __esm({
-  "src/collections/collection.ts"() {
-    "use strict";
-    Collection = class {
-      constructor(data, http, workspaceSlug) {
-        this.data = data;
-        this.http = http;
-        this.workspaceSlug = workspaceSlug;
-      }
-      data;
-      http;
-      workspaceSlug;
-      // Expose all collection data as properties
-      get id() {
-        return this.data.id;
-      }
-      get name() {
-        return this.data.name;
-      }
-      get slug() {
-        return this.data.slug;
-      }
-      get description() {
-        return this.data.description;
-      }
-      get icon() {
-        return this.data.icon;
-      }
-      get color() {
-        return this.data.color;
-      }
-      get sortOrder() {
-        return this.data.sortOrder;
-      }
-      get isSmart() {
-        return this.data.isSmart;
-      }
-      get smartRules() {
-        return this.data.smartRules;
-      }
-      get createdAt() {
-        return this.data.createdAt;
-      }
-      get updatedAt() {
-        return this.data.updatedAt;
-      }
-      /**
-       * Get all entries in this collection
-       */
-      async entries() {
-        return this.data.entries || [];
-      }
-      /**
-       * Get assets in this collection (future)
-       */
-      async assets() {
-        throw new Error("Collection assets not yet implemented");
-      }
-      /**
-       * Get collection metadata (future)
-       */
-      async metadata() {
-        throw new Error("Collection metadata not yet implemented");
-      }
-      /**
-       * Get raw collection data
-       */
-      toJSON() {
-        return this.data;
-      }
-    };
-  }
-});
-
-// src/resources/resource.ts
-var Resource;
-var init_resource = __esm({
-  "src/resources/resource.ts"() {
-    "use strict";
-    Resource = class {
-      constructor(data, http, workspaceSlug) {
-        this.data = data;
-        this.http = http;
-        this.workspaceSlug = workspaceSlug;
-      }
-      data;
-      http;
-      workspaceSlug;
-      // Expose all resource data as properties
-      get id() {
-        return this.data.id;
-      }
-      get name() {
-        return this.data.name;
-      }
-      get slug() {
-        return this.data.slug;
-      }
-      get resourceType() {
-        return this.data.resourceType;
-      }
-      get description() {
-        return this.data.description;
-      }
-      get externalId() {
-        return this.data.externalId;
-      }
-      get url() {
-        return this.data.url;
-      }
-      get metadata() {
-        return this.data.metadata;
-      }
-      get createdAt() {
-        return this.data.createdAt;
-      }
-      get updatedAt() {
-        return this.data.updatedAt;
-      }
-      /**
-       * Get all entries that reference this resource
-       */
-      async entries() {
-        const endpoint = `/api/publish/${this.workspaceSlug}/resources/${this.data.slug}/entries`;
-        return this.http.fetch(endpoint);
-      }
-      /**
-       * Get assets related to this resource (future)
-       */
-      async assets() {
-        throw new Error("Resource assets not yet implemented");
-      }
-      /**
-       * Get raw resource data
-       */
-      toJSON() {
-        return this.data;
-      }
-    };
-  }
-});
-
-// src/entries/entries.ts
-var EntriesModule;
-var init_entries = __esm({
-  "src/entries/entries.ts"() {
-    "use strict";
-    init_entry();
-    init_errors();
-    EntriesModule = class {
-      constructor(http, workspaceSlug) {
-        this.http = http;
-        this.workspaceSlug = workspaceSlug;
-      }
-      http;
-      workspaceSlug;
-      /**
-       * Get all published entries
-       */
-      async list(options = {}) {
-        const queryString = this.http.buildQueryString({
-          entry_type: options.entryType,
-          collection: options.collection,
-          limit: options.limit,
-          offset: options.offset
-          // Don't send status - backend always returns published
-        });
-        const endpoint = `/api/publish/${this.workspaceSlug}/entries${queryString}`;
-        const response = await this.http.fetch(endpoint);
-        return response.data || [];
-      }
-      /**
-       * Get a single entry by slug
-       * Returns null if entry is not found (404)
-       */
-      async get(slug) {
-        try {
-          const endpoint = `/api/publish/${this.workspaceSlug}/entries/${slug}`;
-          const data = await this.http.fetch(endpoint);
-          return new Entry(data, this.http, this.workspaceSlug);
-        } catch (error) {
-          if (error instanceof MarvinNotFoundError) {
-            return null;
-          }
-          throw error;
-        }
-      }
-      /**
-       * Convenience: Get all pages
-       */
-      async pages(options) {
-        return this.list({ ...options, entryType: "page" });
-      }
-      /**
-       * Convenience: Get all blog posts
-       */
-      async posts(options) {
-        return this.list({ ...options, entryType: "blog" });
-      }
-      /**
-       * Convenience: Get all projects
-       */
-      async projects(options) {
-        return this.list({ ...options, entryType: "project" });
-      }
-    };
-  }
-});
-
-// src/collections/collections.ts
-var CollectionsModule;
-var init_collections = __esm({
-  "src/collections/collections.ts"() {
-    "use strict";
-    init_collection();
-    init_errors();
-    CollectionsModule = class {
-      constructor(http, workspaceSlug) {
-        this.http = http;
-        this.workspaceSlug = workspaceSlug;
-      }
-      http;
-      workspaceSlug;
-      /**
-       * Get all collections
-       */
-      async list() {
-        const endpoint = `/api/publish/${this.workspaceSlug}/collections`;
-        const response = await this.http.fetch(endpoint);
-        return response.data || [];
-      }
-      /**
-       * Get a single collection by slug
-       * Returns null if collection is not found (404)
-       */
-      async get(slug) {
-        try {
-          const endpoint = `/api/publish/${this.workspaceSlug}/collections/${slug}`;
-          const data = await this.http.fetch(endpoint);
-          return new Collection(data, this.http, this.workspaceSlug);
-        } catch (error) {
-          if (error instanceof MarvinNotFoundError) {
-            return null;
-          }
-          throw error;
-        }
-      }
-      /**
-       * Get entries in a collection
-       * Returns empty array if collection is not found
-       */
-      async entries(slug) {
-        const collection = await this.get(slug);
-        if (!collection) {
-          return [];
-        }
-        return collection.entries();
-      }
-      /**
-       * Try multiple collection slugs in fallback order
-       * Returns the first collection that exists and has entries
-       *
-       * @param slugs - Collection slugs to try in order
-       * @param options - Options for fallback behavior
-       * @returns Entries from the first matching collection, or empty array
-       *
-       * @example
-       * ```ts
-       * // Try bench-notes, then journal, then blog
-       * const entries = await collections.fallback(['bench-notes', 'journal', 'blog']);
-       * ```
-       */
-      async fallback(slugs, options = {}) {
-        const { requireEntries = true } = options;
-        for (const slug of slugs) {
-          try {
-            const collection = await this.get(slug);
-            if (!collection) {
-              continue;
-            }
-            const entries = await collection.entries();
-            if (!requireEntries || entries.length > 0) {
-              return entries;
-            }
-          } catch (error) {
-            continue;
-          }
-        }
-        return [];
-      }
-    };
-  }
-});
-
-// src/assets/assets.ts
-var AssetsModule;
-var init_assets = __esm({
-  "src/assets/assets.ts"() {
-    "use strict";
-    AssetsModule = class {
-      constructor(http, workspaceSlug) {
-        this.http = http;
-        this.workspaceSlug = workspaceSlug;
-      }
-      http;
-      workspaceSlug;
-      /**
-       * Get all published assets
-       */
-      async list(options = {}) {
-        const queryString = this.http.buildQueryString({
-          type: options.type,
-          limit: options.limit,
-          offset: options.offset
-        });
-        const endpoint = `/api/publish/${this.workspaceSlug}/assets${queryString}`;
-        const response = await this.http.fetch(endpoint);
-        return response.data || [];
-      }
-      /**
-       * Get a single published asset by slug or ID
-       */
-      async get(slugOrId) {
-        const endpoint = `/api/publish/${this.workspaceSlug}/assets/${slugOrId}`;
-        return this.http.fetch(endpoint);
-      }
-      /**
-       * Convenience: Get all images
-       */
-      async images(options) {
-        return this.list({ ...options, type: "image" });
-      }
-      /**
-       * Convenience: Get all videos
-       */
-      async videos(options) {
-        return this.list({ ...options, type: "video" });
-      }
-      /**
-       * Convenience: Get all documents
-       */
-      async documents(options) {
-        return this.list({ ...options, type: "document" });
-      }
-    };
-  }
-});
-
-// src/resources/resources.ts
-var ResourcesModule;
-var init_resources = __esm({
-  "src/resources/resources.ts"() {
-    "use strict";
-    init_resource();
-    ResourcesModule = class {
-      constructor(http, workspaceSlug) {
-        this.http = http;
-        this.workspaceSlug = workspaceSlug;
-      }
-      http;
-      workspaceSlug;
-      /**
-       * Get all published resources
-       */
-      async list(options = {}) {
-        const queryString = this.http.buildQueryString({
-          resource_type: options.resourceType,
-          limit: options.limit,
-          offset: options.offset
-        });
-        const endpoint = `/api/publish/${this.workspaceSlug}/resources${queryString}`;
-        const response = await this.http.fetch(endpoint);
-        return response.data || [];
-      }
-      /**
-       * Get a single resource by slug
-       */
-      async get(slug) {
-        const endpoint = `/api/publish/${this.workspaceSlug}/resources/${slug}`;
-        const data = await this.http.fetch(endpoint);
-        return new Resource(data, this.http, this.workspaceSlug);
-      }
-      /**
-       * Get entries that reference this resource
-       */
-      async entries(slug) {
-        const resource = await this.get(slug);
-        return resource.entries();
-      }
-    };
-  }
-});
-
-// src/workspaces/workspace.ts
-var Workspace;
-var init_workspace = __esm({
-  "src/workspaces/workspace.ts"() {
-    "use strict";
-    init_entries();
-    init_collections();
-    init_assets();
-    init_resources();
-    Workspace = class {
-      constructor(http, slug) {
-        this.http = http;
-        this._slug = slug;
-        this.entries = new EntriesModule(http, slug);
-        this.collections = new CollectionsModule(http, slug);
-        this.assets = new AssetsModule(http, slug);
-        this.resources = new ResourcesModule(http, slug);
-      }
-      http;
-      _site = null;
-      _slug;
-      entries;
-      collections;
-      assets;
-      resources;
-      /**
-       * Get workspace slug
-       */
-      get slug() {
-        return this._slug;
-      }
-      /**
-       * Get site configuration (cached after first load)
-       */
-      get site() {
-        return this._site;
-      }
-      /**
-       * Load site configuration
-       */
-      async loadSite() {
-        const endpoint = `/api/publish/${this._slug}/site`;
-        this._site = await this.http.fetch(endpoint);
-        return this._site;
-      }
-      /**
-       * Get workspace info (name and slug only)
-       */
-      async getInfo() {
-        const endpoint = `/api/publish/${this._slug}`;
-        return this.http.fetch(endpoint);
-      }
-      /**
-       * Get workspace settings (future)
-       */
-      async settings() {
-        throw new Error("Workspace settings not yet implemented");
-      }
-    };
-  }
-});
-
-// src/client/http.ts
-var MarvinHttpClient;
-var init_http = __esm({
-  "src/client/http.ts"() {
-    "use strict";
-    init_core();
-    MarvinHttpClient = class extends HttpClient {
-      constructor(config) {
-        super({
-          baseUrl: config.apiUrl,
-          auth: new BearerTokenAuth(config.siteClientToken),
-          credentials: "same-origin",
-          debug: config.debug,
-          logger: config.logger
-        });
-      }
-      /**
-       * Fetch endpoint (backward compatibility)
-       */
-      async fetch(endpoint) {
-        return this.get(endpoint);
-      }
-    };
-  }
-});
-
-// src/client/marvin.ts
-var marvin_exports = {};
-__export(marvin_exports, {
-  MarvinClient: () => MarvinClient
-});
-var MarvinClient;
-var init_marvin = __esm({
-  "src/client/marvin.ts"() {
-    "use strict";
-    init_config();
-    init_http();
-    init_core();
-    init_workspace();
-    MarvinClient = class {
-      constructor(config) {
-        this.config = config;
-        validateConfig(config);
-        this.http = new MarvinHttpClient(config);
-        this.cache = new MarvinCache(config.cacheDuration);
-        this.workspace = new Workspace(this.http, config.workspaceSlug);
-        if (config.autoInitialize) {
-          this.initialize();
-        }
-      }
-      config;
-      http;
-      cache;
-      workspace;
-      initialized = false;
-      /**
-       * Initialize the SDK
-       * Preloads site configuration and metadata
-       */
-      async initialize() {
-        if (this.initialized) return;
-        try {
-          await this.workspace.loadSite();
-          this.initialized = true;
-        } catch (error) {
-          console.warn("Marvin SDK initialization warning:", error);
-        }
-      }
-      // ======================
-      // Workspace-First API
-      // ======================
-      /**
-       * Get the workspace object
-       */
-      async getWorkspace() {
-        if (!this.initialized) {
-          await this.initialize();
-        }
-        return this.workspace;
-      }
-      /**
-       * Get site configuration (cached)
-       */
-      get site() {
-        return this.workspace.site;
-      }
-      /**
-       * Get workspace info (name and slug)
-       */
-      async getWorkspaceInfo() {
-        return this.workspace.getInfo();
-      }
-      /**
-       * Get entries module
-       */
-      get entries() {
-        return this.workspace.entries;
-      }
-      /**
-       * Get collections module
-       */
-      get collections() {
-        return this.workspace.collections;
-      }
-      /**
-       * Get assets module
-       */
-      get assets() {
-        return this.workspace.assets;
-      }
-      /**
-       * Get resources module
-       */
-      get resources() {
-        return this.workspace.resources;
-      }
-      // ======================
-      // Convenience Methods
-      // ======================
-      /**
-       * Get a single entry by slug
-       */
-      async entry(slug) {
-        return this.workspace.entries.get(slug);
-      }
-      /**
-       * Get a single collection by slug
-       */
-      async collection(slug) {
-        return this.workspace.collections.get(slug);
-      }
-      /**
-       * Get all pages
-       */
-      async pages(options) {
-        return this.workspace.entries.pages(options);
-      }
-      /**
-       * Get all blog posts
-       */
-      async posts(options) {
-        return this.workspace.entries.posts(options);
-      }
-      /**
-       * Get all projects
-       */
-      async projects(options) {
-        return this.workspace.entries.projects(options);
-      }
-      /**
-       * Get a single resource by slug
-       */
-      async resource(slug) {
-        return this.workspace.resources.get(slug);
-      }
-      /**
-       * Try multiple collection slugs in fallback order
-       * Returns entries from the first collection that exists and has content
-       *
-       * @param slugs - Collection slugs to try in order
-       * @param options - Options for fallback behavior
-       * @returns Entries from the first matching collection, or empty array
-       *
-       * @example
-       * ```ts
-       * // Try bench-notes, then journal, then blog
-       * const entries = await client.collectionFallback(['bench-notes', 'journal', 'blog']);
-       * ```
-       */
-      async collectionFallback(slugs, options) {
-        return this.workspace.collections.fallback(slugs, options);
-      }
-      // ======================
-      // Backwards-Compatible Publishing API
-      // ======================
-      /**
-       * @deprecated Use workspace.site or marvin.site instead
-       * Get site configuration
-       */
-      async getSite() {
-        return this.workspace.loadSite();
-      }
-      /**
-       * @deprecated Use workspace.entries.list() instead
-       * Get all published entries
-       */
-      async getEntries(options) {
-        return this.workspace.entries.list(options);
-      }
-      /**
-       * @deprecated Use workspace.entries.get() instead
-       * Get a single published entry by slug
-       */
-      async getEntry(slug) {
-        const entry = await this.workspace.entries.get(slug);
-        if (!entry) {
-          return null;
-        }
-        return entry.toJSON();
-      }
-      /**
-       * @deprecated Use workspace.collections.list() instead
-       * Get all collections
-       */
-      async getCollections() {
-        return this.workspace.collections.list();
-      }
-      /**
-       * @deprecated Use workspace.collections.get() instead
-       * Get a single collection by slug
-       */
-      async getCollection(slug) {
-        const collection = await this.workspace.collections.get(slug);
-        if (!collection) {
-          return null;
-        }
-        return collection.toJSON();
-      }
-      /**
-       * @deprecated Use workspace.collections.entries() instead
-       * Get all entries in a collection
-       */
-      async getCollectionEntries(slug) {
-        return this.workspace.collections.entries(slug);
-      }
-      /**
-       * @deprecated Use workspace.assets.list() instead
-       * Get all published assets
-       */
-      async getAssets(options) {
-        return this.workspace.assets.list(options);
-      }
-      /**
-       * @deprecated Use workspace.resources.list() instead
-       * Get all published resources
-       */
-      async getResources(options) {
-        return this.workspace.resources.list(options);
-      }
-      /**
-       * @deprecated Use workspace.resources.get() instead
-       * Get a single resource by slug
-       */
-      async getResource(slug) {
-        const resource = await this.workspace.resources.get(slug);
-        return resource.toJSON();
-      }
-      /**
-       * @deprecated Use workspace.resources.entries() instead
-       * Get entries that reference a resource
-       */
-      async getResourceEntries(slug) {
-        return this.workspace.resources.entries(slug);
-      }
-    };
-  }
-});
-
-export {
-  createConfigFromEnv,
-  config_exports,
-  init_config,
-  Entry,
-  init_entry,
-  Collection,
-  init_collection,
-  Resource,
-  init_resource,
-  Workspace,
-  init_workspace,
-  MarvinClient,
-  marvin_exports,
-  init_marvin
-};