@clockworkdog/cogs-client 2.11.2 → 3.0.0-alpha.0

package/dist/types/MediaSchema.d.ts

@@ -0,0 +1,199 @@
+import { z } from 'zod';
+export type TemporalProperties = z.infer<typeof TemporalProperties>;
+declare const TemporalProperties: z.ZodObject<{
+    t: z.ZodNumber;
+    rate: z.ZodNumber;
+}, z.core.$strip>;
+export type VisualProperties = z.infer<typeof VisualProperties>;
+declare const VisualProperties: z.ZodObject<{
+    opacity: z.ZodNumber;
+}, z.core.$strip>;
+export type AudialProperties = z.infer<typeof AudialProperties>;
+declare const AudialProperties: z.ZodObject<{
+    volume: z.ZodNumber;
+}, z.core.$strip>;
+export type ImageMetadata = z.infer<typeof ImageMetadata>;
+declare const ImageMetadata: z.ZodObject<{
+    type: z.ZodLiteral<"image">;
+    file: z.ZodString;
+    fit: z.ZodUnion<readonly [z.ZodLiteral<"contain">, z.ZodLiteral<"cover">, z.ZodLiteral<"none">]>;
+}, z.core.$strip>;
+export type AudioMetadata = z.infer<typeof AudioMetadata>;
+declare const AudioMetadata: z.ZodObject<{
+    type: z.ZodLiteral<"audio">;
+    file: z.ZodString;
+    audioOutput: z.ZodString;
+}, z.core.$strip>;
+export type VideoMetadata = z.infer<typeof VideoMetadata>;
+declare const VideoMetadata: z.ZodObject<{
+    type: z.ZodLiteral<"video">;
+    file: z.ZodString;
+    audioOutput: z.ZodString;
+    fit: z.ZodUnion<readonly [z.ZodLiteral<"contain">, z.ZodLiteral<"cover">, z.ZodLiteral<"none">]>;
+}, z.core.$strip>;
+export type NullKeyframe = z.infer<typeof NullKeyframe>;
+declare const NullKeyframe: z.ZodTuple<[z.ZodNumber, z.ZodNull], null>;
+/**
+ * Keyframes are indexed by a timestamp given in ms
+ */
+export type InitialImageKeyframe = z.infer<typeof InitialImageKeyframe>;
+declare const InitialImageKeyframe: z.ZodTuple<[z.ZodNumber, z.ZodObject<{
+    set: z.ZodOptional<z.ZodObject<{
+        opacity: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>], null>;
+/**
+ * Keyframes are indexed by a timestamp given in ms
+ */
+export type ImageKeyframe = z.infer<typeof ImageKeyframe>;
+declare const ImageKeyframe: z.ZodTuple<[z.ZodNumber, z.ZodObject<{
+    set: z.ZodOptional<z.ZodObject<{
+        opacity: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    lerp: z.ZodOptional<z.ZodObject<{
+        opacity: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>], null>;
+/**
+ * Keyframes are indexed by a timestamp given in ms
+ */
+export type InitialAudioKeyframe = z.infer<typeof InitialAudioKeyframe>;
+declare const InitialAudioKeyframe: z.ZodTuple<[z.ZodNumber, z.ZodObject<{
+    set: z.ZodOptional<z.ZodObject<{
+        volume: z.ZodOptional<z.ZodNumber>;
+        t: z.ZodOptional<z.ZodNumber>;
+        rate: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>], null>;
+/**
+ * Keyframes are indexed by a timestamp given in ms
+ */
+export type AudioKeyframe = z.infer<typeof AudioKeyframe>;
+declare const AudioKeyframe: z.ZodTuple<[z.ZodNumber, z.ZodObject<{
+    set: z.ZodOptional<z.ZodObject<{
+        volume: z.ZodOptional<z.ZodNumber>;
+        t: z.ZodOptional<z.ZodNumber>;
+        rate: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    lerp: z.ZodOptional<z.ZodObject<{
+        volume: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>], null>;
+/**
+ * Keyframes are indexed by a timestamp given in ms
+ */
+export type InitialVideoKeyframe = z.infer<typeof InitialVideoKeyframe>;
+declare const InitialVideoKeyframe: z.ZodTuple<[z.ZodNumber, z.ZodObject<{
+    set: z.ZodOptional<z.ZodObject<{
+        opacity: z.ZodOptional<z.ZodNumber>;
+        volume: z.ZodOptional<z.ZodNumber>;
+        t: z.ZodOptional<z.ZodNumber>;
+        rate: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>], null>;
+/**
+ * Keyframes are indexed by a timestamp given in ms
+ */
+export type VideoKeyframe = z.infer<typeof VideoKeyframe>;
+declare const VideoKeyframe: z.ZodTuple<[z.ZodNumber, z.ZodObject<{
+    set: z.ZodOptional<z.ZodObject<{
+        opacity: z.ZodOptional<z.ZodNumber>;
+        volume: z.ZodOptional<z.ZodNumber>;
+        t: z.ZodOptional<z.ZodNumber>;
+        rate: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    lerp: z.ZodOptional<z.ZodObject<{
+        opacity: z.ZodOptional<z.ZodNumber>;
+        volume: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>], null>;
+export declare const MediaSurfaceStateSchema: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+    keyframes: z.ZodTuple<[z.ZodTuple<[z.ZodNumber, z.ZodObject<{
+        set: z.ZodOptional<z.ZodObject<{
+            opacity: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        lerp: z.ZodOptional<z.ZodObject<{
+            opacity: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>], null>], z.ZodUnion<readonly [z.ZodTuple<[z.ZodNumber, z.ZodObject<{
+        set: z.ZodOptional<z.ZodObject<{
+            opacity: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>], null>, z.ZodTuple<[z.ZodNumber, z.ZodNull], null>]>>;
+    type: z.ZodLiteral<"image">;
+    file: z.ZodString;
+    fit: z.ZodUnion<readonly [z.ZodLiteral<"contain">, z.ZodLiteral<"cover">, z.ZodLiteral<"none">]>;
+}, z.core.$strip>, z.ZodObject<{
+    keyframes: z.ZodTuple<[z.ZodTuple<[z.ZodNumber, z.ZodObject<{
+        set: z.ZodOptional<z.ZodObject<{
+            volume: z.ZodOptional<z.ZodNumber>;
+            t: z.ZodOptional<z.ZodNumber>;
+            rate: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        lerp: z.ZodOptional<z.ZodObject<{
+            volume: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>], null>], z.ZodUnion<readonly [z.ZodTuple<[z.ZodNumber, z.ZodObject<{
+        set: z.ZodOptional<z.ZodObject<{
+            volume: z.ZodOptional<z.ZodNumber>;
+            t: z.ZodOptional<z.ZodNumber>;
+            rate: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>], null>, z.ZodTuple<[z.ZodNumber, z.ZodNull], null>]>>;
+    type: z.ZodLiteral<"audio">;
+    file: z.ZodString;
+    audioOutput: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    keyframes: z.ZodTuple<[z.ZodTuple<[z.ZodNumber, z.ZodObject<{
+        set: z.ZodOptional<z.ZodObject<{
+            opacity: z.ZodOptional<z.ZodNumber>;
+            volume: z.ZodOptional<z.ZodNumber>;
+            t: z.ZodOptional<z.ZodNumber>;
+            rate: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        lerp: z.ZodOptional<z.ZodObject<{
+            opacity: z.ZodOptional<z.ZodNumber>;
+            volume: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>], null>], z.ZodUnion<readonly [z.ZodTuple<[z.ZodNumber, z.ZodObject<{
+        set: z.ZodOptional<z.ZodObject<{
+            opacity: z.ZodOptional<z.ZodNumber>;
+            volume: z.ZodOptional<z.ZodNumber>;
+            t: z.ZodOptional<z.ZodNumber>;
+            rate: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>], null>, z.ZodTuple<[z.ZodNumber, z.ZodNull], null>]>>;
+    type: z.ZodLiteral<"video">;
+    file: z.ZodString;
+    audioOutput: z.ZodString;
+    fit: z.ZodUnion<readonly [z.ZodLiteral<"contain">, z.ZodLiteral<"cover">, z.ZodLiteral<"none">]>;
+}, z.core.$strip>]>>;
+export type ImageOptions = VisualProperties;
+export type AudioOptions = TemporalProperties & AudialProperties;
+export type VideoOptions = TemporalProperties & VisualProperties & AudialProperties;
+export type ImageState = {
+    type: 'image';
+    file: string;
+    fit: 'cover' | 'contain' | 'none';
+    keyframes: [InitialImageKeyframe, ...Array<ImageKeyframe | NullKeyframe>];
+};
+export type AudioState = {
+    type: 'audio';
+    file: string;
+    audioOutput: string;
+    keyframes: [InitialAudioKeyframe, ...Array<AudioKeyframe | NullKeyframe>];
+};
+export type VideoState = {
+    type: 'video';
+    file: string;
+    fit: 'cover' | 'contain' | 'none';
+    audioOutput: string;
+    keyframes: [InitialVideoKeyframe, ...Array<VideoKeyframe | NullKeyframe>];
+};
+export type MediaClipState = ImageState | AudioState | VideoState;
+export type MediaSurfaceState = Record<string, MediaClipState>;
+export type UnionsEqual<A, B> = Exclude<A, B> extends never ? (Exclude<B, A> extends never ? true : false) : false;
+export declare const defaultImageOptions: ImageOptions;
+export declare const defaultAudioOptions: AudioOptions;
+export declare const defaultVideoOptions: VideoOptions;
+export {};

package/dist/types/MediaSchema.js

@@ -0,0 +1,153 @@
+import { z } from 'zod';
+const TemporalProperties = z.object({
+    t: z.number().gte(0),
+    rate: z.number().gte(0),
+});
+const VisualProperties = z.object({
+    opacity: z.number().gte(0).lte(1),
+});
+const AudialProperties = z.object({
+    volume: z.number().gte(0).lte(1),
+});
+const ImageMetadata = z.object({
+    type: z.literal('image'),
+    file: z.string(),
+    fit: z.union([z.literal('contain'), z.literal('cover'), z.literal('none')]),
+});
+const AudioMetadata = z.object({
+    type: z.literal('audio'),
+    file: z.string(),
+    audioOutput: z.string(),
+});
+const VideoMetadata = z.object({
+    type: z.literal('video'),
+    file: z.string(),
+    audioOutput: z.string(),
+    fit: z.union([z.literal('contain'), z.literal('cover'), z.literal('none')]),
+});
+const NullKeyframe = z.tuple([z.number(), z.null()]);
+const InitialImageKeyframe = z.tuple([
+    z.number(),
+    z
+        .object({
+        set: z
+            .object({
+            ...VisualProperties.shape,
+        })
+            .partial(),
+    })
+        .partial(),
+]);
+const ImageKeyframe = z.tuple([
+    z.number(),
+    z
+        .object({
+        set: z
+            .object({
+            ...VisualProperties.shape,
+        })
+            .partial(),
+        lerp: z
+            .object({
+            ...VisualProperties.shape,
+        })
+            .partial(),
+    })
+        .partial(),
+]);
+const InitialAudioKeyframe = z.tuple([
+    z.number(),
+    z
+        .object({
+        set: z
+            .object({
+            ...TemporalProperties.shape,
+            ...AudialProperties.shape,
+        })
+            .partial(),
+    })
+        .partial(),
+]);
+const AudioKeyframe = z.tuple([
+    z.number(),
+    z
+        .object({
+        set: z
+            .object({
+            ...TemporalProperties.shape,
+            ...AudialProperties.shape,
+        })
+            .partial(),
+        lerp: z
+            .object({
+            ...AudialProperties.shape,
+        })
+            .partial(),
+    })
+        .partial(),
+]);
+const InitialVideoKeyframe = z.tuple([
+    z.number(),
+    z
+        .object({
+        set: z
+            .object({
+            ...TemporalProperties.shape,
+            ...AudialProperties.shape,
+            ...VisualProperties.shape,
+        })
+            .partial(),
+    })
+        .partial(),
+]);
+const VideoKeyframe = z.tuple([
+    z.number(),
+    z
+        .object({
+        set: z
+            .object({
+            ...TemporalProperties.shape,
+            ...AudialProperties.shape,
+            ...VisualProperties.shape,
+        })
+            .partial(),
+        lerp: z
+            .object({
+            ...AudialProperties.shape,
+            ...VisualProperties.shape,
+        })
+            .partial(),
+    })
+        .partial(),
+]);
+const ImageClip = z.object({
+    ...ImageMetadata.shape,
+    keyframes: z.tuple([ImageKeyframe], z.union([InitialImageKeyframe, NullKeyframe])),
+});
+const AudioClip = z.object({
+    ...AudioMetadata.shape,
+    keyframes: z.tuple([AudioKeyframe], z.union([InitialAudioKeyframe, NullKeyframe])),
+});
+const VideoClip = z.object({
+    ...VideoMetadata.shape,
+    keyframes: z.tuple([VideoKeyframe], z.union([InitialVideoKeyframe, NullKeyframe])),
+});
+export const MediaSurfaceStateSchema = z.record(z.string(), z.union([ImageClip, AudioClip, VideoClip]));
+true;
+true;
+true;
+true;
+export const defaultImageOptions = {
+    opacity: 1,
+};
+export const defaultAudioOptions = {
+    t: 0,
+    rate: 1,
+    volume: 1,
+};
+export const defaultVideoOptions = {
+    t: 0,
+    rate: 1,
+    volume: 1,
+    opacity: 1,
+};

package/package.json

@@ -3,7 +3,7 @@
   "description": "Connect to COGS to build a custom Media Master",
   "author": "Clockwork Dog <info@clockwork.dog>",
   "homepage": "https://github.com/clockwork-dog/cogs-sdk/tree/main/packages/javascript",
-  "version": "2.11.2",
+  "version": "3.0.0-alpha.0",
   "keywords": [],
   "license": "MIT",
   "repository": {
@@ -30,12 +30,14 @@
     "build:browser": "vite build",
     "watch-build": "tsc -w",
     "build-docs": "typedoc --out ../../docs/javascript --name @clockworkdog/cogs-client src/index.ts",
-    "release": "yarn npm publish --access public"
+    "release": "yarn npm publish --access public",
+    "prerelease": "yarn npm publish --access public --tag=next"
   },
   "dependencies": {
-    "@clockworkdog/timesync": "^2.11.2",
+    "@clockworkdog/timesync": "^3.0.0-alpha.0",
     "howler": "clockwork-dog/howler.js#fix-looping-clips",
-    "reconnecting-websocket": "^4.4.0"
+    "reconnecting-websocket": "^4.4.0",
+    "zod": "^4.1.13"
   },
   "devDependencies": {
     "@eslint/js": "^9.17.0",
@@ -52,5 +54,6 @@
     "typescript-eslint": "^8.18.1",
     "vite": "^7.1.12",
     "vitest": "^4.0.6"
-  }
+  },
+  "stableVersion": "0.0.0"
 }