@drawcall/market 0.1.0

package/dist/resolve.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Dependency resolver for market assets.
+ *
+ * 1. Collects the target assets and all transitive asset dependencies.
+ * 2. For each asset, finds a version that satisfies ALL constraints from
+ *    every dependent.
+ * 3. Merges npm dependency ranges across all resolved assets and checks
+ *    that they are compatible.
+ */
+import type { MarketClient } from './client.js';
+export interface ResolvedAsset {
+    name: string;
+    version: string;
+    npmDependencies: Record<string, string>;
+    assetDependencies: Record<string, string>;
+}
+export interface ResolveResult {
+    assets: ResolvedAsset[];
+    npmDependencies: Record<string, string>;
+}
+interface AssetRequest {
+    name: string;
+    range: string;
+}
+export declare class ResolutionError extends Error {
+    constructor(message: string);
+}
+export declare function resolve(client: MarketClient['asset'], requests: AssetRequest[], opts?: {
+    includeUnapproved?: boolean;
+}): Promise<ResolveResult>;
+export {};
+//# sourceMappingURL=resolve.d.ts.map

package/dist/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAG/C,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACvC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC1C;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,aAAa,EAAE,CAAA;IACvB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACxC;AAED,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd;AAED,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAsB,OAAO,CAC3B,MAAM,EAAE,YAAY,CAAC,OAAO,CAAC,EAC7B,QAAQ,EAAE,YAAY,EAAE,EACxB,IAAI,GAAE;IAAE,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAAO,GACzC,OAAO,CAAC,aAAa,CAAC,CA6FxB"}

package/dist/resolve.js

@@ -0,0 +1,145 @@
+/**
+ * Dependency resolver for market assets.
+ *
+ * 1. Collects the target assets and all transitive asset dependencies.
+ * 2. For each asset, finds a version that satisfies ALL constraints from
+ *    every dependent.
+ * 3. Merges npm dependency ranges across all resolved assets and checks
+ *    that they are compatible.
+ */
+import * as semver from 'semver';
+export class ResolutionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ResolutionError';
+    }
+}
+export async function resolve(client, requests, opts = {}) {
+    // constraints[assetName] = list of { range, from } constraints
+    const constraints = new Map();
+    // resolved[assetName] = ResolvedAsset
+    const resolved = new Map();
+    // cache of fetched metadata
+    const metaCache = new Map();
+    // Seed constraints from the requested assets
+    for (const req of requests) {
+        addConstraint(constraints, req.name, req.range, '<root>');
+    }
+    // Iteratively resolve until stable
+    let unresolved = getUnresolved(constraints, resolved);
+    while (unresolved.length > 0) {
+        for (const assetName of unresolved) {
+            const meta = await fetchMeta(client, metaCache, assetName);
+            if (!meta) {
+                throw new ResolutionError(`Asset "${assetName}" not found.`);
+            }
+            // Filter to approved versions (unless --unapproved)
+            const candidates = meta.versions.filter((v) => opts.includeUnapproved || v.approved);
+            if (candidates.length === 0) {
+                throw new ResolutionError(`Asset "${assetName}" has no ${opts.includeUnapproved ? '' : 'approved '}versions.`);
+            }
+            // Collect all constraints for this asset
+            const assetConstraints = constraints.get(assetName) ?? [];
+            // Find the best (highest) version that satisfies ALL constraints
+            const candidateVersions = candidates.map((c) => c.version);
+            const satisfying = candidateVersions.filter((v) => assetConstraints.every((c) => semver.satisfies(v, c.range)));
+            if (satisfying.length === 0) {
+                const constraintDesc = assetConstraints
+                    .map((c) => `  ${c.range} (from ${c.from})`)
+                    .join('\n');
+                throw new ResolutionError(`No version of "${assetName}" satisfies all constraints:\n${constraintDesc}\n` +
+                    `Available${opts.includeUnapproved ? '' : ' approved'}: ${candidateVersions.join(', ')}`);
+            }
+            const best = semver.maxSatisfying(satisfying, '*');
+            const versionMeta = candidates.find((c) => c.version === best);
+            const npmDeps = JSON.parse(versionMeta.npmDependencies);
+            const assetDeps = JSON.parse(versionMeta.assetDependencies);
+            resolved.set(assetName, {
+                name: assetName,
+                version: best,
+                npmDependencies: npmDeps,
+                assetDependencies: assetDeps,
+            });
+            // Add transitive asset dependency constraints
+            for (const [depName, depRange] of Object.entries(assetDeps)) {
+                addConstraint(constraints, depName, depRange, `${assetName}@${best}`);
+            }
+        }
+        unresolved = getUnresolved(constraints, resolved);
+    }
+    // Verify all resolved versions still satisfy constraints (transitive deps
+    // may have added new constraints after we resolved a version)
+    for (const [assetName, asset] of resolved) {
+        const assetConstraints = constraints.get(assetName) ?? [];
+        for (const c of assetConstraints) {
+            if (!semver.satisfies(asset.version, c.range)) {
+                throw new ResolutionError(`Conflict: "${assetName}@${asset.version}" does not satisfy ` +
+                    `${c.range} (required by ${c.from}).`);
+            }
+        }
+    }
+    // Merge npm dependencies across all resolved assets
+    const mergedNpm = mergeNpmDependencies(Array.from(resolved.values()));
+    return {
+        assets: Array.from(resolved.values()),
+        npmDependencies: mergedNpm,
+    };
+}
+function addConstraint(constraints, name, range, from) {
+    const existing = constraints.get(name) ?? [];
+    existing.push({ range, from });
+    constraints.set(name, existing);
+}
+function getUnresolved(constraints, resolved) {
+    return Array.from(constraints.keys()).filter((name) => !resolved.has(name));
+}
+async function fetchMeta(client, cache, name) {
+    if (cache.has(name))
+        return cache.get(name);
+    const meta = await client.getByName({ name });
+    if (meta)
+        cache.set(name, meta);
+    return meta;
+}
+/**
+ * Merge npm dependency ranges from all resolved assets.
+ * For each package, check that all declared ranges are compatible
+ * (using semver.intersects). Return the narrowest range.
+ */
+function mergeNpmDependencies(assets) {
+    // Collect all ranges per package
+    const rangesPerPkg = new Map();
+    for (const asset of assets) {
+        for (const [pkg, range] of Object.entries(asset.npmDependencies)) {
+            const existing = rangesPerPkg.get(pkg) ?? [];
+            existing.push({ range, from: `${asset.name}@${asset.version}` });
+            rangesPerPkg.set(pkg, existing);
+        }
+    }
+    const merged = {};
+    for (const [pkg, ranges] of rangesPerPkg) {
+        // Check pairwise compatibility
+        for (let i = 0; i < ranges.length; i++) {
+            for (let j = i + 1; j < ranges.length; j++) {
+                if (!semver.intersects(ranges[i].range, ranges[j].range)) {
+                    throw new ResolutionError(`npm dependency conflict for "${pkg}":\n` +
+                        `  ${ranges[i].range} (from ${ranges[i].from})\n` +
+                        `  ${ranges[j].range} (from ${ranges[j].from})`);
+                }
+            }
+        }
+        // Use the narrowest (most constrained) range.
+        // Simple heuristic: pick the range with the highest minimum version.
+        let narrowest = ranges[0].range;
+        for (const r of ranges.slice(1)) {
+            const minCurrent = semver.minVersion(narrowest);
+            const minNew = semver.minVersion(r.range);
+            if (minCurrent && minNew && semver.gt(minNew, minCurrent)) {
+                narrowest = r.range;
+            }
+        }
+        merged[pkg] = narrowest;
+    }
+    return merged;
+}
+//# sourceMappingURL=resolve.js.map

package/dist/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"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"}

package/dist/schemas.d.ts

@@ -0,0 +1,65 @@
+import { z } from 'zod';
+export declare const ASSET_TYPES: readonly ["generic", "model", "hdri", "material", "music"];
+export type AssetType = (typeof ASSET_TYPES)[number];
+export declare const assetTypeSchema: z.ZodEnum<{
+    generic: "generic";
+    model: "model";
+    hdri: "hdri";
+    material: "material";
+    music: "music";
+}>;
+export declare const semverSchema: z.ZodString;
+export declare const assetNameSchema: z.ZodString;
+export declare const npmDependenciesSchema: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+export declare const assetDependenciesSchema: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+export declare const uploadGenericSchema: z.ZodObject<{
+    name: z.ZodString;
+    version: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    npmDependencies: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    assetDependencies: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const uploadTypedSchema: z.ZodObject<{
+    name: z.ZodString;
+    version: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const uploadMaterialSchema: z.ZodObject<{
+    name: z.ZodString;
+    version: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    properties: z.ZodObject<{
+        color: z.ZodDefault<z.ZodString>;
+        roughness: z.ZodDefault<z.ZodNumber>;
+        metalness: z.ZodDefault<z.ZodNumber>;
+        normalScale: z.ZodDefault<z.ZodNumber>;
+        emissive: z.ZodDefault<z.ZodString>;
+        emissiveIntensity: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const updateProfileSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    image: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const listAssetsSchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodNumber>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    type: z.ZodOptional<z.ZodEnum<{
+        generic: "generic";
+        model: "model";
+        hdri: "hdri";
+        material: "material";
+        music: "music";
+    }>>;
+    tag: z.ZodOptional<z.ZodString>;
+    search: z.ZodOptional<z.ZodString>;
+    sort: z.ZodDefault<z.ZodEnum<{
+        newest: "newest";
+        alphabetical: "alphabetical";
+        relevance: "relevance";
+    }>>;
+}, z.core.$strip>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,eAAO,MAAM,WAAW,4DAA6D,CAAA;AACrF,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAA;AAEpD,eAAO,MAAM,eAAe;;;;;;EAAsB,CAAA;AAElD,eAAO,MAAM,YAAY,aAKtB,CAAA;AAEH,eAAO,MAAM,eAAe,aAUxB,CAAA;AAEJ,eAAO,MAAM,qBAAqB,qDAA+C,CAAA;AAEjF,eAAO,MAAM,uBAAuB,qDAA+C,CAAA;AAEnF,eAAO,MAAM,mBAAmB;;;;;;;iBAO9B,CAAA;AAEF,eAAO,MAAM,iBAAiB;;;;;iBAK5B,CAAA;AAEF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;iBAS/B,CAAA;AAEF,eAAO,MAAM,mBAAmB;;;iBAG9B,CAAA;AAEF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;iBAO3B,CAAA"}

package/dist/schemas.js

@@ -0,0 +1,53 @@
+import { z } from 'zod';
+export const ASSET_TYPES = ['generic', 'model', 'hdri', 'material', 'music'];
+export const assetTypeSchema = z.enum(ASSET_TYPES);
+export const semverSchema = z
+    .string()
+    .regex(/^\d+\.\d+\.\d+(-[a-zA-Z0-9.]+)?(\+[a-zA-Z0-9.]+)?$/, 'Must be a valid semver version (e.g. 1.0.0)');
+export const assetNameSchema = z
+    .string()
+    .min(1)
+    .max(128)
+    .regex(/^[a-z0-9][a-z0-9-]*[a-z0-9]$/, 'Must be lowercase alphanumeric with hyphens, no leading/trailing hyphens')
+    .refine((name) => !name.endsWith('-example'), {
+    message: "Asset names cannot end with '-example' (reserved for generated examples)",
+});
+export const npmDependenciesSchema = z.record(z.string(), z.string()).default({});
+export const assetDependenciesSchema = z.record(z.string(), z.string()).default({});
+export const uploadGenericSchema = z.object({
+    name: assetNameSchema,
+    version: semverSchema,
+    description: z.string().max(1000).optional(),
+    npmDependencies: npmDependenciesSchema,
+    assetDependencies: assetDependenciesSchema,
+    tags: z.array(z.string()).default([]),
+});
+export const uploadTypedSchema = z.object({
+    name: assetNameSchema,
+    version: semverSchema,
+    description: z.string().max(1000).optional(),
+    tags: z.array(z.string()).default([]),
+});
+export const uploadMaterialSchema = uploadTypedSchema.extend({
+    properties: z.object({
+        color: z.string().default('#ffffff'),
+        roughness: z.number().min(0).max(1).default(0.5),
+        metalness: z.number().min(0).max(1).default(0),
+        normalScale: z.number().min(0).max(2).default(1),
+        emissive: z.string().default('#000000'),
+        emissiveIntensity: z.number().min(0).max(10).default(0),
+    }),
+});
+export const updateProfileSchema = z.object({
+    name: z.string().min(1).max(100).optional(),
+    image: z.string().url().optional(),
+});
+export const listAssetsSchema = z.object({
+    page: z.number().int().min(1).default(1),
+    limit: z.number().int().min(1).max(100).default(20),
+    type: assetTypeSchema.optional(),
+    tag: z.string().optional(),
+    search: z.string().max(200).optional(),
+    sort: z.enum(['newest', 'alphabetical', 'relevance']).default('newest'),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@drawcall/market",
+  "version": "0.1.0",
+  "type": "module",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "bin": {
+    "market": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/cli.ts",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@orpc/contract": "^1.0.0",
+    "@orpc/client": "^1.0.0",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "nypm": "^0.6.0",
+    "semver": "^7.7.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "@types/semver": "^7.5.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0"
+  }
+}

package/src/cli.ts

@@ -0,0 +1,72 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander'
+import chalk from 'chalk'
+import { createMarketClient } from './client.js'
+import { resolve, ResolutionError, type ResolveResult } from './resolve.js'
+import { install } from './install.js'
+
+const program = new Command()
+
+program.name('market').description('Install assets from the drawcall.ai market').version('0.1.0')
+
+program
+  .command('install')
+  .description('Install assets into your project')
+  .argument('<assets...>', 'Assets to install (e.g. my-model, my-model@^2.0.0)')
+  .option('--unapproved', 'Include unapproved versions', false)
+  .option('--api <url>', 'API base URL', process.env.MARKET_API_URL ?? 'http://localhost:8787')
+  .option('--cwd <dir>', 'Project directory', process.cwd())
+  .action(async (assetArgs: string[], opts) => {
+    const client = createMarketClient({ baseUrl: opts.api })
+
+    // Parse asset[@range] arguments
+    const requests = assetArgs.map((arg) => {
+      const atIdx = arg.indexOf('@', 1)
+      if (atIdx > 0) {
+        return { name: arg.slice(0, atIdx), range: arg.slice(atIdx + 1) }
+      }
+      return { name: arg, range: '*' }
+    })
+
+    // Resolve
+    console.log(chalk.bold('Resolving dependencies...\n'))
+
+    let resolution: ResolveResult
+    try {
+      resolution = await resolve(client.asset, requests, {
+        includeUnapproved: opts.unapproved,
+      })
+    } catch (err) {
+      if (err instanceof ResolutionError) {
+        console.error(chalk.red('Resolution failed:\n') + err.message)
+        process.exit(1)
+      }
+      throw err
+    }
+
+    console.log(chalk.green(`  ${resolution.assets.length} asset(s) resolved:\n`))
+    for (const asset of resolution.assets) {
+      console.log(`    ${chalk.cyan(asset.name)}${chalk.dim('@' + asset.version)}`)
+    }
+
+    const npmCount = Object.keys(resolution.npmDependencies).length
+    if (npmCount > 0) {
+      console.log(chalk.green(`\n  ${npmCount} npm dependenc${npmCount === 1 ? 'y' : 'ies'}:\n`))
+      for (const [pkg, range] of Object.entries(resolution.npmDependencies)) {
+        console.log(`    ${pkg} ${chalk.dim(range)}`)
+      }
+    }
+
+    // Install
+    console.log(chalk.bold('\nInstalling...\n'))
+
+    await install(client, resolution, {
+      cwd: opts.cwd,
+      onProgress: (msg) => console.log(chalk.dim(`  ${msg}`)),
+    })
+
+    console.log(chalk.bold.green('\nDone!'))
+  })
+
+program.parse()

package/src/client.ts

@@ -0,0 +1,38 @@
+import { createORPCClient } from '@orpc/client'
+import { RPCLink } from '@orpc/client/fetch'
+import type { ContractRouterClient } from '@orpc/contract'
+import type { AppContract } from './contract.js'
+import type { InternalContract } from './internal-contract.js'
+
+export type MarketClient = ContractRouterClient<AppContract>
+export type InternalClient = ContractRouterClient<InternalContract>
+
+export interface MarketClientOptions {
+  baseUrl: string
+  fetch?: typeof globalThis.fetch
+}
+
+function resolveUrl(baseUrl: string, path: string): string {
+  if (baseUrl) return `${baseUrl}${path}`
+  // In browser environments, use the current origin for relative URLs
+  if (typeof globalThis !== 'undefined' && 'location' in globalThis) {
+    return `${(globalThis as unknown as { location: { origin: string } }).location.origin}${path}`
+  }
+  throw new Error('baseUrl is required in non-browser environments')
+}
+
+export function createMarketClient(opts: MarketClientOptions): MarketClient {
+  const link = new RPCLink({
+    url: resolveUrl(opts.baseUrl, '/api/rpc'),
+    fetch: opts.fetch,
+  })
+  return createORPCClient<MarketClient>(link)
+}
+
+export function createInternalClient(opts: MarketClientOptions): InternalClient {
+  const link = new RPCLink({
+    url: resolveUrl(opts.baseUrl, '/api/internal-rpc'),
+    fetch: opts.fetch,
+  })
+  return createORPCClient<InternalClient>(link)
+}

package/src/constants.ts

@@ -0,0 +1,19 @@
+import type { AssetType } from './schemas.js'
+
+export const MAX_FILE_SIZE = 100 * 1024 * 1024 // 100MB
+
+export const ALLOWED_EXTENSIONS: Record<AssetType, string[]> = {
+  generic: ['.zip'],
+  model: ['.gltf', '.glb'],
+  hdri: ['.hdr', '.exr'],
+  material: [], // material is submitted as JSON, no file upload
+  music: ['.mp3', '.wav', '.ogg', '.flac'],
+}
+
+export const ASSET_TYPE_LABELS: Record<AssetType, string> = {
+  generic: 'Generic',
+  model: '3D Model',
+  hdri: 'HDRI',
+  material: 'Material',
+  music: 'Audio',
+}

package/src/contract.ts

@@ -0,0 +1,188 @@
+import { oc } from '@orpc/contract'
+import { z } from 'zod'
+import {
+  assetNameSchema,
+  semverSchema,
+  listAssetsSchema,
+  updateProfileSchema,
+  uploadGenericSchema,
+  uploadTypedSchema,
+  uploadMaterialSchema,
+} from './schemas.js'
+
+// ─── Output types ─────────────────────────────────────────────────────────────
+// These mirror what the server handlers return (Drizzle query results).
+// We use z.custom<T>() so the contract carries full types for the client
+// without duplicating every DB column as a Zod field.
+
+export interface AssetVersion {
+  id: number
+  assetId: number
+  version: string
+  approved: boolean
+  npmDependencies: string
+  assetDependencies: string
+  sourceKey: string
+  buildOutputKey: string | null
+  thumbnailKey: string | null
+  buildError: string | null
+  readme: string | null
+  createdAt: Date
+}
+
+export interface Asset {
+  id: number
+  name: string
+  type: string
+  description: string | null
+  ownerId: string
+  createdAt: Date
+  updatedAt: Date
+}
+
+export interface AssetWithVersionsAndTags extends Asset {
+  versions: AssetVersion[]
+  tags: string[]
+}
+
+export interface AssetListItem {
+  id: number
+  name: string
+  type: string
+  description: string | null
+  ownerId: string
+  createdAt: Date
+  updatedAt: Date
+  latestVersion: string
+  thumbnailKey: string | null
+  approved: boolean
+}
+
+export interface PaginatedList<T> {
+  items: T[]
+  total: number
+  page: number
+  limit: number
+  totalPages: number
+}
+
+export interface User {
+  id: string
+  name: string
+  email: string
+  emailVerified: boolean
+  image: string | null
+  role: string
+  createdAt: Date
+  updatedAt: Date
+}
+
+export interface AssetWithVersions extends Asset {
+  versions: AssetVersion[]
+}
+
+export interface UnapprovedItem {
+  versionId: number
+  assetId: number
+  assetName: string
+  assetType: string
+  version: string
+  buildError: string | null
+  buildOutputKey: string | null
+  thumbnailKey: string | null
+  createdAt: Date
+  ownerName: string
+  ownerEmail: string
+}
+
+export interface TagWithCount {
+  id: number
+  name: string
+  count: number
+}
+
+export interface FileTreeEntry {
+  path: string
+  size: number
+}
+
+// ─── Contract ─────────────────────────────────────────────────────────────────
+
+export const contract = {
+  asset: {
+    getByName: oc
+      .input(z.object({ name: assetNameSchema }))
+      .output(z.custom<AssetWithVersionsAndTags | null>()),
+
+    list: oc
+      .input(listAssetsSchema)
+      .output(z.custom<PaginatedList<AssetListItem>>()),
+
+    getVersionTree: oc
+      .input(z.object({ name: z.string(), version: semverSchema }))
+      .output(z.custom<FileTreeEntry[]>()),
+
+    getRawFile: oc
+      .input(z.object({ name: z.string(), version: semverSchema, path: z.string() }))
+      .output(z.instanceof(Blob)),
+  },
+
+  upload: {
+    generic: oc
+      .input(uploadGenericSchema.extend({ file: z.instanceof(File) }))
+      .output(z.custom<AssetVersion>()),
+
+    model: oc
+      .input(uploadTypedSchema.extend({ file: z.instanceof(File) }))
+      .output(z.custom<AssetVersion>()),
+
+    hdri: oc
+      .input(uploadTypedSchema.extend({ file: z.instanceof(File) }))
+      .output(z.custom<AssetVersion>()),
+
+    music: oc
+      .input(uploadTypedSchema.extend({ file: z.instanceof(File) }))
+      .output(z.custom<AssetVersion>()),
+
+    material: oc
+      .input(uploadMaterialSchema)
+      .output(z.custom<AssetVersion>()),
+  },
+
+  admin: {
+    listUnapproved: oc
+      .output(z.custom<UnapprovedItem[]>()),
+
+    approve: oc
+      .input(z.object({ assetName: z.string(), version: z.string() }))
+      .output(z.object({ success: z.boolean() })),
+
+    backfillEmbeddings: oc
+      .output(z.object({ indexed: z.number() })),
+  },
+
+  user: {
+    getProfile: oc
+      .output(z.custom<User | null>()),
+
+    updateProfile: oc
+      .input(updateProfileSchema)
+      .output(z.custom<User>()),
+
+    getApiKey: oc
+      .output(z.custom<{ prefix: string; createdAt: Date } | null>()),
+
+    regenerateApiKey: oc
+      .output(z.object({ key: z.string(), prefix: z.string() })),
+
+    myAssets: oc
+      .output(z.custom<AssetWithVersions[]>()),
+  },
+
+  tag: {
+    list: oc
+      .output(z.custom<TagWithCount[]>()),
+  },
+}
+
+export type AppContract = typeof contract