@hanzo/ui 8.0.12 → 8.0.13

package/dist/product/social/ChannelBadge.d.ts

@@ -1,4 +1,6 @@
-export type Channel = 'x' | 'facebook' | 'instagram' | 'linkedin' | 'tiktok' | 'youtube' | 'threads';
+import type { Provider } from './api';
+/** The network vocabulary is the backend's ONE ordered list (./api PROVIDERS). */
+export type Channel = Provider;
 /**
  * A known network, or whatever string the server sent. The badge renders unknown
  * values through the `x` fallback below, so the type says what it really accepts —

package/dist/product/social/PostAgenda.d.ts

@@ -1,4 +1,4 @@
-import type { Post } from './PostCard';
+import type { Post } from './api';
 export declare function PostAgenda({ posts, onOpen }: {
     posts: Post[];
     onOpen: (p: Post) => void;

package/dist/product/social/PostCard.d.ts

@@ -1,13 +1,4 @@
-import { type ChannelLike } from './ChannelBadge';
-export type Post = {
-    id: string;
-    content: string;
-    channel: ChannelLike;
-    status: string;
-    /** unix seconds; 0/undefined = not scheduled */
-    scheduleAt?: number;
-    media?: string[];
-};
+import type { Post } from './api';
 export declare function PostCard({ post, onEdit, onDelete, }: {
     post: Post;
     onEdit?: (p: Post) => void;

package/dist/product/social/PostComposer.d.ts

@@ -1,4 +1,4 @@
-import type { ProviderCapability } from './ProviderReadinessList';
+import type { ProviderCapability } from './api';
 /** Compose intents → the (status, scheduleAt) the backend stores. */
 export declare const COMPOSE_MODES: readonly ["draft", "schedule", "now"];
 export type ComposeMode = (typeof COMPOSE_MODES)[number];

package/dist/product/social/ProviderReadinessList.d.ts

@@ -1,10 +1,4 @@
-/** One network's readiness, as reported by the server. */
-export type ProviderCapability = {
-    provider: string;
-    credentialsConfigured: boolean;
-    /** The env vars still missing — shown verbatim, never summarized away. */
-    missingCredentials: string[];
-};
+import type { ProviderCapability } from './api';
 export declare function ProviderReadinessList({ providers }: {
     providers: ProviderCapability[];
 }): import("react/jsx-runtime").JSX.Element;

package/dist/product/social/SocialResource.d.ts

@@ -0,0 +1,7 @@
+import { type SocialApi } from './api';
+export declare function SocialResource({ api, title, subtitle, }: {
+    /** The bound `/v1/social` client — `createSocialApi(<host transport>)`. */
+    api: SocialApi;
+    title?: string;
+    subtitle?: string;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/product/social/SocialSummaryBar.d.ts

@@ -1,9 +1,4 @@
-export type SocialSummary = {
-    posts: number;
-    scheduled: number;
-    published: number;
-    accounts: number;
-};
+import type { SocialSummary } from './api';
 export declare function SocialSummaryBar({ summary }: {
     summary: SocialSummary;
 }): import("react/jsx-runtime").JSX.Element;

package/dist/product/social/api.d.ts

@@ -0,0 +1,128 @@
+/**
+ * The `/v1/social` contract — the ONE typed client for the Hanzo Social surface,
+ * shared by every host that renders it (the console's Publish product, the dedicated
+ * social.hanzo.ai app, any white-label admin).
+ *
+ * The backend is `hanzoai/cloud` `clients/social`: a native-Go per-org accounts+posts
+ * store on Base/SQLite (the in-process fold of the standalone social stack, twin of
+ * clients/crm) — NOT a proxy to the retired social pods. Routes (social.go):
+ *
+ *   GET                 /v1/social/summary               per-org roll-up
+ *   GET                 /v1/social/providers             publish-readiness per network
+ *   GET/POST            /v1/social/accounts              list (?provider=) / connect
+ *   GET/PUT/DELETE      /v1/social/accounts/:id          detail / update / disconnect
+ *   GET/POST            /v1/social/posts                 list (?status=) / create-or-schedule
+ *   GET/PUT/DELETE      /v1/social/posts/:id             detail / update / delete
+ *   POST                /v1/social/posts/:id/publish     publish now
+ *
+ * TRANSPORT IS INJECTED. This layer never picks an origin, a credential or a fetch
+ * wrapper — the host passes a `SocialRest` whose paths are relative to `/v1/social`
+ * (`'summary'`, `'posts/<id>/publish'`), so the console rides its session-cookie
+ * `originV1Url` and another app rides its own. Every read/write is org-scoped
+ * SERVER-SIDE from the validated bearer/session owner claim; no org ever travels
+ * from the browser.
+ *
+ * Payloads are normalized DEFENSIVELY: a field rename upstream degrades a cell
+ * rather than throwing, and a list is read from whichever envelope key the backend
+ * uses (`data`/`items`/`rows`, or a bare array).
+ */
+/** Networks — the ONE ordered vocabulary (cloud rejects an unknown provider; '' → x). */
+export declare const PROVIDERS: readonly ["x", "facebook", "instagram", "linkedin", "tiktok", "youtube", "threads"];
+export type Provider = (typeof PROVIDERS)[number];
+/** Account connection lifecycle (cloud rejects an unknown status; '' → connected). */
+export declare const ACCOUNT_STATUSES: readonly ["connected", "disconnected", "error"];
+/** Post lifecycle (cloud rejects an unknown status; '' → draft). */
+export declare const POST_STATUSES: readonly ["draft", "scheduled", "published", "failed"];
+export type Account = {
+    id: string;
+    provider: string;
+    handle: string;
+    status: string;
+    createdAt: number;
+    updatedAt: number;
+};
+export type Post = {
+    id: string;
+    content: string;
+    channel: string;
+    status: string;
+    /** Unix seconds; 0 = not scheduled / publish now. */
+    scheduleAt: number;
+    /**
+     * Attached media URLs. Cloud ALWAYS serializes an array (never null) and its PUT
+     * rebuilds the row from the body — so this has to round-trip: an update that
+     * omitted it would wipe the post's media.
+     */
+    media: string[];
+    /** Server-managed publish results (empty until a publish attempt lands). */
+    accountId?: string;
+    externalId?: string;
+    error?: string;
+    createdAt: number;
+    updatedAt: number;
+};
+/** The per-org roll-up (GET /v1/social/summary) — the counts SocialSummaryBar renders. */
+export type SocialSummary = {
+    posts: number;
+    scheduled: number;
+    published: number;
+    accounts: number;
+};
+/**
+ * A network's publish-readiness (GET /v1/social/providers): whether this deployment
+ * holds the OAuth-app credentials to publish, and — if not — exactly which env vars
+ * are missing. The honest connect affordance; never a fabricated "connected".
+ */
+export type ProviderCapability = {
+    provider: string;
+    credentialsConfigured: boolean;
+    missingCredentials: string[];
+};
+/** Create/update bodies — only the writable fields (server owns id/org/timestamps). */
+export type NewAccount = Partial<Omit<Account, 'id' | 'createdAt' | 'updatedAt'>> & {
+    provider: string;
+};
+export type NewPost = Partial<Omit<Post, 'id' | 'createdAt' | 'updatedAt'>> & {
+    content: string;
+};
+export declare function normalizeAccount(raw: unknown): Account;
+export declare function normalizePost(raw: unknown): Post;
+export declare function normalizeSummary(raw: unknown): SocialSummary;
+export declare function normalizeProviderCapability(raw: unknown): ProviderCapability;
+export declare const normalizeAccounts: (p: unknown) => Account[];
+export declare const normalizePosts: (p: unknown) => Post[];
+export declare const normalizeProviders: (p: unknown) => ProviderCapability[];
+/**
+ * The host's REST transport. `path` is relative to `/v1/social` (no leading slash);
+ * the host owns the origin, the credential and the error class. A rejected promise
+ * is passed straight to `classifyBackend`, so any client's error type works.
+ */
+export type SocialRest = {
+    get: (path: string) => Promise<unknown>;
+    post: (path: string, body?: unknown) => Promise<unknown>;
+    put: (path: string, body?: unknown) => Promise<unknown>;
+    del: (path: string) => Promise<void>;
+};
+export type SocialApi = ReturnType<typeof createSocialApi>;
+/** Bind the `/v1/social` contract to a host transport. One method per documented route. */
+export declare function createSocialApi(rest: SocialRest): {
+    summary: () => Promise<SocialSummary>;
+    /** Publish-readiness per network (+ the exact missing OAuth-app credentials). */
+    providers: () => Promise<ProviderCapability[]>;
+    accounts: {
+        list: (provider?: string) => Promise<Account[]>;
+        get: (id: string) => Promise<Account>;
+        create: (body: NewAccount) => Promise<Account>;
+        update: (id: string, body: NewAccount) => Promise<Account>;
+        remove: (id: string) => Promise<void>;
+    };
+    posts: {
+        list: (status?: string) => Promise<Post[]>;
+        get: (id: string) => Promise<Post>;
+        create: (body: NewPost) => Promise<Post>;
+        update: (id: string, body: NewPost) => Promise<Post>;
+        remove: (id: string) => Promise<void>;
+        /** Publish a post NOW to its channel's connected accounts. */
+        publish: (id: string) => Promise<Post>;
+    };
+};

package/dist/product/social/index.d.ts

@@ -1,3 +1,5 @@
+export * from './api';
+export * from './SocialResource';
 export * from './ChannelBadge';
 export * from './CampaignCard';
 export * from './PostCard';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hanzo/ui",
-  "version": "8.0.12",
+  "version": "8.0.13",
   "type": "module",
   "description": "Hanzo UI — the one canonical, backend-flexible component library on @hanzo/gui + @hanzo/tokens. A shared design core (Hanzo dark-first tokens, Geist Sans/Mono typography) with per-backend implementations: the shadcn-compatible web surface (Radix + Tailwind, the API apps import) and the @hanzo/gui product layer (cross-platform web + native + desktop). Self-contained (theme.css), presentational, host-agnostic, clean-room.",
   "exports": {
@@ -132,8 +132,22 @@
   "files": [
     "dist"
   ],
+  "scripts": {
+    "build": "tsup && tsc -p tsconfig.build.json && mkdir -p dist/styles && cp src/styles/hanzo-motion.css dist/styles/hanzo-motion.css && node scripts/add-use-client.mjs",
+    "clean": "rm -rf dist types",
+    "gen:primitives": "node scripts/gen-primitives.mjs",
+    "prepack": "pnpm run build",
+    "tc": "tsc --noEmit",
+    "typecheck": "tsc --noEmit",
+    "typecheck:ui": "tsc -p tsconfig.check.json",
+    "check:svelte": "svelte-check --tsconfig ./tsconfig.svelte.json",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
   "dependencies": {
     "@hanzo/logo": "^1.0.13",
+    "@hanzo/products": "workspace:*",
+    "@hanzo/tokens": "workspace:*",
     "@hanzogui/telemetry": "^0.1.0",
     "@radix-ui/react-aspect-ratio": "^1.1.8",
     "@radix-ui/react-avatar": "^1.1.11",
@@ -158,15 +172,13 @@
     "cmdk": "^1.1.1",
     "lucide-react": ">=0.456.0",
     "sonner": "^2.0.7",
-    "tailwind-merge": "^3.5.0",
-    "@hanzo/products": "0.2.0",
-    "@hanzo/tokens": "1.0.0"
+    "tailwind-merge": "^3.5.0"
   },
   "peerDependencies": {
     "@hanzo/canvas": ">=0.1.0",
     "@hanzo/dashboard": ">=0.1.0",
     "@hanzo/data": ">=1.2.0",
-    "@hanzo/gitops": ">=0.1.0",
+    "@hanzo/cd": ">=0.1.0",
     "@hanzo/gui": ">=7.2.2",
     "@hanzo/ui-shadcn": ">=5.7.0",
     "@hanzo/usage": ">=0.1.0",
@@ -187,7 +199,7 @@
     "@hanzo/dashboard": {
       "optional": true
     },
-    "@hanzo/gitops": {
+    "@hanzo/cd": {
       "optional": true
     },
     "@hanzo/ui-shadcn": {
@@ -227,16 +239,5 @@
     "access": "public"
   },
   "license": "BSD-3-Clause",
-  "author": "Hanzo AI <dev@hanzo.ai>",
-  "scripts": {
-    "build": "tsup && tsc -p tsconfig.build.json && mkdir -p dist/styles && cp src/styles/hanzo-motion.css dist/styles/hanzo-motion.css && node scripts/add-use-client.mjs",
-    "clean": "rm -rf dist types",
-    "gen:primitives": "node scripts/gen-primitives.mjs",
-    "tc": "tsc --noEmit",
-    "typecheck": "tsc --noEmit",
-    "typecheck:ui": "tsc -p tsconfig.check.json",
-    "check:svelte": "svelte-check --tsconfig ./tsconfig.svelte.json",
-    "test": "vitest run",
-    "test:watch": "vitest"
-  }
-}
+  "author": "Hanzo AI <dev@hanzo.ai>"
+}

package/LICENSE.md

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2023 hanzo
-
-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.