@chanomhub/sdk 1.0.1

package/dist/index.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Chanomhub API SDK
+ *
+ * A framework-agnostic TypeScript SDK for interacting with the Chanomhub API.
+ * Works with Next.js, React Native, Node.js, and browser environments.
+ *
+ * @example
+ * ```typescript
+ * import { createChanomhubClient } from '@/lib/chanomhub-sdk';
+ *
+ * // Basic usage
+ * const sdk = createChanomhubClient();
+ * const articles = await sdk.articles.getByTag('renpy');
+ *
+ * // With authentication
+ * const sdk = createChanomhubClient({ token: 'your-jwt-token' });
+ * const article = await sdk.articles.getBySlug('my-article');
+ *
+ * // With custom config
+ * const sdk = createChanomhubClient({
+ *   apiUrl: 'https://api.chanomhub.online',
+ *   cdnUrl: 'https://cdn.chanomhub.com',
+ *   token: 'jwt-token',
+ * });
+ * ```
+ *
+ * For Next.js server components, use the helper from './next':
+ * ```typescript
+ * import { createServerClient } from '@/lib/chanomhub-sdk/next';
+ * const sdk = await createServerClient(); // Reads token from cookies
+ * ```
+ */
+import { type GraphQLFetcher } from './client';
+import { type ArticleRepository } from './repositories';
+import { type ChanomhubConfig } from './config';
+export * from './types';
+export * from './config';
+export { resolveImageUrl } from './transforms/imageUrl';
+/** Chanomhub SDK Client interface */
+export interface ChanomhubClient {
+    /** Article operations */
+    articles: ArticleRepository;
+    /** Raw GraphQL fetcher for custom queries */
+    graphql: GraphQLFetcher;
+    /** SDK configuration */
+    config: ChanomhubConfig;
+}
+/**
+ * Creates a Chanomhub API client
+ *
+ * This is the main entry point for the SDK. It creates a client that can be
+ * used to interact with the Chanomhub API.
+ *
+ * @param config - Configuration options
+ * @param config.apiUrl - API base URL (default: https://api.chanomhub.online)
+ * @param config.cdnUrl - CDN base URL for images (default: https://cdn.chanomhub.com)
+ * @param config.token - JWT authentication token (optional)
+ * @param config.defaultCacheSeconds - Default cache duration in seconds (default: 3600)
+ * @returns ChanomhubClient with articles repository and raw graphql fetcher
+ *
+ * @example
+ * ```typescript
+ * // Public access
+ * const sdk = createChanomhubClient();
+ *
+ * // With authentication
+ * const sdk = createChanomhubClient({ token: 'your-jwt-token' });
+ * ```
+ */
+export declare function createChanomhubClient(config?: Partial<ChanomhubConfig>): ChanomhubClient;
+/**
+ * Creates a client with authentication token
+ * Convenience function for authenticated requests
+ *
+ * @param token - JWT authentication token
+ * @param config - Optional configuration overrides
+ * @returns ChanomhubClient
+ */
+export declare function createAuthenticatedClient(token: string, config?: Partial<ChanomhubConfig>): ChanomhubClient;
+export default createChanomhubClient;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AACpE,OAAO,EAA2B,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACjF,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AAGhE,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,qCAAqC;AACrC,MAAM,WAAW,eAAe;IAC5B,yBAAyB;IACzB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,6CAA6C;IAC7C,OAAO,EAAE,cAAc,CAAC;IACxB,wBAAwB;IACxB,MAAM,EAAE,eAAe,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM,GAAG,eAAe,CAc5F;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM,GAAG,eAAe,CAM/G;AAGD,eAAe,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,112 @@
+"use strict";
+/**
+ * Chanomhub API SDK
+ *
+ * A framework-agnostic TypeScript SDK for interacting with the Chanomhub API.
+ * Works with Next.js, React Native, Node.js, and browser environments.
+ *
+ * @example
+ * ```typescript
+ * import { createChanomhubClient } from '@/lib/chanomhub-sdk';
+ *
+ * // Basic usage
+ * const sdk = createChanomhubClient();
+ * const articles = await sdk.articles.getByTag('renpy');
+ *
+ * // With authentication
+ * const sdk = createChanomhubClient({ token: 'your-jwt-token' });
+ * const article = await sdk.articles.getBySlug('my-article');
+ *
+ * // With custom config
+ * const sdk = createChanomhubClient({
+ *   apiUrl: 'https://api.chanomhub.online',
+ *   cdnUrl: 'https://cdn.chanomhub.com',
+ *   token: 'jwt-token',
+ * });
+ * ```
+ *
+ * For Next.js server components, use the helper from './next':
+ * ```typescript
+ * import { createServerClient } from '@/lib/chanomhub-sdk/next';
+ * const sdk = await createServerClient(); // Reads token from cookies
+ * ```
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveImageUrl = void 0;
+exports.createChanomhubClient = createChanomhubClient;
+exports.createAuthenticatedClient = createAuthenticatedClient;
+const client_1 = require("./client");
+const repositories_1 = require("./repositories");
+const config_1 = require("./config");
+// Re-export types
+__exportStar(require("./types"), exports);
+__exportStar(require("./config"), exports);
+var imageUrl_1 = require("./transforms/imageUrl");
+Object.defineProperty(exports, "resolveImageUrl", { enumerable: true, get: function () { return imageUrl_1.resolveImageUrl; } });
+/**
+ * Creates a Chanomhub API client
+ *
+ * This is the main entry point for the SDK. It creates a client that can be
+ * used to interact with the Chanomhub API.
+ *
+ * @param config - Configuration options
+ * @param config.apiUrl - API base URL (default: https://api.chanomhub.online)
+ * @param config.cdnUrl - CDN base URL for images (default: https://cdn.chanomhub.com)
+ * @param config.token - JWT authentication token (optional)
+ * @param config.defaultCacheSeconds - Default cache duration in seconds (default: 3600)
+ * @returns ChanomhubClient with articles repository and raw graphql fetcher
+ *
+ * @example
+ * ```typescript
+ * // Public access
+ * const sdk = createChanomhubClient();
+ *
+ * // With authentication
+ * const sdk = createChanomhubClient({ token: 'your-jwt-token' });
+ * ```
+ */
+function createChanomhubClient(config = {}) {
+    const fullConfig = {
+        ...config_1.DEFAULT_CONFIG,
+        ...config,
+    };
+    const graphql = (0, client_1.createGraphQLClient)(fullConfig);
+    const articles = (0, repositories_1.createArticleRepository)(graphql);
+    return {
+        articles,
+        graphql,
+        config: fullConfig,
+    };
+}
+/**
+ * Creates a client with authentication token
+ * Convenience function for authenticated requests
+ *
+ * @param token - JWT authentication token
+ * @param config - Optional configuration overrides
+ * @returns ChanomhubClient
+ */
+function createAuthenticatedClient(token, config = {}) {
+    return createChanomhubClient({
+        ...config,
+        token,
+        defaultCacheSeconds: 0, // Disable cache for authenticated requests
+    });
+}
+// Default export
+exports.default = createChanomhubClient;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;;;;;;;;;;;;;;;;;AA2CH,sDAcC;AAUD,8DAMC;AAvED,qCAAoE;AACpE,iDAAiF;AACjF,qCAAgE;AAEhE,kBAAkB;AAClB,0CAAwB;AACxB,2CAAyB;AACzB,kDAAwD;AAA/C,2GAAA,eAAe,OAAA;AAYxB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,SAAgB,qBAAqB,CAAC,SAAmC,EAAE;IACvE,MAAM,UAAU,GAAoB;QAChC,GAAG,uBAAc;QACjB,GAAG,MAAM;KACZ,CAAC;IAEF,MAAM,OAAO,GAAG,IAAA,4BAAmB,EAAC,UAAU,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,IAAA,sCAAuB,EAAC,OAAO,CAAC,CAAC;IAElD,OAAO;QACH,QAAQ;QACR,OAAO;QACP,MAAM,EAAE,UAAU;KACrB,CAAC;AACN,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,yBAAyB,CAAC,KAAa,EAAE,SAAmC,EAAE;IAC1F,OAAO,qBAAqB,CAAC;QACzB,GAAG,MAAM;QACT,KAAK;QACL,mBAAmB,EAAE,CAAC,EAAE,2CAA2C;KACtE,CAAC,CAAC;AACP,CAAC;AAED,iBAAiB;AACjB,kBAAe,qBAAqB,CAAC"}

package/dist/next.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Chanomhub SDK - Next.js Helpers
+ *
+ * Optional module for Next.js-specific functionality.
+ * Import from '@/lib/chanomhub-sdk/next' only in Next.js projects.
+ *
+ * @example
+ * ```typescript
+ * // In a Next.js Server Component
+ * import { createServerClient } from '@/lib/chanomhub-sdk/next';
+ *
+ * const sdk = await createServerClient();
+ * const articles = await sdk.articles.getAll();
+ * ```
+ */
+import { type ChanomhubClient, type ChanomhubConfig } from './index';
+/**
+ * Creates a server-side Chanomhub client for Next.js
+ * Automatically reads authentication token from cookies
+ *
+ * @param config - Optional configuration overrides
+ * @returns Promise<ChanomhubClient>
+ */
+export declare function createServerClient(config?: Partial<ChanomhubConfig>): Promise<ChanomhubClient>;
+/**
+ * Gets the current auth token from Next.js cookies
+ * Useful when you need to pass the token to client components
+ */
+export declare function getAuthToken(): Promise<string | undefined>;
+//# sourceMappingURL=next.d.ts.map

package/dist/next.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.d.ts","sourceRoot":"","sources":["../next.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAyB,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,SAAS,CAAC;AAE5F;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAYxG;AAED;;;GAGG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAIhE"}

package/dist/next.js

@@ -0,0 +1,84 @@
+"use strict";
+/**
+ * Chanomhub SDK - Next.js Helpers
+ *
+ * Optional module for Next.js-specific functionality.
+ * Import from '@/lib/chanomhub-sdk/next' only in Next.js projects.
+ *
+ * @example
+ * ```typescript
+ * // In a Next.js Server Component
+ * import { createServerClient } from '@/lib/chanomhub-sdk/next';
+ *
+ * const sdk = await createServerClient();
+ * const articles = await sdk.articles.getAll();
+ * ```
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createServerClient = createServerClient;
+exports.getAuthToken = getAuthToken;
+const index_1 = require("./index");
+/**
+ * Creates a server-side Chanomhub client for Next.js
+ * Automatically reads authentication token from cookies
+ *
+ * @param config - Optional configuration overrides
+ * @returns Promise<ChanomhubClient>
+ */
+async function createServerClient(config = {}) {
+    var _a;
+    // Dynamic import to avoid bundling next/headers in non-Next.js environments
+    const { cookies } = await Promise.resolve().then(() => __importStar(require('next/headers')));
+    const cookieStore = await cookies();
+    const token = (_a = cookieStore.get('token')) === null || _a === void 0 ? void 0 : _a.value;
+    return (0, index_1.createChanomhubClient)({
+        ...config,
+        token,
+        // Disable cache when authenticated
+        defaultCacheSeconds: token ? 0 : config.defaultCacheSeconds,
+    });
+}
+/**
+ * Gets the current auth token from Next.js cookies
+ * Useful when you need to pass the token to client components
+ */
+async function getAuthToken() {
+    var _a;
+    const { cookies } = await Promise.resolve().then(() => __importStar(require('next/headers')));
+    const cookieStore = await cookies();
+    return (_a = cookieStore.get('token')) === null || _a === void 0 ? void 0 : _a.value;
+}
+//# sourceMappingURL=next.js.map

package/dist/next.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.js","sourceRoot":"","sources":["../next.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAWH,gDAYC;AAMD,oCAIC;AA/BD,mCAA4F;AAE5F;;;;;;GAMG;AACI,KAAK,UAAU,kBAAkB,CAAC,SAAmC,EAAE;;IAC1E,4EAA4E;IAC5E,MAAM,EAAE,OAAO,EAAE,GAAG,wDAAa,cAAc,GAAC,CAAC;IACjD,MAAM,WAAW,GAAG,MAAM,OAAO,EAAE,CAAC;IACpC,MAAM,KAAK,GAAG,MAAA,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,0CAAE,KAAK,CAAC;IAE9C,OAAO,IAAA,6BAAqB,EAAC;QACzB,GAAG,MAAM;QACT,KAAK;QACL,mCAAmC;QACnC,mBAAmB,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,mBAAmB;KAC9D,CAAC,CAAC;AACP,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,YAAY;;IAC9B,MAAM,EAAE,OAAO,EAAE,GAAG,wDAAa,cAAc,GAAC,CAAC;IACjD,MAAM,WAAW,GAAG,MAAM,OAAO,EAAE,CAAC;IACpC,OAAO,MAAA,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,0CAAE,KAAK,CAAC;AAC3C,CAAC"}

package/dist/repositories/articleRepository.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Chanomhub SDK - Article Repository
+ */
+import type { GraphQLFetcher } from '../client';
+import type { Article, ArticleListItem, ArticleListOptions, ArticleWithDownloads } from '../types/article';
+export interface ArticleRepository {
+    /** Get paginated list of articles */
+    getAll(options?: ArticleListOptions): Promise<ArticleListItem[]>;
+    /** Get articles by tag */
+    getByTag(tag: string, options?: {
+        limit?: number;
+    }): Promise<ArticleListItem[]>;
+    /** Get articles by platform */
+    getByPlatform(platform: string, options?: {
+        limit?: number;
+    }): Promise<ArticleListItem[]>;
+    /** Get articles by category */
+    getByCategory(category: string, options?: {
+        limit?: number;
+    }): Promise<ArticleListItem[]>;
+    /** Get single article by slug */
+    getBySlug(slug: string, language?: string): Promise<Article | null>;
+    /** Get article with downloads */
+    getWithDownloads(slug: string, language?: string): Promise<ArticleWithDownloads>;
+}
+/**
+ * Creates an article repository with the given GraphQL client
+ */
+export declare function createArticleRepository(fetcher: GraphQLFetcher): ArticleRepository;
+//# sourceMappingURL=articleRepository.d.ts.map

package/dist/repositories/articleRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"articleRepository.d.ts","sourceRoot":"","sources":["../../repositories/articleRepository.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAgB,MAAM,WAAW,CAAC;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAsH3G,MAAM,WAAW,iBAAiB;IAChC,qCAAqC;IACrC,MAAM,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAEjE,0BAA0B;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAEhF,+BAA+B;IAC/B,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAE1F,+BAA+B;IAC/B,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAE1F,iCAAiC;IACjC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAEpE,iCAAiC;IACjC,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAClF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,cAAc,GAAG,iBAAiB,CAiLlF"}

package/dist/repositories/articleRepository.js

@@ -0,0 +1,265 @@
+"use strict";
+/**
+ * Chanomhub SDK - Article Repository
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createArticleRepository = createArticleRepository;
+// GraphQL Fragments for reuse
+const ARTICLE_LIST_FIELDS = `
+  id
+  title
+  slug
+  description
+  ver
+  createdAt
+  updatedAt
+  mainImage
+  coverImage
+  favoritesCount
+  favorited
+  status
+  sequentialCode
+  engine {
+    id
+    name
+  }
+  author {
+    name
+    image
+  }
+  creators {
+    id
+    name
+  }
+  tags {
+    id
+    name
+  }
+  platforms {
+    id
+    name
+  }
+  categories {
+    id
+    name
+  }
+  images {
+    id
+    url
+  }
+`;
+const ARTICLE_FULL_FIELDS = `
+  id
+  title
+  slug
+  description
+  body
+  ver
+  createdAt
+  updatedAt
+  status
+  engine {
+    id
+    name
+  }
+  mainImage
+  backgroundImage
+  coverImage
+  favorited
+  favoritesCount
+  sequentialCode
+  images {
+    id
+    url
+  }
+  author {
+    name
+    bio
+    image
+    backgroundImage
+    following
+    socialMediaLinks {
+      platform
+      url
+    }
+  }
+  creators {
+    id
+    name
+  }
+  tags {
+    id
+    name
+  }
+  platforms {
+    id
+    name
+  }
+  categories {
+    id
+    name
+  }
+  mods {
+    id
+    name
+    description
+    creditTo
+    downloadLink
+    version
+    status
+    categories {
+      id
+      name
+    }
+    images {
+      id
+      url
+    }
+  }
+`;
+/**
+ * Creates an article repository with the given GraphQL client
+ */
+function createArticleRepository(fetcher) {
+    async function getAll(options = {}) {
+        const { limit = 12, offset = 0, status = 'PUBLISHED', filter = {} } = options;
+        // Build filter string
+        const filterParts = [];
+        if (filter.tag)
+            filterParts.push(`tag: "${filter.tag}"`);
+        if (filter.platform)
+            filterParts.push(`platform: "${filter.platform}"`);
+        if (filter.category)
+            filterParts.push(`category: "${filter.category}"`);
+        if (filter.author)
+            filterParts.push(`author: "${filter.author}"`);
+        if (filter.favorited !== undefined)
+            filterParts.push(`favorited: ${filter.favorited}`);
+        const filterArg = filterParts.length > 0 ? `filter: { ${filterParts.join(', ')} }, ` : '';
+        const query = `query GetArticles {
+      articles(${filterArg}limit: ${limit}, offset: ${offset}, status: ${status}) {
+        ${ARTICLE_LIST_FIELDS}
+      }
+    }`;
+        const { data, errors } = await fetcher(query, {}, {
+            operationName: 'GetArticles',
+        });
+        if (errors || !data) {
+            console.error('Failed to fetch articles:', errors);
+            return [];
+        }
+        return data.articles || [];
+    }
+    async function getByTag(tag, options = {}) {
+        const { limit = 50 } = options;
+        const query = `query GetArticlesByTag($tag: String!) {
+      articles(filter: { tag: $tag }, status: PUBLISHED, limit: ${limit}) {
+        ${ARTICLE_LIST_FIELDS}
+      }
+    }`;
+        const { data, errors } = await fetcher(query, { tag }, {
+            operationName: 'GetArticlesByTag',
+        });
+        if (errors || !data) {
+            console.error('Failed to fetch articles by tag:', errors);
+            return [];
+        }
+        return data.articles || [];
+    }
+    async function getByPlatform(platform, options = {}) {
+        const { limit = 50 } = options;
+        const query = `query GetArticlesByPlatform($platform: String!) {
+      articles(filter: { platform: $platform }, status: PUBLISHED, limit: ${limit}) {
+        ${ARTICLE_LIST_FIELDS}
+      }
+    }`;
+        const { data, errors } = await fetcher(query, { platform }, {
+            operationName: 'GetArticlesByPlatform',
+        });
+        if (errors || !data) {
+            console.error('Failed to fetch articles by platform:', errors);
+            return [];
+        }
+        return data.articles || [];
+    }
+    async function getByCategory(category, options = {}) {
+        const { limit = 50 } = options;
+        const query = `query GetArticlesByCategory($category: String!) {
+      articles(filter: { category: $category }, status: PUBLISHED, limit: ${limit}) {
+        ${ARTICLE_LIST_FIELDS}
+      }
+    }`;
+        const { data, errors } = await fetcher(query, { category }, {
+            operationName: 'GetArticlesByCategory',
+        });
+        if (errors || !data) {
+            console.error('Failed to fetch articles by category:', errors);
+            return [];
+        }
+        return data.articles || [];
+    }
+    async function getBySlug(slug, language) {
+        const query = `query GetArticleBySlug($slug: String!, $language: String) {
+      article(slug: $slug, language: $language) {
+        ${ARTICLE_FULL_FIELDS}
+      }
+    }`;
+        const { data, errors } = await fetcher(query, { slug, language }, {
+            operationName: 'GetArticleBySlug',
+        });
+        if (errors || !data) {
+            console.error('Failed to fetch article by slug:', errors);
+            return null;
+        }
+        return data.article || null;
+    }
+    async function getWithDownloads(slug, language) {
+        const query = `query GetArticleWithDownloads($slug: String!, $language: String, $downloadsArticleId: Int) {
+      article(slug: $slug, language: $language) {
+        ${ARTICLE_FULL_FIELDS}
+      }
+      downloads(articleId: $downloadsArticleId) {
+        id
+        name
+        url
+        isActive
+        vipOnly
+        createdAt
+      }
+      officialDownloadSources(articleId: $downloadsArticleId) {
+        id
+        name
+        url
+        status
+      }
+    }`;
+        // First get article to get its ID
+        const articleResult = await getBySlug(slug, language);
+        if (!articleResult) {
+            return { article: null, downloads: null };
+        }
+        const { data, errors } = await fetcher(query, { slug, language, downloadsArticleId: articleResult.id }, { operationName: 'GetArticleWithDownloads' });
+        if (errors || !data) {
+            console.error('Failed to fetch article with downloads:', errors);
+            return { article: articleResult, downloads: null };
+        }
+        // Combine data
+        if (data.article) {
+            data.article.downloads = data.downloads || [];
+            data.article.officialDownloadSources = data.officialDownloadSources || [];
+        }
+        return {
+            article: data.article || articleResult,
+            downloads: data.downloads || null,
+        };
+    }
+    return {
+        getAll,
+        getByTag,
+        getByPlatform,
+        getByCategory,
+        getBySlug,
+        getWithDownloads,
+    };
+}
+//# sourceMappingURL=articleRepository.js.map

package/dist/repositories/articleRepository.js.map

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

package/dist/repositories/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Chanomhub SDK - Repositories Index
+ */
+export { createArticleRepository, type ArticleRepository } from './articleRepository';
+//# sourceMappingURL=index.d.ts.map

package/dist/repositories/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../repositories/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,uBAAuB,EAAE,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/repositories/index.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Chanomhub SDK - Repositories Index
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createArticleRepository = void 0;
+var articleRepository_1 = require("./articleRepository");
+Object.defineProperty(exports, "createArticleRepository", { enumerable: true, get: function () { return articleRepository_1.createArticleRepository; } });
+//# sourceMappingURL=index.js.map

package/dist/repositories/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../repositories/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,yDAAsF;AAA7E,4HAAA,uBAAuB,OAAA"}

package/dist/transforms/imageUrl.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Image URL Transformation
+ *
+ * Transforms filename-only URLs to full CDN URLs
+ */
+/**
+ * Resolves an image URL.
+ * - If it's just a filename (e.g., "abc.jpg"), prepends the CDN base URL
+ * - If it's already a full URL, returns it as-is
+ * - Handles null/undefined gracefully
+ */
+export declare function resolveImageUrl(imageUrl: string | null | undefined, cdnUrl: string): string | null;
+/**
+ * Deep transforms all image URLs in an object/array recursively.
+ */
+export declare function transformImageUrlsDeep<T>(data: T, cdnUrl: string): T;
+//# sourceMappingURL=imageUrl.d.ts.map

package/dist/transforms/imageUrl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageUrl.d.ts","sourceRoot":"","sources":["../../transforms/imageUrl.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUlG;AAUD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,CAqCpE"}