@blitzreels/contracts 0.1.0

package/README.md

@@ -0,0 +1,5 @@
+# @blitzreels/contracts
+
+Transport-independent factual contracts shared by the BlitzReels app, SDK, CLI, MCP, and public API.
+
+The package contains no Next.js, database, UI, Electric, or runtime environment imports.

package/dist/error-contract.d.ts

@@ -0,0 +1,34 @@
+export type PublicErrorCode = "api_error" | "auth_error" | "upgrade_required" | "not_found" | "conflict" | "validation_error" | "partial_failure" | "rate_limited" | "timeout" | "server_error";
+export declare const SEQUENCE_OPERATION_ERROR_CODES: readonly ["validation_error", "not_found", "permission_denied", "revision_conflict", "idempotency_conflict", "operation_in_progress", "operation_previous_failure", "sequence_busy", "mutation_failed"];
+export type SequenceOperationErrorCode = (typeof SEQUENCE_OPERATION_ERROR_CODES)[number];
+export type BlitzReelsErrorCode = PublicErrorCode | SequenceOperationErrorCode;
+export type BlitzReelsCliExitCode = 1 | 2 | 3 | 4 | 5 | 6 | 7;
+export type BlitzReelsErrorDetails = Record<string, string | number | boolean | null>;
+export type SequenceOperationItemFailure = {
+    timeline_item_id: string;
+    error: string;
+    error_code: SequenceOperationErrorCode;
+    retryable: boolean;
+    error_details: BlitzReelsErrorDetails;
+};
+export type SequenceOperationErrorDefinition = {
+    code: SequenceOperationErrorCode;
+    publicCode: PublicErrorCode;
+    httpStatus: 400 | 403 | 404 | 409 | 500;
+    nonRetryableCliExitCode: BlitzReelsCliExitCode;
+    retryableCliExitCode: BlitzReelsCliExitCode;
+};
+export declare const SEQUENCE_OPERATION_ERROR_DEFINITIONS: readonly [SequenceOperationErrorDefinition, SequenceOperationErrorDefinition, SequenceOperationErrorDefinition, SequenceOperationErrorDefinition, SequenceOperationErrorDefinition, SequenceOperationErrorDefinition, SequenceOperationErrorDefinition, SequenceOperationErrorDefinition, SequenceOperationErrorDefinition];
+export declare function isSequenceOperationErrorCode(value: string): value is SequenceOperationErrorCode;
+export declare function getSequenceOperationErrorDefinition({ code, }: {
+    code: SequenceOperationErrorCode;
+}): (typeof SEQUENCE_OPERATION_ERROR_DEFINITIONS)[number];
+export declare function isBlitzReelsErrorCode(value: string): value is BlitzReelsErrorCode;
+export declare function getBlitzReelsErrorCliExitCode({ code, retryable, }: {
+    code: BlitzReelsErrorCode;
+    retryable: boolean;
+}): BlitzReelsCliExitCode;
+export declare function getBlitzReelsErrorDefaultRetryable({ code, }: {
+    code: PublicErrorCode;
+}): boolean;
+//# sourceMappingURL=error-contract.d.ts.map

package/dist/error-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-contract.d.ts","sourceRoot":"","sources":["../src/error-contract.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GACvB,WAAW,GACX,YAAY,GACZ,kBAAkB,GAClB,WAAW,GACX,UAAU,GACV,kBAAkB,GAClB,iBAAiB,GACjB,cAAc,GACd,SAAS,GACT,cAAc,CAAC;AAEnB,eAAO,MAAM,8BAA8B,yMAUjC,CAAC;AAEX,MAAM,MAAM,0BAA0B,GACpC,CAAC,OAAO,8BAA8B,CAAC,CAAC,MAAM,CAAC,CAAC;AAElD,MAAM,MAAM,mBAAmB,GAAG,eAAe,GAAG,0BAA0B,CAAC;AAE/E,MAAM,MAAM,qBAAqB,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAE9D,MAAM,MAAM,sBAAsB,GAAG,MAAM,CACzC,MAAM,EACN,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CACjC,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,0BAA0B,CAAC;IACvC,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,sBAAsB,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG;IAC7C,IAAI,EAAE,0BAA0B,CAAC;IACjC,UAAU,EAAE,eAAe,CAAC;IAC5B,UAAU,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IACxC,uBAAuB,EAAE,qBAAqB,CAAC;IAC/C,oBAAoB,EAAE,qBAAqB,CAAC;CAC7C,CAAC;AAQF,eAAO,MAAM,oCAAoC,6TAgEvC,CAAC;AASX,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,MAAM,GACZ,KAAK,IAAI,0BAA0B,CAIrC;AAED,wBAAgB,mCAAmC,CAAC,EAClD,IAAI,GACL,EAAE;IACD,IAAI,EAAE,0BAA0B,CAAC;CAClC,GAAG,CAAC,OAAO,oCAAoC,CAAC,CAAC,MAAM,CAAC,CAMxD;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,GACZ,KAAK,IAAI,mBAAmB,CAc9B;AAED,wBAAgB,6BAA6B,CAAC,EAC5C,IAAI,EACJ,SAAS,GACV,EAAE;IACD,IAAI,EAAE,mBAAmB,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;CACpB,GAAG,qBAAqB,CAsBxB;AAED,wBAAgB,kCAAkC,CAAC,EACjD,IAAI,GACL,EAAE;IACD,IAAI,EAAE,eAAe,CAAC;CACvB,GAAG,OAAO,CAIV"}

package/dist/error-contract.js

@@ -0,0 +1,133 @@
+export const SEQUENCE_OPERATION_ERROR_CODES = [
+    "validation_error",
+    "not_found",
+    "permission_denied",
+    "revision_conflict",
+    "idempotency_conflict",
+    "operation_in_progress",
+    "operation_previous_failure",
+    "sequence_busy",
+    "mutation_failed",
+];
+function defineSequenceOperationError(definition) {
+    return definition;
+}
+export const SEQUENCE_OPERATION_ERROR_DEFINITIONS = [
+    defineSequenceOperationError({
+        code: "validation_error",
+        publicCode: "validation_error",
+        httpStatus: 400,
+        nonRetryableCliExitCode: 2,
+        retryableCliExitCode: 2,
+    }),
+    defineSequenceOperationError({
+        code: "not_found",
+        publicCode: "not_found",
+        httpStatus: 404,
+        nonRetryableCliExitCode: 4,
+        retryableCliExitCode: 4,
+    }),
+    defineSequenceOperationError({
+        code: "permission_denied",
+        publicCode: "auth_error",
+        httpStatus: 403,
+        nonRetryableCliExitCode: 3,
+        retryableCliExitCode: 3,
+    }),
+    defineSequenceOperationError({
+        code: "revision_conflict",
+        publicCode: "conflict",
+        httpStatus: 409,
+        nonRetryableCliExitCode: 5,
+        retryableCliExitCode: 5,
+    }),
+    defineSequenceOperationError({
+        code: "idempotency_conflict",
+        publicCode: "conflict",
+        httpStatus: 409,
+        nonRetryableCliExitCode: 5,
+        retryableCliExitCode: 5,
+    }),
+    defineSequenceOperationError({
+        code: "operation_in_progress",
+        publicCode: "conflict",
+        httpStatus: 409,
+        nonRetryableCliExitCode: 5,
+        retryableCliExitCode: 5,
+    }),
+    defineSequenceOperationError({
+        code: "operation_previous_failure",
+        publicCode: "conflict",
+        httpStatus: 409,
+        nonRetryableCliExitCode: 5,
+        retryableCliExitCode: 5,
+    }),
+    defineSequenceOperationError({
+        code: "sequence_busy",
+        publicCode: "conflict",
+        httpStatus: 409,
+        nonRetryableCliExitCode: 5,
+        retryableCliExitCode: 5,
+    }),
+    defineSequenceOperationError({
+        code: "mutation_failed",
+        publicCode: "server_error",
+        httpStatus: 500,
+        nonRetryableCliExitCode: 1,
+        retryableCliExitCode: 7,
+    }),
+];
+const sequenceOperationErrorDefinitionsByCode = new Map(SEQUENCE_OPERATION_ERROR_DEFINITIONS.map((definition) => [
+    definition.code,
+    definition,
+]));
+export function isSequenceOperationErrorCode(value) {
+    return sequenceOperationErrorDefinitionsByCode.has(value);
+}
+export function getSequenceOperationErrorDefinition({ code, }) {
+    const definition = sequenceOperationErrorDefinitionsByCode.get(code);
+    if (!definition) {
+        throw new Error(`Unknown sequence operation error: ${code}`);
+    }
+    return definition;
+}
+export function isBlitzReelsErrorCode(value) {
+    return (value === "api_error" ||
+        value === "auth_error" ||
+        value === "upgrade_required" ||
+        value === "not_found" ||
+        value === "conflict" ||
+        value === "validation_error" ||
+        value === "partial_failure" ||
+        value === "rate_limited" ||
+        value === "timeout" ||
+        value === "server_error" ||
+        isSequenceOperationErrorCode(value));
+}
+export function getBlitzReelsErrorCliExitCode({ code, retryable, }) {
+    if (isSequenceOperationErrorCode(code)) {
+        const definition = getSequenceOperationErrorDefinition({ code });
+        return retryable
+            ? definition.retryableCliExitCode
+            : definition.nonRetryableCliExitCode;
+    }
+    switch (code) {
+        case "auth_error":
+        case "upgrade_required":
+            return 3;
+        case "conflict":
+        case "partial_failure":
+            return 5;
+        case "rate_limited":
+            return 6;
+        case "timeout":
+        case "server_error":
+            return 7;
+        case "api_error":
+            return 1;
+    }
+}
+export function getBlitzReelsErrorDefaultRetryable({ code, }) {
+    return (code === "rate_limited" || code === "timeout" || code === "server_error");
+}
+//# sourceMappingURL=error-contract.js.map

package/dist/error-contract.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export type { BlitzReelsCliExitCode, BlitzReelsErrorCode, BlitzReelsErrorDetails, PublicErrorCode, SequenceOperationErrorCode, SequenceOperationErrorDefinition, SequenceOperationItemFailure, } from "./error-contract.js";
+export { getBlitzReelsErrorCliExitCode, getBlitzReelsErrorDefaultRetryable, getSequenceOperationErrorDefinition, isBlitzReelsErrorCode, isSequenceOperationErrorCode, SEQUENCE_OPERATION_ERROR_CODES, SEQUENCE_OPERATION_ERROR_DEFINITIONS, } from "./error-contract.js";
+export type { SequenceOperationDefinition, SequenceOperationExposure, SequenceOperationFamily, SequenceOperationId, SequenceOperationPreviewSupport, SequenceOperationPreviewSurface, SequenceOperationProjection, SequenceOperationProjections, SequenceOperationSurface, } from "./sequence-operation-registry.js";
+export { getSequenceOperationDefinition, isSequenceOperationId, SEQUENCE_OPERATION_DEFINITIONS, SEQUENCE_OPERATION_IDS, } from "./sequence-operation-registry.js";
+export type { SequenceTimingExecuteOptions, SequenceTimingExecuteResult, SequenceTimingOperation, SequenceTimingPreviewOptions, SequenceTimingPreviewResult, } from "./sequence-timing-contract.js";
+export type { TimelineBatchDeleteResult, TimelineBatchMoveResult, TimelineBatchTransformResult, TimelineBatchTrimResult, } from "./timeline-batch-contract.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,eAAe,EACf,0BAA0B,EAC1B,gCAAgC,EAChC,4BAA4B,GAC7B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,6BAA6B,EAC7B,kCAAkC,EAClC,mCAAmC,EACnC,qBAAqB,EACrB,4BAA4B,EAC5B,8BAA8B,EAC9B,oCAAoC,GACrC,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,2BAA2B,EAC3B,yBAAyB,EACzB,uBAAuB,EACvB,mBAAmB,EACnB,+BAA+B,EAC/B,+BAA+B,EAC/B,2BAA2B,EAC3B,4BAA4B,EAC5B,wBAAwB,GACzB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,8BAA8B,EAC9B,qBAAqB,EACrB,8BAA8B,EAC9B,sBAAsB,GACvB,MAAM,kCAAkC,CAAC;AAC1C,YAAY,EACV,4BAA4B,EAC5B,2BAA2B,EAC3B,uBAAuB,EACvB,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,+BAA+B,CAAC;AACvC,YAAY,EACV,yBAAyB,EACzB,uBAAuB,EACvB,4BAA4B,EAC5B,uBAAuB,GACxB,MAAM,8BAA8B,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { getBlitzReelsErrorCliExitCode, getBlitzReelsErrorDefaultRetryable, getSequenceOperationErrorDefinition, isBlitzReelsErrorCode, isSequenceOperationErrorCode, SEQUENCE_OPERATION_ERROR_CODES, SEQUENCE_OPERATION_ERROR_DEFINITIONS, } from "./error-contract.js";
+export { getSequenceOperationDefinition, isSequenceOperationId, SEQUENCE_OPERATION_DEFINITIONS, SEQUENCE_OPERATION_IDS, } from "./sequence-operation-registry.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,OAAO,EACL,6BAA6B,EAC7B,kCAAkC,EAClC,mCAAmC,EACnC,qBAAqB,EACrB,4BAA4B,EAC5B,8BAA8B,EAC9B,oCAAoC,GACrC,MAAM,qBAAqB,CAAC;AAY7B,OAAO,EACL,8BAA8B,EAC9B,qBAAqB,EACrB,8BAA8B,EAC9B,sBAAsB,GACvB,MAAM,kCAAkC,CAAC"}

package/dist/sequence-operation-registry.d.ts

@@ -0,0 +1,74 @@
+export type SequenceOperationExposure = "internal" | "public";
+export type SequenceOperationFamily = "item" | "batch" | "audio" | "effect" | "overlay" | "keyframe" | "crop" | "nle" | "structure" | "recut" | "caption";
+export type SequenceOperationSurface = "trpc" | "publicApi" | "mcp" | "sdk" | "cli" | "openapi" | "docs";
+export type SequenceOperationProjection = "direct" | "compatibility" | "none";
+export type SequenceOperationProjections = Record<SequenceOperationSurface, SequenceOperationProjection>;
+export type SequenceOperationPreviewSurface = "kernel" | SequenceOperationSurface;
+export type SequenceOperationPreviewSupport = Record<SequenceOperationPreviewSurface, boolean>;
+export type SequenceOperationDefinition = {
+    operationId: string;
+    family: SequenceOperationFamily;
+    summary: string;
+    destructive: boolean;
+    exposure: SequenceOperationExposure;
+    previewSupported: SequenceOperationPreviewSupport;
+    projections: SequenceOperationProjections;
+};
+export declare const SEQUENCE_OPERATION_DEFINITIONS: readonly [SequenceOperationDefinition & {
+    operationId: "timeline.item.add";
+}, SequenceOperationDefinition & {
+    operationId: "timeline.item.generic.add";
+}, SequenceOperationDefinition & {
+    operationId: "timeline.item.commit";
+}, SequenceOperationDefinition & {
+    operationId: "timeline.item.trim";
+}, SequenceOperationDefinition & {
+    operationId: "timeline.item.split";
+}, SequenceOperationDefinition & {
+    operationId: "timeline.item.remove";
+}, SequenceOperationDefinition & {
+    operationId: "timeline.item.transform";
+}, SequenceOperationDefinition & {
+    operationId: "timeline.items.commit";
+}, SequenceOperationDefinition & {
+    operationId: "timeline.items.remove";
+}, SequenceOperationDefinition & {
+    operationId: "timeline.item.split.batch";
+}, SequenceOperationDefinition & {
+    operationId: "timeline.items.duplicate";
+}, SequenceOperationDefinition & {
+    operationId: "timeline.item.replace";
+}, SequenceOperationDefinition & {
+    operationId: "timeline.item.audio.update";
+}, SequenceOperationDefinition & {
+    operationId: "timeline.items.order";
+}, SequenceOperationDefinition & {
+    operationId: "timeline.pack";
+}, SequenceOperationDefinition & {
+    operationId: "timeline.effect.add";
+}, SequenceOperationDefinition & {
+    operationId: "timeline.effect.update";
+}, SequenceOperationDefinition & {
+    operationId: "timeline.overlay.add";
+}, SequenceOperationDefinition & {
+    operationId: "timeline.overlay.update";
+}, SequenceOperationDefinition & {
+    operationId: "timeline.overlay.remove";
+}, SequenceOperationDefinition & {
+    operationId: "timeline.keyframes.commit";
+}, SequenceOperationDefinition & {
+    operationId: "timeline.crop.commit";
+}, SequenceOperationDefinition & {
+    operationId: "timeline.items.nle-edit";
+}, SequenceOperationDefinition & {
+    operationId: "timeline.structure.edit";
+}, SequenceOperationDefinition & {
+    operationId: "timeline.recut.apply";
+}, SequenceOperationDefinition & {
+    operationId: "timeline.captions.commit";
+}];
+export type SequenceOperationId = (typeof SEQUENCE_OPERATION_DEFINITIONS)[number]["operationId"];
+export declare const SEQUENCE_OPERATION_IDS: readonly SequenceOperationId[];
+export declare function isSequenceOperationId(value: string): value is SequenceOperationId;
+export declare function getSequenceOperationDefinition(operationId: SequenceOperationId): (typeof SEQUENCE_OPERATION_DEFINITIONS)[number];
+//# sourceMappingURL=sequence-operation-registry.d.ts.map

package/dist/sequence-operation-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequence-operation-registry.d.ts","sourceRoot":"","sources":["../src/sequence-operation-registry.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,yBAAyB,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE9D,MAAM,MAAM,uBAAuB,GAC/B,MAAM,GACN,OAAO,GACP,OAAO,GACP,QAAQ,GACR,SAAS,GACT,UAAU,GACV,MAAM,GACN,KAAK,GACL,WAAW,GACX,OAAO,GACP,SAAS,CAAC;AAEd,MAAM,MAAM,wBAAwB,GAChC,MAAM,GACN,WAAW,GACX,KAAK,GACL,KAAK,GACL,KAAK,GACL,SAAS,GACT,MAAM,CAAC;AAEX,MAAM,MAAM,2BAA2B,GAAG,QAAQ,GAAG,eAAe,GAAG,MAAM,CAAC;AAE9E,MAAM,MAAM,4BAA4B,GAAG,MAAM,CAC/C,wBAAwB,EACxB,2BAA2B,CAC5B,CAAC;AAEF,MAAM,MAAM,+BAA+B,GACvC,QAAQ,GACR,wBAAwB,CAAC;AAE7B,MAAM,MAAM,+BAA+B,GAAG,MAAM,CAClD,+BAA+B,EAC/B,OAAO,CACR,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,uBAAuB,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,yBAAyB,CAAC;IACpC,gBAAgB,EAAE,+BAA+B,CAAC;IAClD,WAAW,EAAE,4BAA4B,CAAC;CAC3C,CAAC;AAmFF,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiNjC,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAC7B,CAAC,OAAO,8BAA8B,CAAC,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC;AAEjE,eAAO,MAAM,sBAAsB,EAE9B,SAAS,mBAAmB,EAAE,CAAC;AASpC,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,GACZ,KAAK,IAAI,mBAAmB,CAE9B;AAED,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,mBAAmB,GAC/B,CAAC,OAAO,8BAA8B,CAAC,CAAC,MAAM,CAAC,CAMjD"}

package/dist/sequence-operation-registry.js

@@ -0,0 +1,287 @@
+const TRPC_ONLY_PROJECTIONS = {
+    trpc: "direct",
+    publicApi: "none",
+    mcp: "none",
+    sdk: "none",
+    cli: "none",
+    openapi: "none",
+    docs: "none",
+};
+const PUBLIC_COMPATIBILITY_PROJECTIONS = {
+    trpc: "direct",
+    publicApi: "compatibility",
+    mcp: "none",
+    sdk: "compatibility",
+    cli: "compatibility",
+    openapi: "compatibility",
+    docs: "compatibility",
+};
+const PUBLIC_TIMING_DIRECT_PROJECTIONS = {
+    trpc: "direct",
+    publicApi: "direct",
+    mcp: "direct",
+    sdk: "direct",
+    cli: "direct",
+    openapi: "direct",
+    docs: "direct",
+};
+const PUBLIC_TIMING_PREVIEW_SUPPORT = {
+    kernel: true,
+    trpc: true,
+    publicApi: true,
+    mcp: true,
+    sdk: true,
+    cli: false,
+    openapi: true,
+    docs: true,
+};
+function defineSequenceOperation({ operationId, family, summary, destructive, exposure, projections, }) {
+    const hasDirectTimingPreview = operationId === "timeline.item.trim" ||
+        operationId === "timeline.item.split";
+    return {
+        operationId,
+        family,
+        summary,
+        destructive,
+        exposure,
+        previewSupported: hasDirectTimingPreview
+            ? PUBLIC_TIMING_PREVIEW_SUPPORT
+            : {
+                kernel: true,
+                trpc: true,
+                publicApi: false,
+                mcp: false,
+                sdk: false,
+                cli: false,
+                openapi: false,
+                docs: false,
+            },
+        projections,
+    };
+}
+export const SEQUENCE_OPERATION_DEFINITIONS = [
+    defineSequenceOperation({
+        operationId: "timeline.item.add",
+        family: "item",
+        summary: "Add a media item to a project timeline.",
+        destructive: false,
+        exposure: "public",
+        projections: PUBLIC_COMPATIBILITY_PROJECTIONS,
+    }),
+    defineSequenceOperation({
+        operationId: "timeline.item.generic.add",
+        family: "item",
+        summary: "Add a typed media, content, or group timeline item.",
+        destructive: false,
+        exposure: "internal",
+        projections: TRPC_ONLY_PROJECTIONS,
+    }),
+    defineSequenceOperation({
+        operationId: "timeline.item.commit",
+        family: "item",
+        summary: "Commit one timeline item timing or layer change.",
+        destructive: false,
+        exposure: "public",
+        projections: PUBLIC_COMPATIBILITY_PROJECTIONS,
+    }),
+    defineSequenceOperation({
+        operationId: "timeline.item.trim",
+        family: "item",
+        summary: "Trim or extend one timeline item.",
+        destructive: false,
+        exposure: "public",
+        projections: PUBLIC_TIMING_DIRECT_PROJECTIONS,
+    }),
+    defineSequenceOperation({
+        operationId: "timeline.item.split",
+        family: "item",
+        summary: "Split one timeline item at an exact sequence position.",
+        destructive: false,
+        exposure: "public",
+        projections: PUBLIC_TIMING_DIRECT_PROJECTIONS,
+    }),
+    defineSequenceOperation({
+        operationId: "timeline.item.remove",
+        family: "item",
+        summary: "Remove one timeline item and its requested linked captions.",
+        destructive: true,
+        exposure: "public",
+        projections: PUBLIC_COMPATIBILITY_PROJECTIONS,
+    }),
+    defineSequenceOperation({
+        operationId: "timeline.item.transform",
+        family: "item",
+        summary: "Change one timeline item's visual transform.",
+        destructive: false,
+        exposure: "public",
+        projections: PUBLIC_COMPATIBILITY_PROJECTIONS,
+    }),
+    defineSequenceOperation({
+        operationId: "timeline.items.commit",
+        family: "batch",
+        summary: "Commit timing, trim, layer, or state changes for timeline items.",
+        destructive: false,
+        exposure: "public",
+        projections: PUBLIC_COMPATIBILITY_PROJECTIONS,
+    }),
+    defineSequenceOperation({
+        operationId: "timeline.items.remove",
+        family: "batch",
+        summary: "Remove multiple timeline items in one sequence transaction.",
+        destructive: true,
+        exposure: "public",
+        projections: PUBLIC_COMPATIBILITY_PROJECTIONS,
+    }),
+    defineSequenceOperation({
+        operationId: "timeline.item.split.batch",
+        family: "batch",
+        summary: "Split one timeline item at multiple sequence positions.",
+        destructive: false,
+        exposure: "internal",
+        projections: TRPC_ONLY_PROJECTIONS,
+    }),
+    defineSequenceOperation({
+        operationId: "timeline.items.duplicate",
+        family: "batch",
+        summary: "Duplicate timeline items at explicit positions and layers.",
+        destructive: false,
+        exposure: "internal",
+        projections: TRPC_ONLY_PROJECTIONS,
+    }),
+    defineSequenceOperation({
+        operationId: "timeline.item.replace",
+        family: "item",
+        summary: "Replace the media asset used by one timeline item.",
+        destructive: false,
+        exposure: "internal",
+        projections: TRPC_ONLY_PROJECTIONS,
+    }),
+    defineSequenceOperation({
+        operationId: "timeline.item.audio.update",
+        family: "audio",
+        summary: "Update one timeline item's duration, volume, and fades.",
+        destructive: false,
+        exposure: "public",
+        projections: PUBLIC_COMPATIBILITY_PROJECTIONS,
+    }),
+    defineSequenceOperation({
+        operationId: "timeline.items.order",
+        family: "batch",
+        summary: "Set the stable order of timeline items.",
+        destructive: false,
+        exposure: "internal",
+        projections: TRPC_ONLY_PROJECTIONS,
+    }),
+    defineSequenceOperation({
+        operationId: "timeline.pack",
+        family: "batch",
+        summary: "Pack timeline clips in time or consolidate track layers.",
+        destructive: false,
+        exposure: "public",
+        projections: PUBLIC_COMPATIBILITY_PROJECTIONS,
+    }),
+    defineSequenceOperation({
+        operationId: "timeline.effect.add",
+        family: "effect",
+        summary: "Add a typed visual effect to the timeline.",
+        destructive: false,
+        exposure: "public",
+        projections: PUBLIC_COMPATIBILITY_PROJECTIONS,
+    }),
+    defineSequenceOperation({
+        operationId: "timeline.effect.update",
+        family: "effect",
+        summary: "Update settings for a typed visual effect.",
+        destructive: false,
+        exposure: "public",
+        projections: PUBLIC_COMPATIBILITY_PROJECTIONS,
+    }),
+    defineSequenceOperation({
+        operationId: "timeline.overlay.add",
+        family: "overlay",
+        summary: "Add an editable overlay composition to the timeline.",
+        destructive: false,
+        exposure: "public",
+        projections: PUBLIC_COMPATIBILITY_PROJECTIONS,
+    }),
+    defineSequenceOperation({
+        operationId: "timeline.overlay.update",
+        family: "overlay",
+        summary: "Update an editable overlay composition.",
+        destructive: false,
+        exposure: "public",
+        projections: PUBLIC_COMPATIBILITY_PROJECTIONS,
+    }),
+    defineSequenceOperation({
+        operationId: "timeline.overlay.remove",
+        family: "overlay",
+        summary: "Remove an editable overlay composition.",
+        destructive: true,
+        exposure: "public",
+        projections: PUBLIC_COMPATIBILITY_PROJECTIONS,
+    }),
+    defineSequenceOperation({
+        operationId: "timeline.keyframes.commit",
+        family: "keyframe",
+        summary: "Create, update, or remove timeline item keyframes atomically.",
+        destructive: false,
+        exposure: "internal",
+        projections: TRPC_ONLY_PROJECTIONS,
+    }),
+    defineSequenceOperation({
+        operationId: "timeline.crop.commit",
+        family: "crop",
+        summary: "Commit one media view crop and reconcile crop keyframes.",
+        destructive: false,
+        exposure: "internal",
+        projections: TRPC_ONLY_PROJECTIONS,
+    }),
+    defineSequenceOperation({
+        operationId: "timeline.items.nle-edit",
+        family: "nle",
+        summary: "Apply a ripple, roll, slip, slide, or snap edit.",
+        destructive: false,
+        exposure: "internal",
+        projections: TRPC_ONLY_PROJECTIONS,
+    }),
+    defineSequenceOperation({
+        operationId: "timeline.structure.edit",
+        family: "structure",
+        summary: "Group, ungroup, or reorder projected timeline tracks.",
+        destructive: true,
+        exposure: "internal",
+        projections: TRPC_ONLY_PROJECTIONS,
+    }),
+    defineSequenceOperation({
+        operationId: "timeline.recut.apply",
+        family: "recut",
+        summary: "Apply a caption, audio, or explicit cut-plan recut.",
+        destructive: true,
+        exposure: "public",
+        projections: PUBLIC_COMPATIBILITY_PROJECTIONS,
+    }),
+    defineSequenceOperation({
+        operationId: "timeline.captions.commit",
+        family: "caption",
+        summary: "Add or synchronize project caption timeline items.",
+        destructive: false,
+        exposure: "internal",
+        projections: TRPC_ONLY_PROJECTIONS,
+    }),
+];
+export const SEQUENCE_OPERATION_IDS = SEQUENCE_OPERATION_DEFINITIONS.map((definition) => definition.operationId);
+const sequenceOperationDefinitionsById = new Map(SEQUENCE_OPERATION_DEFINITIONS.map((definition) => [
+    definition.operationId,
+    definition,
+]));
+export function isSequenceOperationId(value) {
+    return sequenceOperationDefinitionsById.has(value);
+}
+export function getSequenceOperationDefinition(operationId) {
+    const definition = sequenceOperationDefinitionsById.get(operationId);
+    if (!definition) {
+        throw new Error(`Unknown sequence operation: ${operationId}`);
+    }
+    return definition;
+}
+//# sourceMappingURL=sequence-operation-registry.js.map

package/dist/sequence-operation-registry.js.map

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

package/dist/sequence-timing-contract.d.ts

@@ -0,0 +1,70 @@
+export type SequenceTimingOperation = {
+    operation_id: "timeline.item.trim";
+    timeline_item_id: string;
+    trim_start_delta_seconds: number;
+    trim_end_delta_seconds: number;
+    snap_to_frame: boolean;
+} | {
+    operation_id: "timeline.item.split";
+    timeline_item_id: string;
+    split_at_seconds: number;
+    snap_to_frame: boolean;
+};
+export type SequenceTimingExecuteOptions = {
+    projectId: string;
+    operation: SequenceTimingOperation;
+    expectedRevision: number | null;
+    idempotencyKey: string;
+};
+export type SequenceTimingPreviewOptions = {
+    projectId: string;
+    operation: SequenceTimingOperation;
+    expectedRevision: number | null;
+};
+type SequenceTimingReceiptBase = {
+    success: true;
+    project_id: string;
+    mutation_receipt_id: string;
+    idempotency_key: string;
+    base_revision: number;
+    revision: number;
+    replayed: boolean;
+    txid: number;
+    affected_timeline_item_ids: string[];
+    created_timeline_item_ids: string[];
+    deleted_timeline_item_ids: string[];
+    warnings: string[];
+};
+export type SequenceTimingExecuteResult = (SequenceTimingReceiptBase & {
+    operation_id: "timeline.item.trim";
+    result: {
+        timeline_item_id: string;
+        trim_start_units: string;
+        trim_end_units: string;
+        trim_start_seconds: number;
+        trim_end_seconds: number;
+        message: string;
+    };
+}) | (SequenceTimingReceiptBase & {
+    operation_id: "timeline.item.split";
+    result: {
+        left_timeline_item_id: string;
+        right_timeline_item_id: string;
+        split_at_units: string;
+        split_at_seconds: number;
+    };
+});
+export type SequenceTimingPreviewResult = {
+    operation_id: SequenceTimingOperation["operation_id"];
+    project_id: string;
+    current_revision: number;
+    expected_revision: number | null;
+    destructive: boolean;
+    affected_timeline_item_ids: string[];
+    would_create_timeline_item_ids: string[];
+    would_delete_timeline_item_ids: string[];
+    change_count: number;
+    warnings: string[];
+};
+export {};
+//# sourceMappingURL=sequence-timing-contract.d.ts.map

package/dist/sequence-timing-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequence-timing-contract.d.ts","sourceRoot":"","sources":["../src/sequence-timing-contract.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,uBAAuB,GAC/B;IACE,YAAY,EAAE,oBAAoB,CAAC;IACnC,gBAAgB,EAAE,MAAM,CAAC;IACzB,wBAAwB,EAAE,MAAM,CAAC;IACjC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,aAAa,EAAE,OAAO,CAAC;CACxB,GACD;IACE,YAAY,EAAE,qBAAqB,CAAC;IACpC,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,OAAO,CAAC;CACxB,CAAC;AAEN,MAAM,MAAM,4BAA4B,GAAG;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,uBAAuB,CAAC;IACnC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,uBAAuB,CAAC;IACnC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,CAAC;AAEF,KAAK,yBAAyB,GAAG;IAC/B,OAAO,EAAE,IAAI,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B,EAAE,MAAM,EAAE,CAAC;IACrC,yBAAyB,EAAE,MAAM,EAAE,CAAC;IACpC,yBAAyB,EAAE,MAAM,EAAE,CAAC;IACpC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GACnC,CAAC,yBAAyB,GAAG;IAC3B,YAAY,EAAE,oBAAoB,CAAC;IACnC,MAAM,EAAE;QACN,gBAAgB,EAAE,MAAM,CAAC;QACzB,gBAAgB,EAAE,MAAM,CAAC;QACzB,cAAc,EAAE,MAAM,CAAC;QACvB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,gBAAgB,EAAE,MAAM,CAAC;QACzB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH,CAAC,GACF,CAAC,yBAAyB,GAAG;IAC3B,YAAY,EAAE,qBAAqB,CAAC;IACpC,MAAM,EAAE;QACN,qBAAqB,EAAE,MAAM,CAAC;QAC9B,sBAAsB,EAAE,MAAM,CAAC;QAC/B,cAAc,EAAE,MAAM,CAAC;QACvB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH,CAAC,CAAC;AAEP,MAAM,MAAM,2BAA2B,GAAG;IACxC,YAAY,EAAE,uBAAuB,CAAC,cAAc,CAAC,CAAC;IACtD,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,WAAW,EAAE,OAAO,CAAC;IACrB,0BAA0B,EAAE,MAAM,EAAE,CAAC;IACrC,8BAA8B,EAAE,MAAM,EAAE,CAAC;IACzC,8BAA8B,EAAE,MAAM,EAAE,CAAC;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC"}

package/dist/sequence-timing-contract.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sequence-timing-contract.js.map

package/dist/sequence-timing-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequence-timing-contract.js","sourceRoot":"","sources":["../src/sequence-timing-contract.ts"],"names":[],"mappings":""}

package/dist/timeline-batch-contract.d.ts

@@ -0,0 +1,58 @@
+import type { SequenceOperationItemFailure } from "./error-contract.js";
+export type TimelineBatchMoveResult = {
+    success: boolean;
+    repositioned_count: number;
+    failed_count: number;
+    items: Array<{
+        timeline_item_id: string;
+        previous_start_seconds: number;
+        new_start_seconds: number;
+        previous_layer_index: number;
+        new_layer_index: number;
+    }>;
+    failed_items: SequenceOperationItemFailure[];
+    message?: string;
+};
+export type TimelineBatchTrimResult = {
+    success: boolean;
+    trimmed_count: number;
+    failed_count: number;
+    items: Array<{
+        timeline_item_id: string;
+        success: boolean;
+        trim_start_seconds: number | null;
+        trim_end_seconds: number | null;
+        new_duration_seconds: number | null;
+        error: string | null;
+    }>;
+    failed_items: SequenceOperationItemFailure[];
+    message?: string;
+};
+export type TimelineBatchTransformResult = {
+    success: boolean;
+    updated_count: number;
+    failed_count: number;
+    items: Array<{
+        timeline_item_id: string;
+        success: boolean;
+        error: string | null;
+    }>;
+    failed_items: SequenceOperationItemFailure[];
+    message?: string;
+};
+export type TimelineBatchDeleteResult = {
+    success: boolean;
+    deleted_count: number;
+    failed_count: number;
+    deleted_items: Array<{
+        id: string;
+        name: string;
+        type: string;
+    }>;
+    failed_items: SequenceOperationItemFailure[];
+    captions_removed: number;
+    packed: boolean;
+    clips_shifted: number;
+    message?: string;
+};
+//# sourceMappingURL=timeline-batch-contract.d.ts.map

package/dist/timeline-batch-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-batch-contract.d.ts","sourceRoot":"","sources":["../src/timeline-batch-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AAExE,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,KAAK,CAAC;QACX,gBAAgB,EAAE,MAAM,CAAC;QACzB,sBAAsB,EAAE,MAAM,CAAC;QAC/B,iBAAiB,EAAE,MAAM,CAAC;QAC1B,oBAAoB,EAAE,MAAM,CAAC;QAC7B,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC,CAAC;IACH,YAAY,EAAE,4BAA4B,EAAE,CAAC;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,KAAK,CAAC;QACX,gBAAgB,EAAE,MAAM,CAAC;QACzB,OAAO,EAAE,OAAO,CAAC;QACjB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;QAClC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;QAChC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;QACpC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;KACtB,CAAC,CAAC;IACH,YAAY,EAAE,4BAA4B,EAAE,CAAC;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,KAAK,CAAC;QACX,gBAAgB,EAAE,MAAM,CAAC;QACzB,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;KACtB,CAAC,CAAC;IACH,YAAY,EAAE,4BAA4B,EAAE,CAAC;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,KAAK,CAAC;QACnB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,YAAY,EAAE,4BAA4B,EAAE,CAAC;IAC7C,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC"}

package/dist/timeline-batch-contract.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=timeline-batch-contract.js.map

package/dist/timeline-batch-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-batch-contract.js","sourceRoot":"","sources":["../src/timeline-batch-contract.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@blitzreels/contracts",
+  "version": "0.1.0",
+  "description": "Transport-independent factual contracts for BlitzReels editing operations.",
+  "homepage": "https://blitzreels.com/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/blitzreels/blitzreels.git",
+    "directory": "packages/contracts"
+  },
+  "bugs": {
+    "url": "https://github.com/blitzreels/blitzreels/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}