@augmenting-integrations/content 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Augmenting Integrations LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+import "server-only";
+export type ContentDoc = {
+    slug: string;
+    frontmatter: Record<string, unknown>;
+    body: string;
+};
+export type ContentLoader = {
+    getContent(slug: string): Promise<ContentDoc | null>;
+    listContent(): Promise<Array<Pick<ContentDoc, "slug" | "frontmatter">>>;
+};
+/**
+ * Build a content loader rooted at a directory relative to the consuming
+ * app's cwd (typically `content`). Apps call this once at module scope.
+ *
+ * To swap to a CMS (e.g. Payload), replace this implementation while keeping
+ * the `ContentLoader` shape stable.
+ */
+export declare function createContentLoader(opts?: {
+    dir?: string;
+}): ContentLoader;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,CAAC;AAKrB,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IACrD,WAAW,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;CACzE,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,aAAa,CAkC9E"}

package/dist/index.js

@@ -0,0 +1,46 @@
+import "server-only";
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import matter from "gray-matter";
+/**
+ * Build a content loader rooted at a directory relative to the consuming
+ * app's cwd (typically `content`). Apps call this once at module scope.
+ *
+ * To swap to a CMS (e.g. Payload), replace this implementation while keeping
+ * the `ContentLoader` shape stable.
+ */
+export function createContentLoader(opts = {}) {
+    const dir = opts.dir ?? "content";
+    const contentDir = path.resolve(process.cwd(), dir);
+    return {
+        async getContent(slug) {
+            const file = path.join(contentDir, `${slug}.mdx`);
+            try {
+                const raw = await fs.readFile(file, "utf-8");
+                const { data, content } = matter(raw);
+                return { slug, frontmatter: data, body: content };
+            }
+            catch {
+                return null;
+            }
+        },
+        async listContent() {
+            try {
+                const files = await fs.readdir(contentDir);
+                const docs = await Promise.all(files
+                    .filter((f) => f.endsWith(".mdx"))
+                    .map(async (f) => {
+                    const slug = f.replace(/\.mdx$/, "");
+                    const raw = await fs.readFile(path.join(contentDir, f), "utf-8");
+                    const { data } = matter(raw);
+                    return { slug, frontmatter: data };
+                }));
+                return docs;
+            }
+            catch {
+                return [];
+            }
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,MAAM,MAAM,aAAa,CAAC;AAajC;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAyB,EAAE;IAC7D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,SAAS,CAAC;IAClC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC;IAEpD,OAAO;QACL,KAAK,CAAC,UAAU,CAAC,IAAI;YACnB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,IAAI,MAAM,CAAC,CAAC;YAClD,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBAC7C,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;gBACtC,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;YACpD,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QACD,KAAK,CAAC,WAAW;YACf,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;gBAC3C,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,GAAG,CAC5B,KAAK;qBACF,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;qBACjC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;oBACf,MAAM,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;oBACrC,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;oBACjE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;oBAC7B,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;gBACrC,CAAC,CAAC,CACL,CAAC;gBACF,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/index.mjs

@@ -0,0 +1,41 @@
+// src/index.ts
+import "server-only";
+import { promises as fs } from "fs";
+import path from "path";
+import matter from "gray-matter";
+function createContentLoader(opts = {}) {
+  const dir = opts.dir ?? "content";
+  const contentDir = path.resolve(process.cwd(), dir);
+  return {
+    async getContent(slug) {
+      const file = path.join(contentDir, `${slug}.mdx`);
+      try {
+        const raw = await fs.readFile(file, "utf-8");
+        const { data, content } = matter(raw);
+        return { slug, frontmatter: data, body: content };
+      } catch {
+        return null;
+      }
+    },
+    async listContent() {
+      try {
+        const files = await fs.readdir(contentDir);
+        const docs = await Promise.all(
+          files.filter((f) => f.endsWith(".mdx")).map(async (f) => {
+            const slug = f.replace(/\.mdx$/, "");
+            const raw = await fs.readFile(path.join(contentDir, f), "utf-8");
+            const { data } = matter(raw);
+            return { slug, frontmatter: data };
+          })
+        );
+        return docs;
+      } catch {
+        return [];
+      }
+    }
+  };
+}
+export {
+  createContentLoader
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import \"server-only\";\nimport { promises as fs } from \"node:fs\";\nimport path from \"node:path\";\nimport matter from \"gray-matter\";\n\nexport type ContentDoc = {\n  slug: string;\n  frontmatter: Record<string, unknown>;\n  body: string;\n};\n\nexport type ContentLoader = {\n  getContent(slug: string): Promise<ContentDoc | null>;\n  listContent(): Promise<Array<Pick<ContentDoc, \"slug\" | \"frontmatter\">>>;\n};\n\n/**\n * Build a content loader rooted at a directory relative to the consuming\n * app's cwd (typically `content`). Apps call this once at module scope.\n *\n * To swap to a CMS (e.g. Payload), replace this implementation while keeping\n * the `ContentLoader` shape stable.\n */\nexport function createContentLoader(opts: { dir?: string } = {}): ContentLoader {\n  const dir = opts.dir ?? \"content\";\n  const contentDir = path.resolve(process.cwd(), dir);\n\n  return {\n    async getContent(slug) {\n      const file = path.join(contentDir, `${slug}.mdx`);\n      try {\n        const raw = await fs.readFile(file, \"utf-8\");\n        const { data, content } = matter(raw);\n        return { slug, frontmatter: data, body: content };\n      } catch {\n        return null;\n      }\n    },\n    async listContent() {\n      try {\n        const files = await fs.readdir(contentDir);\n        const docs = await Promise.all(\n          files\n            .filter((f) => f.endsWith(\".mdx\"))\n            .map(async (f) => {\n              const slug = f.replace(/\\.mdx$/, \"\");\n              const raw = await fs.readFile(path.join(contentDir, f), \"utf-8\");\n              const { data } = matter(raw);\n              return { slug, frontmatter: data };\n            }),\n        );\n        return docs;\n      } catch {\n        return [];\n      }\n    },\n  };\n}\n"],"mappings":";AAAA,OAAO;AACP,SAAS,YAAY,UAAU;AAC/B,OAAO,UAAU;AACjB,OAAO,YAAY;AAoBZ,SAAS,oBAAoB,OAAyB,CAAC,GAAkB;AAC9E,QAAM,MAAM,KAAK,OAAO;AACxB,QAAM,aAAa,KAAK,QAAQ,QAAQ,IAAI,GAAG,GAAG;AAElD,SAAO;AAAA,IACL,MAAM,WAAW,MAAM;AACrB,YAAM,OAAO,KAAK,KAAK,YAAY,GAAG,IAAI,MAAM;AAChD,UAAI;AACF,cAAM,MAAM,MAAM,GAAG,SAAS,MAAM,OAAO;AAC3C,cAAM,EAAE,MAAM,QAAQ,IAAI,OAAO,GAAG;AACpC,eAAO,EAAE,MAAM,aAAa,MAAM,MAAM,QAAQ;AAAA,MAClD,QAAQ;AACN,eAAO;AAAA,MACT;AAAA,IACF;AAAA,IACA,MAAM,cAAc;AAClB,UAAI;AACF,cAAM,QAAQ,MAAM,GAAG,QAAQ,UAAU;AACzC,cAAM,OAAO,MAAM,QAAQ;AAAA,UACzB,MACG,OAAO,CAAC,MAAM,EAAE,SAAS,MAAM,CAAC,EAChC,IAAI,OAAO,MAAM;AAChB,kBAAM,OAAO,EAAE,QAAQ,UAAU,EAAE;AACnC,kBAAM,MAAM,MAAM,GAAG,SAAS,KAAK,KAAK,YAAY,CAAC,GAAG,OAAO;AAC/D,kBAAM,EAAE,KAAK,IAAI,OAAO,GAAG;AAC3B,mBAAO,EAAE,MAAM,aAAa,KAAK;AAAA,UACnC,CAAC;AAAA,QACL;AACA,eAAO;AAAA,MACT,QAAQ;AACN,eAAO,CAAC;AAAA,MACV;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@augmenting-integrations/content",
+  "version": "0.1.0",
+  "description": "MDX content loader (server-only). Reads /content/*.mdx files relative to the consuming app's cwd.",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": [
+    "./src/index.ts",
+    "./dist/index.js",
+    "./dist/index.cjs"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "gray-matter": "^4.0.3"
+  },
+  "peerDependencies": {
+    "server-only": "^0.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.6",
+    "server-only": "^0.0.1",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^4.1.5"
+  },
+  "scripts": {
+    "build": "tsup",
+    "clean": "rm -rf dist",
+    "test": "vitest run --passWithNoTests"
+  }
+}