@duffcloudservices/cms-angular 0.1.0

package/README.md

@@ -0,0 +1,145 @@
+# @duffcloudservices/cms-angular
+
+Angular services and build scripts for DCS CMS integration.
+
+## Installation
+
+```bash
+pnpm add @duffcloudservices/cms-angular
+```
+
+## Usage
+
+### 1. Add Provider
+
+```typescript
+// app.config.ts
+import { ApplicationConfig } from '@angular/core'
+import { provideDcs } from '@duffcloudservices/cms-angular'
+
+export const appConfig: ApplicationConfig = {
+  providers: [
+    provideDcs(),
+  ],
+}
+```
+
+### 2. Use in Components
+
+```typescript
+// pages/home.component.ts
+import { Component, inject, OnInit } from '@angular/core'
+import { DcsContentService, DcsSeoService } from '@duffcloudservices/cms-angular'
+
+@Component({
+  selector: 'app-home',
+  template: `
+    <h1>{{ title }}</h1>
+    <p>{{ subtitle }}</p>
+  `,
+})
+export class HomeComponent implements OnInit {
+  private content = inject(DcsContentService)
+  private seo = inject(DcsSeoService)
+
+  get title() {
+    return this.content.t('home', 'hero.title', 'Welcome')
+  }
+
+  get subtitle() {
+    return this.content.t('home', 'hero.subtitle', 'Build amazing things')
+  }
+
+  ngOnInit() {
+    this.seo.setPageSeo('home')
+  }
+}
+```
+
+### 3. Post-Build Injection
+
+After running `ng build`, inject the DCS content into index.html:
+
+```bash
+npx dcs-inject dist/my-app
+```
+
+Or add to your package.json scripts:
+
+```json
+{
+  "scripts": {
+    "build": "ng build && dcs-inject dist/my-app"
+  }
+}
+```
+
+### DCS Configuration Files
+
+Create `.dcs/content.yaml`:
+
+```yaml
+version: 1
+global:
+  nav.home: Home
+  footer.copyright: © 2026 Company
+pages:
+  home:
+    hero.title: Welcome to Our Site
+    hero.subtitle: Build something amazing
+```
+
+Create `.dcs/seo.yaml`:
+
+```yaml
+version: 1
+global:
+  siteName: My Site
+  defaultTitle: My Site
+  titleTemplate: "%s | My Site"
+pages:
+  home:
+    title: Welcome
+    description: The homepage of My Site
+```
+
+## API
+
+### DcsContentService
+
+Service for text content management.
+
+**Methods:**
+- `t(page, key, fallback?)`: Get text by page and key
+- `getPageContent(page)`: Get all content for a page
+- `fetchRuntimeContent(siteSlug, apiBaseUrl?)`: Fetch runtime content (premium)
+
+**Signals:**
+- `content`: Current content configuration
+- `isLoading`: Loading state
+- `error`: Error message
+
+### DcsSeoService
+
+Service for SEO meta tag management.
+
+**Methods:**
+- `setPageSeo(page, overrides?)`: Apply SEO for a page
+- `getSeoConfig()`: Get raw SEO configuration
+
+### CLI: dcs-inject
+
+Inject content into Angular build output.
+
+```bash
+npx dcs-inject <dist-path> [options]
+
+Options:
+  --content-path  Path to content.yaml (default: .dcs/content.yaml)
+  --seo-path      Path to seo.yaml (default: .dcs/seo.yaml)
+  --index-file    Index file name (default: index.html)
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,111 @@
+import * as _angular_core from '@angular/core';
+import { EnvironmentProviders } from '@angular/core';
+import { ContentConfiguration, ResolvedSeo, SeoConfiguration } from '@duffcloudservices/cms-core/browser';
+export { ContentConfiguration, GlobalSeoConfig, PageSeoConfig, ResolvedSeo, SeoConfiguration } from '@duffcloudservices/cms-core';
+
+/**
+ * Angular service for DCS text content management.
+ */
+declare class DcsContentService {
+    /** Build-time content (injected via index.html script) */
+    private readonly buildContent;
+    /** Runtime content (fetched if runtime mode enabled) */
+    private readonly runtimeContent;
+    /** Loading state for runtime fetch */
+    readonly isLoading: _angular_core.WritableSignal<boolean>;
+    /** Error state for runtime fetch */
+    readonly error: _angular_core.WritableSignal<string | null>;
+    /** Current content (runtime overrides build-time) */
+    readonly content: _angular_core.Signal<ContentConfiguration | undefined>;
+    /**
+     * Safely get build-time content configuration.
+     */
+    private getBuildTimeContent;
+    /**
+     * Get text for a specific page and key.
+     *
+     * @param page - Page slug matching entry in content.yaml
+     * @param key - Text key to retrieve
+     * @param fallback - Fallback value if key not found
+     * @returns The resolved text value
+     */
+    t(page: string, key: string, fallback?: string): string;
+    /**
+     * Get all content for a specific page (merged global + page).
+     *
+     * @param page - Page slug
+     * @returns Merged content object
+     */
+    getPageContent(page: string): Record<string, string>;
+    /**
+     * Fetch runtime content from DCS API (premium tier only).
+     *
+     * @param siteSlug - The site's slug identifier
+     * @param apiBaseUrl - Optional API base URL override
+     */
+    fetchRuntimeContent(siteSlug: string, apiBaseUrl?: string): Promise<void>;
+}
+
+/**
+ * DcsSeoService for Angular
+ *
+ * Applies SEO meta tags to the document head based on .dcs/seo.yaml configuration.
+ */
+
+/**
+ * Angular service for DCS SEO management.
+ */
+declare class DcsSeoService {
+    private readonly meta;
+    private readonly title;
+    /** Build-time SEO config (injected via index.html script) */
+    private readonly seoConfig;
+    /**
+     * Safely get build-time SEO configuration.
+     */
+    private getBuildTimeSeo;
+    /**
+     * Apply SEO for a specific page.
+     *
+     * @param page - Page slug matching entry in seo.yaml
+     * @param overrides - Optional overrides for title, description, or image
+     * @returns The resolved SEO configuration
+     */
+    setPageSeo(page: string, overrides?: {
+        title?: string;
+        description?: string;
+        image?: string;
+    }): ResolvedSeo | null;
+    /**
+     * Update or create canonical link element.
+     */
+    private updateCanonicalLink;
+    /**
+     * Get the raw SEO configuration.
+     */
+    getSeoConfig(): SeoConfiguration | undefined;
+}
+
+/**
+ * Angular providers for DCS CMS integration.
+ */
+
+/**
+ * Provide DCS CMS services for Angular application.
+ *
+ * @example
+ * ```typescript
+ * // app.config.ts
+ * import { ApplicationConfig } from '@angular/core'
+ * import { provideDcs } from '@duffcloudservices/cms-angular'
+ *
+ * export const appConfig: ApplicationConfig = {
+ *   providers: [
+ *     provideDcs(),
+ *   ],
+ * }
+ * ```
+ */
+declare function provideDcs(): EnvironmentProviders;
+
+export { DcsContentService, DcsSeoService, provideDcs };

package/dist/index.js

@@ -0,0 +1,159 @@
+import { Injectable, signal, computed, inject, makeEnvironmentProviders } from '@angular/core';
+import { resolveTextKey, getPageContent, fetchRuntimeContent, resolveSeoForPage, buildMetaTags } from '@duffcloudservices/cms-core/browser';
+import { Meta, Title } from '@angular/platform-browser';
+
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (decorator(result)) || result;
+  return result;
+};
+var DcsContentService = class {
+  /** Build-time content (injected via index.html script) */
+  buildContent = this.getBuildTimeContent();
+  /** Runtime content (fetched if runtime mode enabled) */
+  runtimeContent = signal(null);
+  /** Loading state for runtime fetch */
+  isLoading = signal(false);
+  /** Error state for runtime fetch */
+  error = signal(null);
+  /** Current content (runtime overrides build-time) */
+  content = computed(() => this.runtimeContent() ?? this.buildContent);
+  /**
+   * Safely get build-time content configuration.
+   */
+  getBuildTimeContent() {
+    try {
+      if (__DCS_CONTENT__ !== void 0 && __DCS_CONTENT__ !== null) {
+        return __DCS_CONTENT__;
+      }
+    } catch {
+    }
+    return void 0;
+  }
+  /**
+   * Get text for a specific page and key.
+   *
+   * @param page - Page slug matching entry in content.yaml
+   * @param key - Text key to retrieve
+   * @param fallback - Fallback value if key not found
+   * @returns The resolved text value
+   */
+  t(page, key, fallback) {
+    const c = this.content();
+    if (!c) return fallback ?? key;
+    return resolveTextKey(c, page, key) ?? fallback ?? key;
+  }
+  /**
+   * Get all content for a specific page (merged global + page).
+   *
+   * @param page - Page slug
+   * @returns Merged content object
+   */
+  getPageContent(page) {
+    const c = this.content();
+    if (!c) return {};
+    return getPageContent(c, page);
+  }
+  /**
+   * Fetch runtime content from DCS API (premium tier only).
+   *
+   * @param siteSlug - The site's slug identifier
+   * @param apiBaseUrl - Optional API base URL override
+   */
+  async fetchRuntimeContent(siteSlug, apiBaseUrl) {
+    this.isLoading.set(true);
+    this.error.set(null);
+    try {
+      const data = await fetchRuntimeContent(siteSlug, { apiBaseUrl });
+      if (data) {
+        this.runtimeContent.set(data);
+      }
+    } catch (err) {
+      this.error.set(err instanceof Error ? err.message : "Failed to fetch content");
+    } finally {
+      this.isLoading.set(false);
+    }
+  }
+};
+DcsContentService = __decorateClass([
+  Injectable({ providedIn: "root" })
+], DcsContentService);
+var DcsSeoService = class {
+  meta = inject(Meta);
+  title = inject(Title);
+  /** Build-time SEO config (injected via index.html script) */
+  seoConfig = this.getBuildTimeSeo();
+  /**
+   * Safely get build-time SEO configuration.
+   */
+  getBuildTimeSeo() {
+    try {
+      if (__DCS_SEO__ !== void 0 && __DCS_SEO__ !== null) {
+        return __DCS_SEO__;
+      }
+    } catch {
+    }
+    return void 0;
+  }
+  /**
+   * Apply SEO for a specific page.
+   *
+   * @param page - Page slug matching entry in seo.yaml
+   * @param overrides - Optional overrides for title, description, or image
+   * @returns The resolved SEO configuration
+   */
+  setPageSeo(page, overrides) {
+    if (!this.seoConfig) return null;
+    const seo = resolveSeoForPage(this.seoConfig, page);
+    const resolved = {
+      ...seo,
+      ...overrides?.title && { title: overrides.title },
+      ...overrides?.description && { description: overrides.description },
+      ...overrides?.image && { image: overrides.image }
+    };
+    this.title.setTitle(resolved.title);
+    const tags = buildMetaTags(resolved);
+    for (const tag of tags) {
+      if (tag.property) {
+        this.meta.updateTag({ property: tag.property, content: tag.content });
+      } else if (tag.name) {
+        this.meta.updateTag({ name: tag.name, content: tag.content });
+      }
+    }
+    if (resolved.canonical) {
+      this.updateCanonicalLink(resolved.canonical);
+    }
+    return resolved;
+  }
+  /**
+   * Update or create canonical link element.
+   */
+  updateCanonicalLink(href) {
+    let link = document.querySelector('link[rel="canonical"]');
+    if (!link) {
+      link = document.createElement("link");
+      link.setAttribute("rel", "canonical");
+      document.head.appendChild(link);
+    }
+    link.setAttribute("href", href);
+  }
+  /**
+   * Get the raw SEO configuration.
+   */
+  getSeoConfig() {
+    return this.seoConfig;
+  }
+};
+DcsSeoService = __decorateClass([
+  Injectable({ providedIn: "root" })
+], DcsSeoService);
+function provideDcs() {
+  return makeEnvironmentProviders([DcsContentService, DcsSeoService]);
+}
+
+export { DcsContentService, DcsSeoService, provideDcs };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/services/content.service.ts","../src/services/seo.service.ts","../src/providers.ts"],"names":["Injectable"],"mappings":"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","file":"index.js","sourcesContent":["/**\r\n * DcsContentService for Angular\r\n *\r\n * Provides text content management with build-time injection support and optional\r\n * runtime API overrides for DCS-managed customer sites.\r\n */\r\n\r\nimport { Injectable, signal, computed } from '@angular/core'\r\nimport {\r\n  resolveTextKey,\r\n  getPageContent,\r\n  fetchRuntimeContent,\r\n  type ContentConfiguration,\r\n} from '@duffcloudservices/cms-core/browser'\r\n\r\n// Declare the global injected by build script\r\ndeclare const __DCS_CONTENT__: ContentConfiguration | undefined\r\n\r\n/**\r\n * Angular service for DCS text content management.\r\n */\r\n@Injectable({ providedIn: 'root' })\r\nexport class DcsContentService {\r\n  /** Build-time content (injected via index.html script) */\r\n  private readonly buildContent = this.getBuildTimeContent()\r\n\r\n  /** Runtime content (fetched if runtime mode enabled) */\r\n  private readonly runtimeContent = signal<ContentConfiguration | null>(null)\r\n\r\n  /** Loading state for runtime fetch */\r\n  readonly isLoading = signal(false)\r\n\r\n  /** Error state for runtime fetch */\r\n  readonly error = signal<string | null>(null)\r\n\r\n  /** Current content (runtime overrides build-time) */\r\n  readonly content = computed(() => this.runtimeContent() ?? this.buildContent)\r\n\r\n  /**\r\n   * Safely get build-time content configuration.\r\n   */\r\n  private getBuildTimeContent(): ContentConfiguration | undefined {\r\n    try {\r\n      if (__DCS_CONTENT__ !== undefined && __DCS_CONTENT__ !== null) {\r\n        return __DCS_CONTENT__\r\n      }\r\n    } catch {\r\n      // __DCS_CONTENT__ not defined\r\n    }\r\n    return undefined\r\n  }\r\n\r\n  /**\r\n   * Get text for a specific page and key.\r\n   *\r\n   * @param page - Page slug matching entry in content.yaml\r\n   * @param key - Text key to retrieve\r\n   * @param fallback - Fallback value if key not found\r\n   * @returns The resolved text value\r\n   */\r\n  t(page: string, key: string, fallback?: string): string {\r\n    const c = this.content()\r\n    if (!c) return fallback ?? key\r\n    return resolveTextKey(c, page, key) ?? fallback ?? key\r\n  }\r\n\r\n  /**\r\n   * Get all content for a specific page (merged global + page).\r\n   *\r\n   * @param page - Page slug\r\n   * @returns Merged content object\r\n   */\r\n  getPageContent(page: string): Record<string, string> {\r\n    const c = this.content()\r\n    if (!c) return {}\r\n    return getPageContent(c, page)\r\n  }\r\n\r\n  /**\r\n   * Fetch runtime content from DCS API (premium tier only).\r\n   *\r\n   * @param siteSlug - The site's slug identifier\r\n   * @param apiBaseUrl - Optional API base URL override\r\n   */\r\n  async fetchRuntimeContent(siteSlug: string, apiBaseUrl?: string): Promise<void> {\r\n    this.isLoading.set(true)\r\n    this.error.set(null)\r\n\r\n    try {\r\n      const data = await fetchRuntimeContent(siteSlug, { apiBaseUrl })\r\n      if (data) {\r\n        this.runtimeContent.set(data)\r\n      }\r\n    } catch (err) {\r\n      this.error.set(err instanceof Error ? err.message : 'Failed to fetch content')\r\n    } finally {\r\n      this.isLoading.set(false)\r\n    }\r\n  }\r\n}\r\n","/**\r\n * DcsSeoService for Angular\r\n *\r\n * Applies SEO meta tags to the document head based on .dcs/seo.yaml configuration.\r\n */\r\n\r\nimport { Injectable, inject } from '@angular/core'\r\nimport { Meta, Title } from '@angular/platform-browser'\r\nimport {\r\n  resolveSeoForPage,\r\n  buildMetaTags,\r\n  type SeoConfiguration,\r\n  type ResolvedSeo,\r\n} from '@duffcloudservices/cms-core/browser'\r\n\r\n// Declare the global injected by build script\r\ndeclare const __DCS_SEO__: SeoConfiguration | undefined\r\n\r\n/**\r\n * Angular service for DCS SEO management.\r\n */\r\n@Injectable({ providedIn: 'root' })\r\nexport class DcsSeoService {\r\n  private readonly meta = inject(Meta)\r\n  private readonly title = inject(Title)\r\n\r\n  /** Build-time SEO config (injected via index.html script) */\r\n  private readonly seoConfig = this.getBuildTimeSeo()\r\n\r\n  /**\r\n   * Safely get build-time SEO configuration.\r\n   */\r\n  private getBuildTimeSeo(): SeoConfiguration | undefined {\r\n    try {\r\n      if (__DCS_SEO__ !== undefined && __DCS_SEO__ !== null) {\r\n        return __DCS_SEO__\r\n      }\r\n    } catch {\r\n      // __DCS_SEO__ not defined\r\n    }\r\n    return undefined\r\n  }\r\n\r\n  /**\r\n   * Apply SEO for a specific page.\r\n   *\r\n   * @param page - Page slug matching entry in seo.yaml\r\n   * @param overrides - Optional overrides for title, description, or image\r\n   * @returns The resolved SEO configuration\r\n   */\r\n  setPageSeo(\r\n    page: string,\r\n    overrides?: { title?: string; description?: string; image?: string }\r\n  ): ResolvedSeo | null {\r\n    if (!this.seoConfig) return null\r\n\r\n    const seo = resolveSeoForPage(this.seoConfig, page)\r\n    const resolved: ResolvedSeo = {\r\n      ...seo,\r\n      ...(overrides?.title && { title: overrides.title }),\r\n      ...(overrides?.description && { description: overrides.description }),\r\n      ...(overrides?.image && { image: overrides.image }),\r\n    }\r\n\r\n    // Set document title\r\n    this.title.setTitle(resolved.title)\r\n\r\n    // Build and apply meta tags\r\n    const tags = buildMetaTags(resolved)\r\n    for (const tag of tags) {\r\n      if (tag.property) {\r\n        this.meta.updateTag({ property: tag.property, content: tag.content })\r\n      } else if (tag.name) {\r\n        this.meta.updateTag({ name: tag.name, content: tag.content })\r\n      }\r\n    }\r\n\r\n    // Handle canonical link\r\n    if (resolved.canonical) {\r\n      this.updateCanonicalLink(resolved.canonical)\r\n    }\r\n\r\n    return resolved\r\n  }\r\n\r\n  /**\r\n   * Update or create canonical link element.\r\n   */\r\n  private updateCanonicalLink(href: string): void {\r\n    let link = document.querySelector('link[rel=\"canonical\"]')\r\n    if (!link) {\r\n      link = document.createElement('link')\r\n      link.setAttribute('rel', 'canonical')\r\n      document.head.appendChild(link)\r\n    }\r\n    link.setAttribute('href', href)\r\n  }\r\n\r\n  /**\r\n   * Get the raw SEO configuration.\r\n   */\r\n  getSeoConfig(): SeoConfiguration | undefined {\r\n    return this.seoConfig\r\n  }\r\n}\r\n","/**\r\n * Angular providers for DCS CMS integration.\r\n */\r\n\r\nimport { EnvironmentProviders, makeEnvironmentProviders } from '@angular/core'\r\nimport { DcsContentService } from './services/content.service'\r\nimport { DcsSeoService } from './services/seo.service'\r\n\r\n/**\r\n * Provide DCS CMS services for Angular application.\r\n *\r\n * @example\r\n * ```typescript\r\n * // app.config.ts\r\n * import { ApplicationConfig } from '@angular/core'\r\n * import { provideDcs } from '@duffcloudservices/cms-angular'\r\n *\r\n * export const appConfig: ApplicationConfig = {\r\n *   providers: [\r\n *     provideDcs(),\r\n *   ],\r\n * }\r\n * ```\r\n */\r\nexport function provideDcs(): EnvironmentProviders {\r\n  return makeEnvironmentProviders([DcsContentService, DcsSeoService])\r\n}\r\n"]}

package/dist/scripts/inject-content.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Post-build script to inject DCS content into Angular's index.html
+ *
+ * Usage:
+ *   npx dcs-inject dist/my-app
+ *   node node_modules/@duffcloudservices/cms-angular/dist/scripts/inject-content.js dist/my-app
+ *
+ * This script:
+ * 1. Reads .dcs/content.yaml and .dcs/seo.yaml from the project root
+ * 2. Injects them as __DCS_CONTENT__ and __DCS_SEO__ globals in index.html
+ * 3. Writes the modified index.html back to the dist folder
+ */
+/**
+ * Inject DCS content into an Angular build's index.html
+ *
+ * @param distPath - Path to the Angular build output (e.g., 'dist/my-app')
+ * @param options - Optional configuration
+ */
+declare function injectContent(distPath: string, options?: {
+    contentPath?: string;
+    seoPath?: string;
+    indexFile?: string;
+}): Promise<void>;
+
+export { injectContent };

package/dist/scripts/inject-content.js

@@ -0,0 +1,62 @@
+import fs from 'fs';
+import path from 'path';
+import { loadContentYaml, loadSeoYaml } from '@duffcloudservices/cms-core';
+
+// src/scripts/inject-content.ts
+async function injectContent(distPath, options = {}) {
+  const {
+    contentPath = ".dcs/content.yaml",
+    seoPath = ".dcs/seo.yaml",
+    indexFile = "index.html"
+  } = options;
+  const indexPath = path.join(distPath, indexFile);
+  if (!fs.existsSync(indexPath)) {
+    throw new Error(`index.html not found at ${indexPath}`);
+  }
+  let contentJson = "undefined";
+  try {
+    const content = await loadContentYaml(contentPath);
+    contentJson = JSON.stringify(content);
+    console.log(`[dcs-inject] Loaded content from ${contentPath}`);
+  } catch {
+    console.log(`[dcs-inject] No content.yaml found at ${contentPath}`);
+  }
+  let seoJson = "undefined";
+  try {
+    const seo = await loadSeoYaml(seoPath);
+    seoJson = JSON.stringify(seo);
+    console.log(`[dcs-inject] Loaded SEO config from ${seoPath}`);
+  } catch {
+    console.log(`[dcs-inject] No seo.yaml found at ${seoPath}`);
+  }
+  let html = fs.readFileSync(indexPath, "utf8");
+  const injection = `
+<script>
+  window.__DCS_CONTENT__ = ${contentJson};
+  window.__DCS_SEO__ = ${seoJson};
+</script>
+`;
+  if (html.includes("</head>")) {
+    html = html.replace("</head>", `${injection}</head>`);
+  } else {
+    html = html.replace("<body", `${injection}<body`);
+  }
+  fs.writeFileSync(indexPath, html);
+  console.log(`[dcs-inject] Content injected into ${indexPath}`);
+}
+if (process.argv[1]?.includes("inject-content")) {
+  const distPath = process.argv[2];
+  if (!distPath) {
+    console.error("Usage: dcs-inject <dist-path>");
+    console.error("Example: dcs-inject dist/my-app");
+    process.exit(1);
+  }
+  injectContent(distPath).catch((err) => {
+    console.error("[dcs-inject] Error:", err.message);
+    process.exit(1);
+  });
+}
+
+export { injectContent };
+//# sourceMappingURL=inject-content.js.map
+//# sourceMappingURL=inject-content.js.map

package/dist/scripts/inject-content.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/scripts/inject-content.ts"],"names":[],"mappings":";;;;;AAwBA,eAAsB,aAAA,CACpB,QAAA,EACA,OAAA,GAII,EAAC,EACU;AACf,EAAA,MAAM;AAAA,IACJ,WAAA,GAAc,mBAAA;AAAA,IACd,OAAA,GAAU,eAAA;AAAA,IACV,SAAA,GAAY;AAAA,GACd,GAAI,OAAA;AAEJ,EAAA,MAAM,SAAA,GAAY,IAAA,CAAK,IAAA,CAAK,QAAA,EAAU,SAAS,CAAA;AAG/C,EAAA,IAAI,CAAC,EAAA,CAAG,UAAA,CAAW,SAAS,CAAA,EAAG;AAC7B,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,wBAAA,EAA2B,SAAS,CAAA,CAAE,CAAA;AAAA,EACxD;AAGA,EAAA,IAAI,WAAA,GAAc,WAAA;AAClB,EAAA,IAAI;AACF,IAAA,MAAM,OAAA,GAAU,MAAM,eAAA,CAAgB,WAAW,CAAA;AACjD,IAAA,WAAA,GAAc,IAAA,CAAK,UAAU,OAAO,CAAA;AACpC,IAAA,OAAA,CAAQ,GAAA,CAAI,CAAA,iCAAA,EAAoC,WAAW,CAAA,CAAE,CAAA;AAAA,EAC/D,CAAA,CAAA,MAAQ;AACN,IAAA,OAAA,CAAQ,GAAA,CAAI,CAAA,sCAAA,EAAyC,WAAW,CAAA,CAAE,CAAA;AAAA,EACpE;AAGA,EAAA,IAAI,OAAA,GAAU,WAAA;AACd,EAAA,IAAI;AACF,IAAA,MAAM,GAAA,GAAM,MAAM,WAAA,CAAY,OAAO,CAAA;AACrC,IAAA,OAAA,GAAU,IAAA,CAAK,UAAU,GAAG,CAAA;AAC5B,IAAA,OAAA,CAAQ,GAAA,CAAI,CAAA,oCAAA,EAAuC,OAAO,CAAA,CAAE,CAAA;AAAA,EAC9D,CAAA,CAAA,MAAQ;AACN,IAAA,OAAA,CAAQ,GAAA,CAAI,CAAA,kCAAA,EAAqC,OAAO,CAAA,CAAE,CAAA;AAAA,EAC5D;AAGA,EAAA,IAAI,IAAA,GAAO,EAAA,CAAG,YAAA,CAAa,SAAA,EAAW,MAAM,CAAA;AAG5C,EAAA,MAAM,SAAA,GAAY;AAAA;AAAA,2BAAA,EAES,WAAW,CAAA;AAAA,uBAAA,EACf,OAAO,CAAA;AAAA;AAAA,CAAA;AAK9B,EAAA,IAAI,IAAA,CAAK,QAAA,CAAS,SAAS,CAAA,EAAG;AAC5B,IAAA,IAAA,GAAO,IAAA,CAAK,OAAA,CAAQ,SAAA,EAAW,CAAA,EAAG,SAAS,CAAA,OAAA,CAAS,CAAA;AAAA,EACtD,CAAA,MAAO;AAEL,IAAA,IAAA,GAAO,IAAA,CAAK,OAAA,CAAQ,OAAA,EAAS,CAAA,EAAG,SAAS,CAAA,KAAA,CAAO,CAAA;AAAA,EAClD;AAGA,EAAA,EAAA,CAAG,aAAA,CAAc,WAAW,IAAI,CAAA;AAChC,EAAA,OAAA,CAAQ,GAAA,CAAI,CAAA,mCAAA,EAAsC,SAAS,CAAA,CAAE,CAAA;AAC/D;AAGA,IAAI,QAAQ,IAAA,CAAK,CAAC,CAAA,EAAG,QAAA,CAAS,gBAAgB,CAAA,EAAG;AAC/C,EAAA,MAAM,QAAA,GAAW,OAAA,CAAQ,IAAA,CAAK,CAAC,CAAA;AAC/B,EAAA,IAAI,CAAC,QAAA,EAAU;AACb,IAAA,OAAA,CAAQ,MAAM,+BAA+B,CAAA;AAC7C,IAAA,OAAA,CAAQ,MAAM,iCAAiC,CAAA;AAC/C,IAAA,OAAA,CAAQ,KAAK,CAAC,CAAA;AAAA,EAChB;AAEA,EAAA,aAAA,CAAc,QAAQ,CAAA,CAAE,KAAA,CAAM,CAAC,GAAA,KAAQ;AACrC,IAAA,OAAA,CAAQ,KAAA,CAAM,qBAAA,EAAuB,GAAA,CAAI,OAAO,CAAA;AAChD,IAAA,OAAA,CAAQ,KAAK,CAAC,CAAA;AAAA,EAChB,CAAC,CAAA;AACH","file":"inject-content.js","sourcesContent":["#!/usr/bin/env node\r\n/**\r\n * Post-build script to inject DCS content into Angular's index.html\r\n *\r\n * Usage:\r\n *   npx dcs-inject dist/my-app\r\n *   node node_modules/@duffcloudservices/cms-angular/dist/scripts/inject-content.js dist/my-app\r\n *\r\n * This script:\r\n * 1. Reads .dcs/content.yaml and .dcs/seo.yaml from the project root\r\n * 2. Injects them as __DCS_CONTENT__ and __DCS_SEO__ globals in index.html\r\n * 3. Writes the modified index.html back to the dist folder\r\n */\r\n\r\nimport fs from 'node:fs'\r\nimport path from 'node:path'\r\nimport { loadContentYaml, loadSeoYaml } from '@duffcloudservices/cms-core'\r\n\r\n/**\r\n * Inject DCS content into an Angular build's index.html\r\n *\r\n * @param distPath - Path to the Angular build output (e.g., 'dist/my-app')\r\n * @param options - Optional configuration\r\n */\r\nexport async function injectContent(\r\n  distPath: string,\r\n  options: {\r\n    contentPath?: string\r\n    seoPath?: string\r\n    indexFile?: string\r\n  } = {}\r\n): Promise<void> {\r\n  const {\r\n    contentPath = '.dcs/content.yaml',\r\n    seoPath = '.dcs/seo.yaml',\r\n    indexFile = 'index.html',\r\n  } = options\r\n\r\n  const indexPath = path.join(distPath, indexFile)\r\n\r\n  // Check if index.html exists\r\n  if (!fs.existsSync(indexPath)) {\r\n    throw new Error(`index.html not found at ${indexPath}`)\r\n  }\r\n\r\n  // Try to load content.yaml\r\n  let contentJson = 'undefined'\r\n  try {\r\n    const content = await loadContentYaml(contentPath)\r\n    contentJson = JSON.stringify(content)\r\n    console.log(`[dcs-inject] Loaded content from ${contentPath}`)\r\n  } catch {\r\n    console.log(`[dcs-inject] No content.yaml found at ${contentPath}`)\r\n  }\r\n\r\n  // Try to load seo.yaml\r\n  let seoJson = 'undefined'\r\n  try {\r\n    const seo = await loadSeoYaml(seoPath)\r\n    seoJson = JSON.stringify(seo)\r\n    console.log(`[dcs-inject] Loaded SEO config from ${seoPath}`)\r\n  } catch {\r\n    console.log(`[dcs-inject] No seo.yaml found at ${seoPath}`)\r\n  }\r\n\r\n  // Read index.html\r\n  let html = fs.readFileSync(indexPath, 'utf8')\r\n\r\n  // Create injection script\r\n  const injection = `\r\n<script>\r\n  window.__DCS_CONTENT__ = ${contentJson};\r\n  window.__DCS_SEO__ = ${seoJson};\r\n</script>\r\n`\r\n\r\n  // Inject before </head>\r\n  if (html.includes('</head>')) {\r\n    html = html.replace('</head>', `${injection}</head>`)\r\n  } else {\r\n    // Fallback: inject at the start of <body>\r\n    html = html.replace('<body', `${injection}<body`)\r\n  }\r\n\r\n  // Write modified index.html\r\n  fs.writeFileSync(indexPath, html)\r\n  console.log(`[dcs-inject] Content injected into ${indexPath}`)\r\n}\r\n\r\n// CLI entry point\r\nif (process.argv[1]?.includes('inject-content')) {\r\n  const distPath = process.argv[2]\r\n  if (!distPath) {\r\n    console.error('Usage: dcs-inject <dist-path>')\r\n    console.error('Example: dcs-inject dist/my-app')\r\n    process.exit(1)\r\n  }\r\n\r\n  injectContent(distPath).catch((err) => {\r\n    console.error('[dcs-inject] Error:', err.message)\r\n    process.exit(1)\r\n  })\r\n}\r\n"]}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@duffcloudservices/cms-angular",
+  "version": "0.1.0",
+  "description": "Angular services and build scripts for DCS CMS integration",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./scripts": {
+      "types": "./dist/scripts/index.d.ts",
+      "import": "./dist/scripts/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "dcs-inject": "./dist/scripts/inject-content.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "type-check": "tsc --noEmit",
+    "prepublishOnly": "pnpm run build"
+  },
+  "peerDependencies": {
+    "@angular/common": "^17.0.0 || ^18.0.0 || ^19.0.0",
+    "@angular/core": "^17.0.0 || ^18.0.0 || ^19.0.0",
+    "@angular/platform-browser": "^17.0.0 || ^18.0.0 || ^19.0.0"
+  },
+  "dependencies": {
+    "@duffcloudservices/cms-core": "workspace:*"
+  },
+  "devDependencies": {
+    "@angular/common": "^19.0.0",
+    "@angular/core": "^19.0.0",
+    "@angular/platform-browser": "^19.0.0",
+    "@types/node": "^20.11.0",
+    "rxjs": "^7.8.0",
+    "tsup": "^8.0.0",
+    "typescript": "~5.6.3",
+    "vitest": "^3.2.3"
+  },
+  "keywords": [
+    "angular",
+    "dcs",
+    "cms",
+    "content",
+    "seo"
+  ],
+  "author": "Duff Cloud Services",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/duffn84/dcs-again",
+    "directory": "packages/cms-angular"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}