@rolino/contracts 0.7.1 → 0.9.0

package/dist/index.js

@@ -1,7 +1,7 @@
 // src/index.ts
 import { z } from "zod";
 var API_VERSION = "v1";
-var CONTRACT_VERSION = "0.18.0";
+var CONTRACT_VERSION = "0.20.0";
 var RequestMetadataSchema = z.object({
   requestId: z.string().min(1)
 });
@@ -92,6 +92,8 @@ var CapabilityIdSchema = z.enum([
   "posts:write",
   "posts:schedule",
   "posts:publish",
+  "storage:read",
+  "media:delete",
   "integrations:read",
   "calendar:read",
   "seo:read",
@@ -792,22 +794,49 @@ var MediaAssetSchema = z.object({
   width: z.number().int().positive().nullable(),
   height: z.number().int().positive().nullable(),
   durationMs: z.number().int().nonnegative().nullable(),
-  createdAt: z.string().datetime()
+  createdAt: z.string().datetime(),
+  usageCount: z.number().int().nonnegative().optional(),
+  deletable: z.boolean().optional(),
+  blockedReason: z.enum(["IN_USE"]).nullable().optional(),
+  projectId: z.string().min(1).optional(),
+  projectName: z.string().min(1).max(200).optional()
+});
+var ListedMediaAssetSchema = MediaAssetSchema.extend({
+  usageCount: z.number().int().nonnegative(),
+  deletable: z.boolean(),
+  blockedReason: z.enum(["IN_USE"]).nullable()
+});
+var WorkspaceListedMediaAssetSchema = ListedMediaAssetSchema.extend({
+  projectId: z.string().min(1),
+  projectName: z.string().min(1).max(200)
 });
+var OptionalBooleanQuerySchema = z.union([
+  z.boolean(),
+  z.enum(["true", "false"]).transform((value) => value === "true")
+]);
 var MediaAssetListQuerySchema = z.object({
   limit: z.coerce.number().int().min(1).max(100).default(50),
-  cursor: z.string().min(1).optional(),
+  cursor: z.string().min(1).max(2048).optional(),
   type: z.enum(["IMAGE", "VIDEO"]).optional(),
-  query: z.string().trim().min(1).max(100).optional()
+  query: z.string().trim().min(1).max(100).optional(),
+  createdBefore: z.string().datetime({ offset: true }).optional(),
+  createdAfter: z.string().datetime({ offset: true }).optional(),
+  unusedOnly: OptionalBooleanQuerySchema.optional(),
+  order: z.enum(["OLDEST_FIRST", "NEWEST_FIRST"]).default("NEWEST_FIRST")
 });
+var WorkspaceMediaAssetListQuerySchema = MediaAssetListQuerySchema;
 var MediaAssetListDataSchema = z.object({
-  items: z.array(MediaAssetSchema),
+  items: z.array(ListedMediaAssetSchema),
   page: z.object({
     limit: z.number().int().min(1).max(100),
     nextCursor: z.string().min(1).nullable()
   })
 });
 var MediaAssetListResponseSchema = successEnvelopeSchema(MediaAssetListDataSchema);
+var WorkspaceMediaAssetListDataSchema = MediaAssetListDataSchema.extend({
+  items: z.array(WorkspaceListedMediaAssetSchema)
+});
+var WorkspaceMediaAssetListResponseSchema = successEnvelopeSchema(WorkspaceMediaAssetListDataSchema);
 var MediaAssetUploadInputSchema = z.object({
   fileName: z.string().trim().min(1).max(255),
   contentType: z.string().trim().min(1).max(100),
@@ -828,6 +857,166 @@ var MediaAssetUploadCompleteInputSchema = MediaAssetUploadInputSchema.extend({
   durationMs: z.number().int().nonnegative().max(864e5).nullable().optional()
 }).strict();
 var MediaAssetResponseSchema = successEnvelopeSchema(MediaAssetSchema);
+var StorageByteCountSchema = z.number().int().nonnegative().max(Number.MAX_SAFE_INTEGER);
+var StorageSourceBreakdownSchema = z.object({
+  mediaLibraryOriginalBytes: StorageByteCountSchema,
+  transformedSocialMediaBytes: StorageByteCountSchema,
+  blogImageBytes: StorageByteCountSchema,
+  detachedPendingDeletionBytes: StorageByteCountSchema
+});
+var StorageUsageSchema = z.object({
+  storedBytes: StorageByteCountSchema,
+  reservedUploadBytes: StorageByteCountSchema,
+  uploadCommittedBytes: StorageByteCountSchema,
+  limitBytes: StorageByteCountSchema.nullable(),
+  availableUploadBytes: StorageByteCountSchema.nullable(),
+  storedPercent: z.number().finite().nonnegative().nullable(),
+  uploadCommittedPercent: z.number().finite().nonnegative().nullable(),
+  unlimited: z.boolean(),
+  pendingDeletionBytes: StorageByteCountSchema,
+  sources: StorageSourceBreakdownSchema,
+  measuredAt: z.string().datetime()
+});
+var StorageUsageResponseSchema = successEnvelopeSchema(StorageUsageSchema);
+var MediaCleanupScopeSchema = z.discriminatedUnion("type", [
+  z.object({ type: z.literal("PROJECT"), projectId: z.string().min(1).max(200) }).strict(),
+  z.object({ type: z.literal("WORKSPACE") }).strict()
+]);
+var MediaCleanupAssetIdsSchema = z.array(z.string().min(1).max(200)).min(1).max(100).superRefine((ids, context) => {
+  if (new Set(ids).size !== ids.length) {
+    context.addIssue({ code: "custom", message: "Asset IDs must be unique." });
+  }
+});
+var MediaCleanupSelectionInputSchema = z.discriminatedUnion("mode", [
+  z.object({
+    mode: z.literal("ASSET_IDS"),
+    scope: MediaCleanupScopeSchema,
+    assetIds: MediaCleanupAssetIdsSchema
+  }).strict(),
+  z.object({
+    mode: z.literal("FILTER"),
+    scope: MediaCleanupScopeSchema,
+    createdBefore: z.string().datetime({ offset: true }).optional(),
+    olderThanDays: z.number().int().min(1).max(3650).optional(),
+    type: z.enum(["IMAGE", "VIDEO"]).optional(),
+    query: z.string().trim().min(1).max(100).optional()
+  }).strict().superRefine((selection, context) => {
+    if (Number(Boolean(selection.createdBefore)) + Number(selection.olderThanDays !== void 0) !== 1) {
+      context.addIssue({ code: "custom", message: "Choose exactly one upload-age filter." });
+    }
+  })
+]);
+var NormalizedMediaCleanupSelectionSchema = z.discriminatedUnion("mode", [
+  z.object({
+    mode: z.literal("ASSET_IDS"),
+    scope: MediaCleanupScopeSchema,
+    assetIds: MediaCleanupAssetIdsSchema
+  }).strict(),
+  z.object({
+    mode: z.literal("FILTER"),
+    scope: MediaCleanupScopeSchema,
+    createdBefore: z.string().datetime({ offset: true }),
+    type: z.enum(["IMAGE", "VIDEO"]).optional(),
+    query: z.string().trim().min(1).max(100).optional()
+  }).strict()
+]);
+var MediaCleanupPreviewRequestSchema = z.object({
+  selection: MediaCleanupSelectionInputSchema
+}).strict();
+var MediaCleanupCandidateSchema = z.object({
+  id: z.string().min(1),
+  fileName: z.string().min(1).max(255).nullable(),
+  projectId: z.string().min(1),
+  projectName: z.string().min(1).max(200),
+  type: z.enum(["IMAGE", "VIDEO"]),
+  createdAt: z.string().datetime(),
+  sizeBytes: StorageByteCountSchema.nullable()
+});
+var MediaCleanupPreviewSchema = z.object({
+  selection: NormalizedMediaCleanupSelectionSchema,
+  cutoffAt: z.string().datetime().nullable(),
+  candidateCount: z.number().int().min(0).max(500),
+  candidateIds: z.array(z.string().min(1)).max(500),
+  candidates: z.array(MediaCleanupCandidateSchema).max(500),
+  estimatedReclaimableBytes: StorageByteCountSchema,
+  excludedInUseCount: z.number().int().min(0).max(Number.MAX_SAFE_INTEGER),
+  excludedInUseBytes: StorageByteCountSchema,
+  unknownSizeCount: z.number().int().min(0).max(500),
+  hasMore: z.boolean(),
+  candidateDigest: z.string().regex(/^[a-f0-9]{64}$/),
+  confirmation: z.object({
+    token: z.string().min(1).max(500),
+    expiresAt: z.string().datetime()
+  })
+});
+var MediaCleanupPreviewResponseSchema = successEnvelopeSchema(MediaCleanupPreviewSchema);
+var MediaCleanupExecuteRequestSchema = z.object({
+  selection: NormalizedMediaCleanupSelectionSchema,
+  candidateDigest: z.string().regex(/^[a-f0-9]{64}$/),
+  confirmationToken: z.string().min(1).max(500)
+}).strict();
+var MediaCleanupOperationStatusSchema = z.enum([
+  "QUEUED",
+  "RUNNING",
+  "COMPLETED",
+  "COMPLETED_WITH_SKIPS"
+]);
+var MediaCleanupItemStatusSchema = z.enum([
+  "QUEUED",
+  "RETRYING",
+  "SKIPPED_IN_USE",
+  "SKIPPED_CHANGED",
+  "DELETED"
+]);
+var MediaCleanupExecuteResultSchema = z.object({
+  cleanupId: z.string().min(1),
+  status: MediaCleanupOperationStatusSchema,
+  candidateCount: z.number().int().min(0).max(500),
+  queuedCount: z.number().int().min(0).max(500),
+  skippedCount: z.number().int().min(0).max(500),
+  estimatedReclaimableBytes: StorageByteCountSchema
+});
+var MediaCleanupExecuteResponseSchema = successEnvelopeSchema(MediaCleanupExecuteResultSchema);
+var MediaCleanupStatusQuerySchema = z.object({
+  limit: z.coerce.number().int().min(1).max(100).default(50),
+  cursor: z.string().min(1).max(2048).optional()
+});
+var MediaCleanupItemResultSchema = z.object({
+  id: z.string().min(1),
+  assetId: z.string().min(1),
+  fileName: z.string().min(1).max(255).nullable(),
+  projectId: z.string().min(1),
+  projectName: z.string().min(1).max(200),
+  type: z.enum(["IMAGE", "VIDEO"]),
+  sizeBytes: StorageByteCountSchema.nullable(),
+  status: MediaCleanupItemStatusSchema,
+  queuedAt: z.string().datetime().nullable(),
+  retryingAt: z.string().datetime().nullable(),
+  skippedAt: z.string().datetime().nullable(),
+  deletedAt: z.string().datetime().nullable(),
+  failureSummary: z.string().min(1).max(500).nullable()
+});
+var MediaCleanupStatusSchema = z.object({
+  cleanupId: z.string().min(1),
+  status: MediaCleanupOperationStatusSchema,
+  candidateCount: z.number().int().min(0).max(500),
+  queuedCount: z.number().int().min(0).max(500),
+  retryingCount: z.number().int().min(0).max(500),
+  skippedCount: z.number().int().min(0).max(500),
+  deletedCount: z.number().int().min(0).max(500),
+  unknownSizeCount: z.number().int().min(0).max(500),
+  estimatedReclaimableBytes: StorageByteCountSchema,
+  actualReleasedBytes: StorageByteCountSchema,
+  createdAt: z.string().datetime(),
+  startedAt: z.string().datetime().nullable(),
+  completedAt: z.string().datetime().nullable(),
+  items: z.array(MediaCleanupItemResultSchema).max(100),
+  page: z.object({
+    limit: z.number().int().min(1).max(100),
+    nextCursor: z.string().min(1).max(2048).nullable()
+  })
+});
+var MediaCleanupStatusResponseSchema = successEnvelopeSchema(MediaCleanupStatusSchema);
 var PublishingProviderSchema = z.enum([
   "INSTAGRAM",
   "TIKTOK",
@@ -859,6 +1048,9 @@ var PostDestinationSchema = z.object({
   scheduledAt: z.string().datetime().nullable(),
   publishedAt: z.string().datetime().nullable(),
   remoteUrl: z.string().url().nullable(),
+  remotePostId: z.string().nullable().optional(),
+  remoteContainerId: z.string().nullable().optional(),
+  studioUrl: z.string().url().nullable().optional(),
   attemptCount: z.number().int().nonnegative()
 });
 var TikTokPostSettingsSchema = z.object({
@@ -1801,6 +1993,61 @@ var BacklinkContactSchema = z.object({
 var BacklinkContactListDataSchema = z.object({ items: z.array(BacklinkContactSchema).max(50), page: z.object({ limit: z.number().int().min(1).max(50), nextCursor: SeoCursorSchema.nullable() }).strict() }).strict();
 var BacklinkContactListQuerySchema = z.object({ limit: z.coerce.number().int().min(1).max(50).default(20), cursor: SeoCursorSchema.optional() }).strict();
 var BacklinkContactListResponseSchema = successEnvelopeSchema(BacklinkContactListDataSchema);
+var PostDeliveryCheckInputSchema = z.object({ provider: PublishingProviderSchema }).strict();
+var PostDeliveryCheckResultSchema = z.object({
+  postId: z.string().min(1),
+  provider: PublishingProviderSchema,
+  kind: z.enum(["PUBLISHED", "SCHEDULED", "PROCESSING", "ACTION_REQUIRED", "UNKNOWN", "BUSY"]),
+  message: z.string(),
+  version: z.number().int().positive(),
+  remotePostId: z.string().nullable(),
+  remoteContainerId: z.string().nullable(),
+  studioUrl: z.string().url().nullable()
+});
+var PostDeliveryCheckResponseSchema = successEnvelopeSchema(PostDeliveryCheckResultSchema);
+var PostRecoveryInputSchema = z.object({
+  provider: z.literal("YOUTUBE"),
+  action: z.enum(["ATTACH", "RESUME"]),
+  videoId: z.string().regex(/^[\w-]{11}$/),
+  publishAt: z.string().datetime({ offset: true }).nullable().optional()
+}).strict().superRefine((input, context) => {
+  if (input.action === "RESUME" && input.publishAt === void 0) {
+    context.addIssue({ code: "custom", path: ["publishAt"], message: "RESUME requires a future time or explicit null to publish now." });
+  }
+  if (input.action === "ATTACH" && input.publishAt !== void 0) {
+    context.addIssue({ code: "custom", path: ["publishAt"], message: "Attachment cannot change publication time." });
+  }
+});
+var PostRecoveryExecuteInputSchema = PostRecoveryInputSchema.safeExtend({
+  confirmationToken: z.string().trim().min(1).max(200)
+});
+var PostRecoveryPreviewSchema = z.object({
+  operation: z.literal("posts.recovery.execute"),
+  projectId: z.string().min(1),
+  postId: z.string().min(1),
+  provider: z.literal("YOUTUBE"),
+  action: z.enum(["ATTACH", "RESUME"]),
+  videoId: z.string(),
+  publishAt: z.string().datetime({ offset: true }).nullable().optional(),
+  version: z.number().int().positive(),
+  title: z.string(),
+  description: z.string(),
+  channel: z.string().nullable(),
+  accountId: z.string(),
+  privacy: z.string(),
+  consequence: z.string(),
+  confirmation: z.object({ token: z.string().min(1), expiresAt: z.string().datetime() })
+});
+var PostRecoveryPreviewResponseSchema = successEnvelopeSchema(PostRecoveryPreviewSchema);
+var PostRecoveryResultSchema = z.object({
+  postId: z.string().min(1),
+  provider: z.literal("YOUTUBE"),
+  action: z.enum(["ATTACH", "RESUME"]),
+  videoId: z.string(),
+  kind: z.enum(["ATTACHED", "QUEUED", "PUBLISHED"]),
+  version: z.number().int().positive()
+});
+var PostRecoveryResponseSchema = successEnvelopeSchema(PostRecoveryResultSchema);
 export {
   AGENT_CAPABILITIES,
   API_VERSION,
@@ -1964,6 +2211,7 @@ export {
   IntegrationHealthListResponseSchema,
   IntegrationHealthSchema,
   LinkedInDeliveryOptionsSchema,
+  ListedMediaAssetSchema,
   MediaAssetListDataSchema,
   MediaAssetListQuerySchema,
   MediaAssetListResponseSchema,
@@ -1973,8 +2221,27 @@ export {
   MediaAssetUploadInputSchema,
   MediaAssetUploadPreparationResponseSchema,
   MediaAssetUploadPreparationSchema,
+  MediaCleanupCandidateSchema,
+  MediaCleanupExecuteRequestSchema,
+  MediaCleanupExecuteResponseSchema,
+  MediaCleanupExecuteResultSchema,
+  MediaCleanupItemResultSchema,
+  MediaCleanupItemStatusSchema,
+  MediaCleanupOperationStatusSchema,
+  MediaCleanupPreviewRequestSchema,
+  MediaCleanupPreviewResponseSchema,
+  MediaCleanupPreviewSchema,
+  MediaCleanupScopeSchema,
+  MediaCleanupSelectionInputSchema,
+  MediaCleanupStatusQuerySchema,
+  MediaCleanupStatusResponseSchema,
+  MediaCleanupStatusSchema,
+  NormalizedMediaCleanupSelectionSchema,
   PUBLISHING_PROVIDER_COUNT,
   PlatformPostStatusSchema,
+  PostDeliveryCheckInputSchema,
+  PostDeliveryCheckResponseSchema,
+  PostDeliveryCheckResultSchema,
   PostDeliveryModeSchema,
   PostDestinationSchema,
   PostDestinationStageSchema,
@@ -1990,6 +2257,12 @@ export {
   PostReadinessCheckSchema,
   PostReadinessResponseSchema,
   PostReadinessSchema,
+  PostRecoveryExecuteInputSchema,
+  PostRecoveryInputSchema,
+  PostRecoveryPreviewResponseSchema,
+  PostRecoveryPreviewSchema,
+  PostRecoveryResponseSchema,
+  PostRecoveryResultSchema,
   PostResponseSchema,
   PostScheduleExecuteInputSchema,
   PostScheduleExecuteResponseSchema,
@@ -2045,10 +2318,18 @@ export {
   SeoSearchIntentSchema,
   SeoTaskDecisionSchema,
   SeoTaskFormatSchema,
+  StorageByteCountSchema,
+  StorageSourceBreakdownSchema,
+  StorageUsageResponseSchema,
+  StorageUsageSchema,
   TikTokDeliveryOptionsSchema,
   TikTokDraftSettingsSchema,
   TikTokPostSettingsSchema,
   WhoAmIResponseSchema,
+  WorkspaceListedMediaAssetSchema,
+  WorkspaceMediaAssetListDataSchema,
+  WorkspaceMediaAssetListQuerySchema,
+  WorkspaceMediaAssetListResponseSchema,
   YouTubePostSettingsSchema,
   successEnvelopeSchema
 };