@canvas-digital/blog-sdk 2.0.0 → 2.0.1

package/README.md

@@ -43,20 +43,23 @@ apiKey: bp_public_...   # or admin key
 domain: example.com     # optional
 ```
 
-## Host app / package `.env` (API base URL)
+## Host app `.env` (API base URL)
 
-This package includes root `.env.example`. On a new machine:
+Use **one key** in every host app (Vite React, Next.js, or anything else):
 
 ```bash
-cp .env.example .env
+BLOG_API_URL=https://blog-platform-backend-omega.vercel.app/api/v1
 ```
 
-```bash
-# Platform API v1 (not the customer website)
-VITE_BLOG_API_URL=http://localhost:8000/api/v1
-```
+| Host | How `BLOG_API_URL` is exposed |
+|------|-------------------------------|
+| **Vite** | Set `envPrefix: ["VITE_", "BLOG_"]` in `vite.config` (see examples) |
+| **Next.js** | Map it in `next.config` `env: { BLOG_API_URL: process.env.BLOG_API_URL }` |
+| **Prop** | `<BlogPlatform apiUrl={...} />` overrides env |
+
+Restart the dev server after changing `.env`. If unset, the SDK defaults to the production URL above. Legacy `VITE_BLOG_API_URL` / `NEXT_PUBLIC_BLOG_API_URL` still work.
 
-`email`, `apiKey`, and optional `domain` are **props** on `BlogPlatform`, not env vars in this package.
+`email`, `apiKey`, and optional `domain` are **props** on `BlogPlatform`, not env vars.
 
 ## Usage in your React app
 
@@ -95,7 +98,7 @@ import { BlogPlatform } from "@canvas-digital/blog-sdk";
 | `theme` | user UI layout/colors |
 | `adminTheme` | admin UI theme |
 | `timeoutMs` | request timeout |
-| `apiUrl` | override env API base URL (usually omit) |
+| `apiUrl` | override `BLOG_API_URL` (usually omit) |
 | `className` | wrapper class |
 
 ## Develop this package
@@ -108,3 +111,15 @@ npm test
 npm run build
 npm run dev            # playground reads root .env
 ```
+
+## Publish to npm
+
+Create a granular access token on [npmjs.com](https://www.npmjs.com) (publish permission for `@canvas-digital/blog-sdk`). Do not commit the token.
+
+```bash
+npm config set //registry.npmjs.org/:_authToken=YOUR_NEW_TOKEN
+npm whoami
+npm publish --access public
+```
+
+Bump `"version"` in `package.json` before each new release (npm rejects republishing the same version).

package/dist/BlogPlatform.d.ts

@@ -20,8 +20,7 @@ export type BlogPlatformProps = {
     email: string;
     /**
      * Optional override for the platform API base URL.
-     * Prefer setting this in the host app `.env` instead:
-     * `VITE_BLOG_API_URL` or `NEXT_PUBLIC_BLOG_API_URL`
+     * Prefer `BLOG_API_URL` in the host app `.env` (works for Vite, Next, etc.).
      */
     apiUrl?: string;
     timeoutMs?: number;
@@ -34,7 +33,7 @@ export type BlogPlatformProps = {
  * Drop into any React / Next.js app after `npm install @canvas-digital/blog-sdk`.
  *
  * - `email` + `apiKey` (+ optional `domain`) are sent as request headers
- * - API base URL comes from your app `.env` (`VITE_BLOG_API_URL` / `NEXT_PUBLIC_BLOG_API_URL`)
+ * - API base URL from host `.env` key `BLOG_API_URL` (or prop `apiUrl`)
  */
 export declare function BlogPlatform({ mode, domain, apiKey: apiKeyProp, email: emailProp, apiUrl: apiUrlOverride, timeoutMs, theme, branding, adminTheme, className, }: BlogPlatformProps): import("react").JSX.Element;
 //# sourceMappingURL=BlogPlatform.d.ts.map

package/dist/BlogPlatform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BlogPlatform.d.ts","sourceRoot":"","sources":["../app/BlogPlatform.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,IAAI,aAAa,EAAE,MAAM,eAAe,CAAC;AAE3E,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAGxD,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,OAAO,CAAC;AAEhD,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;;OAGG;IACH,IAAI,EAAE,gBAAgB,CAAC;IACvB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,QAAQ,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC;IACpC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,EAC3B,IAAI,EACJ,MAAM,EACN,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,cAAc,EACtB,SAAS,EACT,KAAK,EACL,QAAQ,EACR,UAAU,EACV,SAAS,GACV,EAAE,iBAAiB,+BAwDnB"}
+{"version":3,"file":"BlogPlatform.d.ts","sourceRoot":"","sources":["../app/BlogPlatform.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,IAAI,aAAa,EAAE,MAAM,eAAe,CAAC;AAE3E,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAGxD,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,OAAO,CAAC;AAEhD,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;;OAGG;IACH,IAAI,EAAE,gBAAgB,CAAC;IACvB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,QAAQ,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC;IACpC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,EAC3B,IAAI,EACJ,MAAM,EACN,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,cAAc,EACtB,SAAS,EACT,KAAK,EACL,QAAQ,EACR,UAAU,EACV,SAAS,GACV,EAAE,iBAAiB,+BAuDnB"}

package/dist/BlogPlatform.js

@@ -6,7 +6,7 @@ import { normalizeDomain, resolveBlogApiUrl } from "./utils/env";
  * Drop into any React / Next.js app after `npm install @canvas-digital/blog-sdk`.
  *
  * - `email` + `apiKey` (+ optional `domain`) are sent as request headers
- * - API base URL comes from your app `.env` (`VITE_BLOG_API_URL` / `NEXT_PUBLIC_BLOG_API_URL`)
+ * - API base URL from host `.env` key `BLOG_API_URL` (or prop `apiUrl`)
  */
 export function BlogPlatform({ mode, domain, apiKey: apiKeyProp, email: emailProp, apiUrl: apiUrlOverride, timeoutMs, theme, branding, adminTheme, className, }) {
     const clientDomain = normalizeDomain(domain);
@@ -17,7 +17,7 @@ export function BlogPlatform({ mode, domain, apiKey: apiKeyProp, email: emailPro
         return (_jsxs("div", { className: className, role: "alert", children: ["Provide ", _jsx("code", { children: "mode" }), ", ", _jsx("code", { children: "email" }), ", and ", _jsx("code", { children: "apiKey" }), " ", "(sent as request headers). ", _jsx("code", { children: "domain" }), " is optional."] }));
     }
     if (!apiUrl) {
-        return (_jsxs("div", { className: className, role: "alert", children: ["Set the Blog API base URL in your app ", _jsx("code", { children: ".env" }), " as", " ", _jsx("code", { children: "VITE_BLOG_API_URL" }), " or ", _jsx("code", { children: "NEXT_PUBLIC_BLOG_API_URL" }), " ", "(e.g. ", _jsx("code", { children: "https://api.yourplatform.com/api/v1" }), ")."] }));
+        return (_jsxs("div", { className: className, role: "alert", children: ["Set ", _jsx("code", { children: "BLOG_API_URL" }), " in your app ", _jsx("code", { children: ".env" }), " ", "(e.g. ", _jsx("code", { children: "https://blog-platform-backend-omega.vercel.app/api/v1" }), ")."] }));
     }
     if (mode === "admin") {
         return (_jsx(BlogAdmin, { className: className, config: {

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export * from "./services";
 export { BlogList, BlogDetail, BlogSearch, BlogCategories, BlogTags, FeaturedBlogs, RelatedBlogs, } from "./components/user";
-export { sanitizeHtml, normalizeDomain, resolveBlogApiUrl, } from "./utils";
+export { sanitizeHtml, normalizeDomain, resolveBlogApiUrl, DEFAULT_BLOG_API_URL, } from "./utils";
 export { DEFAULT_THEME, formatDate, cardStyle, } from "./styles/userTheme";
 export type { BlogTheme, ThemeColors, ThemeFonts, BlogComponentProps, Branding, } from "./types/user";
 export { BlogAdmin } from "./pages/admin";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../app/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAE3B,OAAO,EACL,QAAQ,EACR,UAAU,EACV,UAAU,EACV,cAAc,EACd,QAAQ,EACR,aAAa,EACb,YAAY,GACb,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,YAAY,EACZ,eAAe,EACf,iBAAiB,GAClB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,aAAa,EACb,UAAU,EACV,SAAS,GACV,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACV,SAAS,EACT,WAAW,EACX,UAAU,EACV,kBAAkB,EAClB,QAAQ,GACT,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,OAAO,EACL,QAAQ,EACR,UAAU,EACV,eAAe,EACf,UAAU,EACV,YAAY,GACb,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,YAAY,EAAE,UAAU,EAAE,QAAQ,IAAI,aAAa,EAAE,MAAM,eAAe,CAAC;AAE3E,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../app/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAE3B,OAAO,EACL,QAAQ,EACR,UAAU,EACV,UAAU,EACV,cAAc,EACd,QAAQ,EACR,aAAa,EACb,YAAY,GACb,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,aAAa,EACb,UAAU,EACV,SAAS,GACV,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACV,SAAS,EACT,WAAW,EACX,UAAU,EACV,kBAAkB,EAClB,QAAQ,GACT,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,OAAO,EACL,QAAQ,EACR,UAAU,EACV,eAAe,EACf,UAAU,EACV,YAAY,GACb,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,YAAY,EAAE,UAAU,EAAE,QAAQ,IAAI,aAAa,EAAE,MAAM,eAAe,CAAC;AAE3E,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,cAAc,gBAAgB,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
 export * from "./services";
 export { BlogList, BlogDetail, BlogSearch, BlogCategories, BlogTags, FeaturedBlogs, RelatedBlogs, } from "./components/user";
-export { sanitizeHtml, normalizeDomain, resolveBlogApiUrl, } from "./utils";
+export { sanitizeHtml, normalizeDomain, resolveBlogApiUrl, DEFAULT_BLOG_API_URL, } from "./utils";
 export { DEFAULT_THEME, formatDate, cardStyle, } from "./styles/userTheme";
 export { BlogAdmin } from "./pages/admin";
 export { PostList, PostEditor, CategoryManager, TagManager, MediaManager, } from "./components/admin";

package/dist/utils/env.d.ts

@@ -3,14 +3,18 @@
  * `https://example.com/blog` → `example.com`
  */
 export declare function normalizeDomain(input?: string | null): string;
+/** Deployed platform API — used when `BLOG_API_URL` is unset. */
+export declare const DEFAULT_BLOG_API_URL = "https://blog-platform-backend-omega.vercel.app/api/v1";
 /**
- * Blog platform API base URL from the host app `.env`.
- * Supported names (first match wins):
- * - BLOG_API_URL
- * - VITE_BLOG_API_URL
- * - NEXT_PUBLIC_BLOG_API_URL
- * - VITE_API_URL
- * - NEXT_PUBLIC_API_URL
+ * Resolve the Blog Platform API base URL.
+ *
+ * One key for every host (Vite, Next, CRA, Node):
+ * ```bash
+ * BLOG_API_URL=https://blog-platform-backend-omega.vercel.app/api/v1
+ * ```
+ *
+ * Legacy aliases still work: `VITE_BLOG_API_URL`, `NEXT_PUBLIC_BLOG_API_URL`.
+ * Or pass `apiUrl` on `<BlogPlatform />`.
  */
 export declare function resolveBlogApiUrl(override?: string): string;
 //# sourceMappingURL=env.d.ts.map

package/dist/utils/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../app/utils/env.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAY7D;AAuBD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAc3D"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../app/utils/env.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAY7D;AAuBD,iEAAiE;AACjE,eAAO,MAAM,oBAAoB,0DACwB,CAAC;AAE1D;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAY3D"}

package/dist/utils/env.js

@@ -34,14 +34,18 @@ function readEnv(name) {
     }
     return undefined;
 }
+/** Deployed platform API — used when `BLOG_API_URL` is unset. */
+export const DEFAULT_BLOG_API_URL = "https://blog-platform-backend-omega.vercel.app/api/v1";
 /**
- * Blog platform API base URL from the host app `.env`.
- * Supported names (first match wins):
- * - BLOG_API_URL
- * - VITE_BLOG_API_URL
- * - NEXT_PUBLIC_BLOG_API_URL
- * - VITE_API_URL
- * - NEXT_PUBLIC_API_URL
+ * Resolve the Blog Platform API base URL.
+ *
+ * One key for every host (Vite, Next, CRA, Node):
+ * ```bash
+ * BLOG_API_URL=https://blog-platform-backend-omega.vercel.app/api/v1
+ * ```
+ *
+ * Legacy aliases still work: `VITE_BLOG_API_URL`, `NEXT_PUBLIC_BLOG_API_URL`.
+ * Or pass `apiUrl` on `<BlogPlatform />`.
  */
 export function resolveBlogApiUrl(override) {
     const explicit = override?.trim();
@@ -50,8 +54,6 @@ export function resolveBlogApiUrl(override) {
     }
     const fromEnv = readEnv("BLOG_API_URL") ??
         readEnv("VITE_BLOG_API_URL") ??
-        readEnv("NEXT_PUBLIC_BLOG_API_URL") ??
-        readEnv("VITE_API_URL") ??
-        readEnv("NEXT_PUBLIC_API_URL");
-    return (fromEnv ?? "").replace(/\/+$/, "");
+        readEnv("NEXT_PUBLIC_BLOG_API_URL");
+    return (fromEnv ?? DEFAULT_BLOG_API_URL).replace(/\/+$/, "");
 }

package/dist/utils/index.d.ts

@@ -1,3 +1,3 @@
 export { sanitizeHtml } from "./sanitize";
-export { normalizeDomain, resolveBlogApiUrl } from "./env";
+export { normalizeDomain, resolveBlogApiUrl, DEFAULT_BLOG_API_URL } from "./env";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../app/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../app/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC"}

package/dist/utils/index.js

@@ -1,2 +1,2 @@
 export { sanitizeHtml } from "./sanitize";
-export { normalizeDomain, resolveBlogApiUrl } from "./env";
+export { normalizeDomain, resolveBlogApiUrl, DEFAULT_BLOG_API_URL } from "./env";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canvas-digital/blog-sdk",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "Unified Blog SDK — user (published blogs) and admin (CRUD) in one package.",
   "license": "MIT",
   "type": "module",