@orhancodestudio/ocsm-core 0.1.0-alpha.1

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# Changelog — @orhancodestudio/ocsm-core
+
+## 0.1.0-alpha.1
+
+### Added
+
+- Config layer: `defineOcsmConfig`, `resolveOcsmConfig`, zod-validated schema.
+- Content layer: `ContentStore` interface with `FileSystemContentStore` and
+  `GitHubContentStore`, plus the `createContentStore` factory.
+- Server API: `createOcsm`, `writeDocument`, `deleteDocument`, `OcsmContent` (MDX),
+  and cookie-based admin auth.
+- Admin panel: `OcsmAdmin` component (dashboard, list, MDX editor with optimistic save).
+- `checkForUpdates` against the npm registry and the `OCSM_VERSION` constant.

package/README.md

@@ -0,0 +1,47 @@
+# @orhancodestudio/ocsm-core
+
+The git-based CMS core for Next.js, powering **OCS Management** by
+[Orhan Code Studio](https://orhancodestudio.com).
+
+> ⚠️ Pre-release (`alpha`). APIs may change before `1.0.0`.
+
+## Install
+
+```bash
+pnpm add @orhancodestudio/ocsm-core
+```
+
+Then enable transpilation in `next.config.ts`:
+
+```ts
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {
+  transpilePackages: ["@orhancodestudio/ocsm-core"],
+};
+
+export default nextConfig;
+```
+
+## Entry points
+
+| Import | Use |
+| --- | --- |
+| `@orhancodestudio/ocsm-core` | `defineOcsmConfig`, types, `OCSM_VERSION`, `checkForUpdates`. |
+| `@orhancodestudio/ocsm-core/config` | `defineOcsmConfig`, config types. |
+| `@orhancodestudio/ocsm-core/server` | `createOcsm`, content helpers, `OcsmContent`, auth — **server only**. |
+| `@orhancodestudio/ocsm-core/admin` | `OcsmAdmin` panel component + action types. |
+
+## Environment variables
+
+| Variable | Description |
+| --- | --- |
+| `OCSM_ADMIN_PASSWORD` | Password gating `/ocsm-admin`. Empty = open (local dev only). |
+| `OCSM_GITHUB_TOKEN` | GitHub token; enables the GitHub content store (production). |
+| `OCSM_GITHUB_REPO` | `owner/repo` to commit content to. |
+| `OCSM_GITHUB_BRANCH` | Target branch (default `main`). |
+
+If `OCSM_GITHUB_TOKEN` + `OCSM_GITHUB_REPO` are set, content is read/written via the
+GitHub API; otherwise the local filesystem is used.
+
+© Orhan Code Studio

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@orhancodestudio/ocsm-core",
+  "version": "0.1.0-alpha.1",
+  "description": "OCS Management — the git-based CMS core for Next.js. Built by Orhan Code Studio.",
+  "license": "MIT",
+  "author": "Orhan Code Studio (https://orhancodestudio.com)",
+  "homepage": "https://orhancodestudio.com",
+  "type": "module",
+  "sideEffects": false,
+  "files": ["src", "README.md", "CHANGELOG.md"],
+  "exports": {
+    ".": "./src/index.ts",
+    "./server": "./src/server/index.ts",
+    "./admin": "./src/admin/index.ts",
+    "./config": "./src/config/index.ts"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "cms",
+    "nextjs",
+    "git-based",
+    "mdx",
+    "ocsm",
+    "orhan-code-studio"
+  ],
+  "peerDependencies": {
+    "next": ">=15",
+    "react": ">=19",
+    "react-dom": ">=19"
+  },
+  "dependencies": {
+    "@octokit/rest": "^21.0.2",
+    "gray-matter": "^4.0.3",
+    "react-markdown": "^9.0.1",
+    "remark-gfm": "^4.0.0",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "@types/react": "^19.0.2",
+    "@types/react-dom": "^19.0.2",
+    "next": "^15.1.3",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "typescript": "^5.7.2"
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "alpha"
+  }
+}