@vivix-labs/project-studio 0.0.0-stage → 1.0.0-beta

package/dist/shared.js

@@ -0,0 +1,228 @@
+// packages/project-studio/src/cost.ts
+function taskCostLabel(task) {
+  const cost = task.cost;
+  if (cost?.status === "settled" && cost.credits != null) return `${cost.credits} credits`;
+  if (cost?.status === "pending") return "Pending settlement";
+  return "-";
+}
+
+// packages/project-studio/src/shared.ts
+import { z as z2, defineOperation } from "vivix-studio/sdk/shared";
+
+// packages/project-studio/src/ads-shared.ts
+import { z } from "vivix-studio/sdk/shared";
+var fixedRef = z.object({ storeId: z.uuid(), objectId: z.uuid(), versionId: z.uuid() }).strict();
+var copy = z.string().max(8e3).default("");
+var clipScript = z.object({
+  title: z.string().trim().min(1).max(200),
+  visual: copy,
+  voiceover: copy,
+  onScreenText: copy,
+  cta: copy,
+  plannedDurationMs: z.number().int().positive().nullable().default(null)
+}).strict();
+var adBrief = z.object({
+  product: copy,
+  category: copy,
+  audience: copy,
+  sellingPoints: copy,
+  channel: copy,
+  aspectRatio: z.string().max(40).nullable().default(null),
+  targetDurationMs: z.number().int().positive().nullable().default(null),
+  body: copy,
+  productRefs: z.array(fixedRef).max(100).default([]),
+  modelRefs: z.array(fixedRef).max(100).default([])
+}).strict();
+var adStoryboard = z.object({
+  brief: adBrief,
+  clips: z.array(
+    z.object({
+      assetId: z.uuid(),
+      script: clipScript,
+      edits: z.array(z.object({ sourceVersionId: z.uuid(), editRef: fixedRef }).strict()).max(200)
+    }).strict()
+  ).max(200)
+}).strict().superRefine((value, context) => {
+  if (new Set(value.clips.map((c) => c.assetId)).size !== value.clips.length)
+    context.addIssue({ code: "custom", message: "A clip can appear only once in a storyboard." });
+  for (const clip of value.clips)
+    if (new Set(clip.edits.map((e) => e.sourceVersionId)).size !== clip.edits.length)
+      context.addIssue({
+        code: "custom",
+        message: "Each candidate has one current edit binding."
+      });
+});
+var adTypeId = "studio.adStoryboard";
+
+// packages/project-studio/src/shared.ts
+var studioConfig = z2.object({
+  role: z2.enum(["project", "coordinator"]).default("project"),
+  dataInstance: z2.string().min(1).default("user:data"),
+  apiInstance: z2.string().min(1).default("api"),
+  libraryInstance: z2.string().min(1).nullable().default(null)
+}).strict();
+var versionRef = z2.object({ storeId: z2.uuid(), objectId: z2.uuid(), versionId: z2.uuid() }).strict();
+var tags = z2.array(z2.string().trim().min(1).max(64)).max(50).transform((x) => [...new Set(x)]).default([]);
+var kind = z2.enum(["text", "image", "video", "audio", "file"]);
+var projectData = z2.object({
+  name: z2.string().trim().min(1).max(120),
+  description: z2.string().max(4e3).default(""),
+  status: z2.enum(["draft", "active", "archived"]).default("draft"),
+  aspectRatio: z2.string().nullable().default(null),
+  coverRef: versionRef.nullable().default(null),
+  briefRef: z2.object({ storeId: z2.uuid(), objectId: z2.uuid() }).strict().nullable().default(null),
+  tags
+}).strict();
+var assetData = z2.object({
+  projectId: z2.uuid(),
+  name: z2.string().trim().min(1).max(200),
+  kind,
+  purpose: z2.enum(["reference", "script", "shot", "music", "voice", "subtitle", "final", "other"]).default("other"),
+  origin: z2.enum(["upload", "library", "generated", "authored"]),
+  orderKey: z2.number().int().nullable().default(null),
+  tags,
+  lifecycle: z2.enum(["draft", "ready", "archived"]).default("draft"),
+  sourceRef: versionRef.nullable().default(null),
+  adoptedVersionId: z2.uuid().nullable().default(null)
+}).strict();
+var taskStates = [
+  "queued",
+  "submitting",
+  "submission_unknown",
+  "running",
+  "cancel_requested",
+  "remote_succeeded",
+  "saving",
+  "save_failed",
+  "partial",
+  "succeeded",
+  "failed",
+  "canceled"
+];
+var anchor = z2.discriminatedUnion("kind", [
+  z2.object({ kind: z2.literal("whole") }).strict(),
+  z2.object({
+    kind: z2.literal("timeRange"),
+    startMs: z2.number().int().nonnegative(),
+    endMs: z2.number().int().nonnegative()
+  }).strict()
+]);
+var generationInput = z2.object({
+  targetAssetId: z2.uuid().optional(),
+  taskName: z2.string().trim().min(1).max(200).optional(),
+  context: z2.record(z2.string().min(1).max(64), z2.string().min(1).max(200)).optional(),
+  expectedRevision: z2.number().int().positive().optional(),
+  newAsset: z2.object({
+    name: z2.string().trim().min(1).max(200),
+    kind: z2.enum(["image", "video", "audio"])
+  }).strict().optional(),
+  modelId: z2.string().min(1),
+  capabilityId: z2.string().min(1),
+  prompt: z2.string().max(32e3),
+  parameters: z2.record(z2.string(), z2.unknown()).default({}),
+  outputCount: z2.number().int().min(1).max(100).default(1),
+  inputs: z2.array(
+    z2.object({
+      ref: versionRef,
+      role: z2.string().min(1),
+      order: z2.number().int().nonnegative(),
+      weight: z2.number().finite().nullable().default(null)
+    }).strict()
+  ).max(100).default([]),
+  baseVersionId: z2.uuid().optional(),
+  changeRequest: z2.string().trim().min(1).max(4e3).optional(),
+  preserveRequest: z2.string().max(4e3).default(""),
+  anchor: anchor.default({ kind: "whole" }),
+  retryOfTaskId: z2.uuid().optional(),
+  acknowledgeUnknown: z2.boolean().optional()
+}).strict();
+var projectSettingsInput = z2.object({
+  projectId: z2.uuid(),
+  expectedRevision: z2.number().int().positive(),
+  changes: projectData.pick({ name: true, description: true, tags: true, aspectRatio: true, coverRef: true }).extend({
+    description: projectData.shape.description.unwrap(),
+    tags: projectData.shape.tags.unwrap(),
+    aspectRatio: projectData.shape.aspectRatio.unwrap(),
+    coverRef: projectData.shape.coverRef.unwrap()
+  }).partial().strict()
+}).strict();
+var generationSubmitOperation = defineOperation({
+  id: "generation.submit",
+  title: "Generate",
+  description: "Submit one media generation without approval, retaining its paid request identity.",
+  input: generationInput,
+  output: z2.any(),
+  effects: ["write", "paid"],
+  confirm: "none"
+});
+var studioOperations = { generationSubmit: generationSubmitOperation };
+var favoriteData = z2.object({ ref: versionRef }).strict();
+var sqlScalar = z2.union([z2.string(), z2.number().finite(), z2.null()]);
+var globalQueryInput = z2.object({
+  sql: z2.string().trim().min(1),
+  params: z2.union([z2.array(sqlScalar), z2.record(z2.string(), sqlScalar)]).optional(),
+  timeoutMs: z2.number().int().positive().optional(),
+  maxRows: z2.number().int().positive().optional(),
+  limit: z2.number().int().min(1).max(200).optional(),
+  offset: z2.number().int().nonnegative().optional(),
+  source: z2.enum(["projects", "assets", "tasks"]),
+  catalog: z2.array(z2.object({ id: z2.string().min(1), name: z2.string(), available: z2.boolean() }).strict()).optional()
+}).strict();
+var studioDefaultQueries = {
+  projects: "SELECT * FROM studio_projects ORDER BY createdAt DESC, rowId",
+  assets: "SELECT * FROM studio_assets ORDER BY createdAt DESC, rowId",
+  tasks: "SELECT * FROM studio_tasks ORDER BY createdAt DESC, rowId"
+};
+function generationOperation(model, kind2, referenceCount, action = "") {
+  if (!model || model.modality !== kind2) return "";
+  const operations = model.operations || [];
+  if (kind2 === "image") {
+    const name = referenceCount ? "image.edit" : "image.generate";
+    return operations.some((operation) => operation.name === name) ? name : "";
+  }
+  if (operations.length === 1) return operations[0].name;
+  return operations.some((operation) => operation.name === action) ? action : "";
+}
+function generationParameters(model, operation, raw, kinds) {
+  let parameters;
+  try {
+    parameters = JSON.parse(raw);
+  } catch {
+    return raw;
+  }
+  if (!parameters || typeof parameters !== "object" || Array.isArray(parameters)) return raw;
+  const mode = kinds.includes("video") ? "video" : kinds.includes("image") ? "image" : kinds.includes("audio") ? "audio" : "text";
+  const declared = model?.operations?.flatMap((item) => item.params || []) || [];
+  const active = (model?.operations?.find((item) => item.name === operation)?.params || []).filter((parameter) => !parameter.input_modes || parameter.input_modes.includes(mode));
+  return JSON.stringify(
+    Object.fromEntries(
+      Object.entries(parameters).filter(
+        ([name]) => active.some((parameter) => parameter.name === name) || !declared.some((parameter) => parameter.name === name)
+      )
+    )
+  );
+}
+export {
+  adBrief,
+  adStoryboard,
+  adTypeId,
+  anchor,
+  assetData,
+  clipScript,
+  favoriteData,
+  generationInput,
+  generationOperation,
+  generationParameters,
+  generationSubmitOperation,
+  globalQueryInput,
+  kind,
+  projectData,
+  projectSettingsInput,
+  studioConfig,
+  studioDefaultQueries,
+  studioOperations,
+  tags,
+  taskCostLabel,
+  taskStates,
+  versionRef
+};

package/package.json

@@ -1,6 +1,53 @@
 {
   "name": "@vivix-labs/project-studio",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.0.0-beta",
+  "type": "module",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/",
+    "tag": "beta"
+  },
+  "license": "MIT",
+  "files": [
+    "dist",
+    "studio-plugin.json",
+    "skills",
+    "presets",
+    "schemas"
+  ],
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "exports": {
+    "./studio-plugin.json": "./studio-plugin.json",
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js"
+    },
+    "./shared": {
+      "types": "./dist/shared.d.ts",
+      "import": "./dist/shared.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js"
+    },
+    "./events": {
+      "types": "./dist/events.d.ts",
+      "import": "./dist/events.js"
+    }
+  },
+  "peerDependencies": {
+    "vivix-studio": ">=2.2.0",
+    "@vivix-labs/creative-data": "1.0.0-beta",
+    "@vivix-labs/vivix-api": "1.0.0-beta",
+    "@vivix-labs/material-library": "1.0.0-beta",
+    "react": "19.3.1"
+  },
+  "devDependencies": {
+    "@vivix-labs/ui-system": "1.0.0-beta"
+  },
+  "scripts": {
+    "build": "node ../../scripts/build-product-packages.mjs project-studio"
+  }
 }

package/schemas/billing-notice.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "taskId": { "type": "string" },
+    "attemptId": { "type": "string" },
+    "billingRecordId": { "type": "string" },
+    "revision": {
+      "type": "integer",
+      "exclusiveMinimum": 0,
+      "maximum": 9007199254740991
+    }
+  },
+  "required": ["taskId", "attemptId", "billingRecordId", "revision"],
+  "additionalProperties": false
+}

package/schemas/task-notice.json

@@ -0,0 +1,57 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "taskId": { "type": "string" },
+    "attemptId": { "type": "string" },
+    "revision": {
+      "type": "integer",
+      "exclusiveMinimum": 0,
+      "maximum": 9007199254740991
+    },
+    "requestedCount": {
+      "anyOf": [
+        {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991
+        },
+        { "type": "null" }
+      ]
+    },
+    "resultCount": {
+      "anyOf": [
+        { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
+        { "type": "null" }
+      ]
+    },
+    "partialResults": { "type": ["boolean", "null"] },
+    "results": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "remoteTaskId": { "type": "string" },
+          "outputIndex": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 9007199254740991
+          },
+          "assetId": { "type": "string" }
+        },
+        "required": ["remoteTaskId", "outputIndex"],
+        "additionalProperties": false
+      }
+    }
+  },
+  "required": [
+    "taskId",
+    "attemptId",
+    "revision",
+    "requestedCount",
+    "resultCount",
+    "partialResults",
+    "results"
+  ],
+  "additionalProperties": false
+}

package/studio-plugin.json

@@ -0,0 +1,40 @@
+{
+  "manifestVersion": "0.2",
+  "id": "project-studio",
+  "requirements": {
+    "studioPluginApi": "^0.2.2"
+  },
+  "requestedAccess": ["events.publish"],
+  "events": {
+    "publishes": [
+      {
+        "name": "project-studio/task.completed",
+        "version": 1,
+        "mode": "notification",
+        "schema": "schemas/task-notice.json",
+        "scope": "project"
+      },
+      {
+        "name": "project-studio/task.failed",
+        "version": 1,
+        "mode": "notification",
+        "schema": "schemas/task-notice.json",
+        "scope": "project"
+      },
+      {
+        "name": "project-studio/task.cancelled",
+        "version": 1,
+        "mode": "notification",
+        "schema": "schemas/task-notice.json",
+        "scope": "project"
+      },
+      {
+        "name": "project-studio/billing.updated",
+        "version": 1,
+        "mode": "notification",
+        "schema": "schemas/billing-notice.json",
+        "scope": "project"
+      }
+    ]
+  }
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.