@ph-cms/client-sdk 0.1.14 → 0.1.16

package/bin/cli.js

@@ -0,0 +1,79 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+
+const command = process.argv[2];
+
+if (command === 'init-skill') {
+  initSkill();
+} else {
+  console.log('Usage: npx @ph-cms/client-sdk init-skill');
+  process.exit(1);
+}
+
+function initSkill() {
+  const skillDir = path.join(process.cwd(), '.gemini/skills/ph-cms-client');
+  const skillMdPath = path.join(skillDir, 'SKILL.md');
+
+  const skillContent = `# PH-CMS Client SDK Skill
+
+This skill provides expert guidance for implementing and maintaining applications using the \`@ph-cms/client-sdk\`.
+
+## 📌 Core Directives
+
+1. **Context Scoping**: All hooks (\`useContentList\`, \`useChannelTerms\`, \`useCreateContent\`, etc.) are automatically scoped to the \`channelUid\` provided in the \`PHCMSProvider\`. Do NOT manually pass \`channelUid\` to these hooks unless a cross-channel operation is explicitly requested.
+2. **Provider Requirement**: Always ensure all components using SDK hooks are wrapped within a \`PHCMSProvider\`.
+3. **Authentication Lifecycle**: Use the \`useAuth()\` hook for login, registration, and logout. It handles token storage, refreshing, and profile state automatically.
+4. **Direct API Usage**: For non-React environments or server-to-server calls, use the \`PHCMSClient\` class directly. You can inject a custom \`axiosInstance\` for special network needs (e.g., custom HTTPS agents).
+
+## 🛠 Usage Patterns
+
+### 1. Provider Setup
+\`\`\`tsx
+import { PHCMSClient, LocalAuthProvider, PHCMSProvider } from '@ph-cms/client-sdk';
+
+const authProvider = new LocalAuthProvider('my_app_');
+const client = new PHCMSClient({
+  baseURL: 'https://api.example.com',
+  auth: authProvider,
+});
+
+export function App() {
+  return (
+    <PHCMSProvider client={client} channelUid="target-channel-slug">
+      <YourApp />
+    </PHCMSProvider>
+  );
+}
+\`\`\`
+
+### 2. Content Hook (Auto-scoped)
+\`\`\`tsx
+const { data, isLoading } = useContentList({ limit: 10 });
+\`\`\`
+
+### 3. User & Terms (Auto-scoped)
+\`\`\`tsx
+const { data: terms } = useChannelTerms();
+const { mutate: agree } = useAgreeTerms();
+\`\`\`
+
+## 📚 Detailed Documentation
+For the complete API reference, advanced configuration, and comprehensive examples, always refer to the full documentation:
+- **Location**: \`node_modules/@ph-cms/client-sdk/README.md\`
+
+If you need specific details about a module (e.g., \`ContentModule\`, \`AuthModule\`), read that file to ensure correct parameter usage.
+
+## ⚠️ Common Pitfalls
+- **Manual channelUid passing**: Avoid \`useContentList({ channelUid: '...', ... })\` unless necessary. Rely on the provider.
+- **Hook-less API calls**: When using \`client.content.list()\` directly, you MUST provide \`channelUid\` in the params as there is no context available.
+`;
+
+  if (!fs.existsSync(skillDir)) {
+    fs.mkdirSync(skillDir, { recursive: true });
+  }
+
+  fs.writeFileSync(skillMdPath, skillContent);
+  console.log('✅ PH-CMS Client SDK Skill has been successfully initialized at .gemini/skills/ph-cms-client/SKILL.md');
+}

package/package.json

@@ -1,11 +1,14 @@
 {
   "name": "@ph-cms/client-sdk",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "description": "Unified PH-CMS Client SDK (React + Core)",
   "keywords": [],
   "license": "MIT",
   "author": "854dev",
   "type": "commonjs",
+  "bin": {
+    "ph-cms-client": "./bin/cli.js"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -17,6 +20,7 @@
   "types": "dist/index.d.ts",
   "files": [
     "dist",
+    "bin",
     "README.md",
     "LICENSE"
   ],