@skillhub-xyz/sdk 0.0.1

package/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "@skillhub-xyz/sdk",
+  "version": "0.0.1",
+  "private": false,
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "scripts": {
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "typescript": "^5.7"
+  }
+}

package/src/index.ts

@@ -0,0 +1 @@
+export * from './types'

package/src/types.ts

@@ -0,0 +1,157 @@
+// ─── Auth ────────────────────────────────────────────────────────────────────
+
+export interface JwtPayload {
+  user_id: number
+  iat: number
+  exp: number
+}
+
+export interface TokenExchangeRequest {
+  token: string
+}
+
+export interface TokenExchangeResponse {
+  jwt: string
+  expires_at: string
+}
+
+// ─── Users ───────────────────────────────────────────────────────────────────
+
+export interface User {
+  id: number
+  email: string
+  name: string
+  avatar: string | null
+  created_at: string
+}
+
+// ─── Personal Tokens ─────────────────────────────────────────────────────────
+
+export interface PersonalToken {
+  id: number
+  name: string
+  last_used_at: string | null
+  expires_at: string | null
+  created_at: string
+}
+
+export interface CreateTokenRequest {
+  name: string
+  expires_in?: '30d' | '90d' | '365d'
+}
+
+export interface CreateTokenResponse extends PersonalToken {
+  token: string // plaintext, shown once only
+}
+
+// ─── Orgs ────────────────────────────────────────────────────────────────────
+
+export interface Org {
+  id: number
+  slug: string
+  name: string
+  created_at: string
+  my_role?: OrgRole
+}
+
+export type OrgRole = 'owner' | 'member' | 'viewer'
+
+export interface OrgMember {
+  user_id: number
+  email: string
+  name: string
+  role: OrgRole
+  created_at: string
+}
+
+// ─── Projects ────────────────────────────────────────────────────────────────
+
+export interface Project {
+  id: number
+  org_id: number
+  slug: string
+  name: string
+  description: string | null
+  created_at: string
+  my_role?: ProjectRole
+}
+
+export type ProjectRole = 'owner' | 'member' | 'viewer'
+
+export interface ProjectMember {
+  user_id: number
+  email: string
+  name: string
+  role: ProjectRole
+  created_at: string
+}
+
+// ─── Skills ──────────────────────────────────────────────────────────────────
+
+export interface Skill {
+  id: number
+  project_id: number
+  slug: string
+  name: string
+  description: string | null
+  created_at: string
+  latest_version: SkillVersion | null
+}
+
+export interface SkillVersion {
+  id: number
+  skill_id: number
+  version: string
+  changelog: string | null
+  oss_key: string
+  file_size: number
+  published_by: number
+  created_at: string
+  is_latest: boolean
+}
+
+export interface UploadUrlResponse {
+  oss_key: string
+  oss_endpoint: string
+  sts_token: {
+    access_key_id: string
+    access_key_secret: string
+    security_token: string
+    expiration: string
+  }
+}
+
+export interface RegisterVersionRequest {
+  version: string
+  oss_key: string
+  changelog?: string
+  file_size: number
+}
+
+export interface DownloadUrlResponse {
+  url: string
+  expires_at: string
+}
+
+export interface BulkDownloadItem {
+  skill_slug: string
+  version: string
+  url: string
+  expires_at: string
+}
+
+// ─── Common ──────────────────────────────────────────────────────────────────
+
+export interface PaginatedResponse<T> {
+  data: T[]
+  total: number
+  page: number
+  limit: number
+}
+
+export interface ErrorResponse {
+  error: {
+    code: string
+    message: string
+  }
+}

package/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true
+  },
+  "include": ["src"]
+}