@sylphx/contract 0.2.0

package/dist/schemas/storage.d.ts

@@ -0,0 +1,257 @@
+/**
+ * Storage — BaaS plane file upload / download. Uses presigned URLs per AWS
+ * S3 convention. Mirrors `@sylphx/sdk/storage.ts`.
+ *
+ * Shape policy (ADR-084 Wave 2d): schemas here are the UNION superset of
+ * all production SDK / OpenAPI-generated wire shapes. Any field that is not
+ * universally present on the wire is `optional`, so contract consumers
+ * never have to narrow to parse a legitimate server response. When the
+ * server response narrows in future, tighten the optional in a dedicated
+ * wave — never break existing callers by removing a field.
+ */
+import { Schema } from 'effect';
+export declare const FileId: Schema.brand<typeof Schema.String, "FileId">;
+export type FileId = typeof FileId.Type;
+/**
+ * File metadata superset — reconciles three historical shapes:
+ *
+ * - SDK `FileInfo` interface: `{ id, url, name, size, contentType,
+ *   isPrivate, createdAt }`
+ * - Generated OpenAPI `FileInfo` / `GetFileResponse`: `{ id, filename,
+ *   path, url, mimeType, size, metadata, createdAt }`
+ * - Previous contract shape: `{ id, key, size, contentType, url?,
+ *   uploadedAt }`
+ *
+ * Every historical field is preserved as optional so older and newer
+ * clients can both parse server responses. `id` and `size` are the only
+ * guaranteed-present fields across all three shapes.
+ */
+export declare const FileInfo: Schema.Struct<{
+    id: typeof Schema.String;
+    size: typeof Schema.Number;
+    /** SDK-native filename (preferred). Alias of `filename` on newer servers. */
+    name: Schema.optional<typeof Schema.String>;
+    /** OpenAPI-native filename. Alias of `name` on older servers. */
+    filename: Schema.optional<typeof Schema.String>;
+    /** Folder path or storage key. */
+    path: Schema.optional<typeof Schema.String>;
+    /** Legacy storage object key (contract v1). */
+    key: Schema.optional<typeof Schema.String>;
+    /** Public URL — null for private files, absent on some delete responses. */
+    url: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+    /** SDK-native MIME type. */
+    contentType: Schema.optional<typeof Schema.String>;
+    /** OpenAPI-native MIME type (alias of `contentType`). */
+    mimeType: Schema.optional<typeof Schema.String>;
+    /** Private/public visibility flag. Absent => treat as public. */
+    isPrivate: Schema.optional<typeof Schema.Boolean>;
+    /** Arbitrary caller-attached metadata. */
+    metadata: Schema.optional<Schema.NullOr<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>>;
+    /** SDK-native creation timestamp (ISO string). */
+    createdAt: Schema.optional<typeof Schema.String>;
+    /** Legacy contract v1 upload timestamp (alias of createdAt). */
+    uploadedAt: Schema.optional<typeof Schema.String>;
+}>;
+export type FileInfo = typeof FileInfo.Type;
+/**
+ * Input for the richer `/storage/upload` token flow used by the SDK for
+ * client-direct uploads (Vercel Blob pattern). Server mints an upload
+ * endpoint + client payload, and the SDK performs the actual PUT against
+ * storage. Superset of `UploadUrlInput`.
+ */
+export declare const UploadTokenInput: Schema.Struct<{
+    filename: typeof Schema.String;
+    contentType: Schema.optional<typeof Schema.String>;
+    size: Schema.optional<typeof Schema.Number>;
+    /** Folder path for organizing the file. */
+    path: Schema.optional<typeof Schema.String>;
+    /** `file` | `avatar` — avatars apply user-scoped policy. */
+    type: Schema.optional<Schema.Literal<["file", "avatar"]>>;
+    /** User ID (required for `type: 'avatar'`). */
+    userId: Schema.optional<typeof Schema.String>;
+    /** Arbitrary caller-attached metadata persisted alongside the blob. */
+    metadata: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+}>;
+export type UploadTokenInput = typeof UploadTokenInput.Type;
+/**
+ * Upload token response. Supports both the simple `{ uploadUrl, publicUrl,
+ * fileId, expiresAt }` shape and the richer Vercel-Blob-style
+ * `{ uploadEndpoint, clientPayload, instructions, ... }` shape.
+ */
+export declare const UploadTokenResult: Schema.Struct<{
+    uploadUrl: Schema.optional<typeof Schema.String>;
+    publicUrl: Schema.optional<typeof Schema.String>;
+    fileId: Schema.optional<typeof Schema.String>;
+    expiresAt: Schema.optional<typeof Schema.String>;
+    uploadEndpoint: Schema.optional<typeof Schema.String>;
+    clientPayload: Schema.optional<typeof Schema.String>;
+    maxSize: Schema.optional<typeof Schema.Number>;
+    maxMultipartSize: Schema.optional<typeof Schema.Number>;
+    multipartThreshold: Schema.optional<typeof Schema.Number>;
+    allowedContentTypes: Schema.optional<Schema.Array$<typeof Schema.String>>;
+    instructions: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+}>;
+export type UploadTokenResult = typeof UploadTokenResult.Type;
+export declare const UploadUrlInput: Schema.Struct<{
+    filename: typeof Schema.String;
+    contentType: typeof Schema.String;
+    size: Schema.optional<typeof Schema.Number>;
+}>;
+export type UploadUrlInput = typeof UploadUrlInput.Type;
+export declare const UploadUrlResult: Schema.Struct<{
+    uploadUrl: typeof Schema.String;
+    fileId: typeof Schema.String;
+    expiresAt: typeof Schema.String;
+}>;
+export type UploadUrlResult = typeof UploadUrlResult.Type;
+export declare const ListFilesQuery: Schema.Struct<{
+    prefix: Schema.optional<typeof Schema.String>;
+    limit: Schema.optional<typeof Schema.String>;
+    cursor: Schema.optional<typeof Schema.String>;
+}>;
+export type ListFilesQuery = typeof ListFilesQuery.Type;
+export declare const ListFilesResult: Schema.Struct<{
+    files: Schema.Array$<Schema.Struct<{
+        id: typeof Schema.String;
+        size: typeof Schema.Number;
+        /** SDK-native filename (preferred). Alias of `filename` on newer servers. */
+        name: Schema.optional<typeof Schema.String>;
+        /** OpenAPI-native filename. Alias of `name` on older servers. */
+        filename: Schema.optional<typeof Schema.String>;
+        /** Folder path or storage key. */
+        path: Schema.optional<typeof Schema.String>;
+        /** Legacy storage object key (contract v1). */
+        key: Schema.optional<typeof Schema.String>;
+        /** Public URL — null for private files, absent on some delete responses. */
+        url: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        /** SDK-native MIME type. */
+        contentType: Schema.optional<typeof Schema.String>;
+        /** OpenAPI-native MIME type (alias of `contentType`). */
+        mimeType: Schema.optional<typeof Schema.String>;
+        /** Private/public visibility flag. Absent => treat as public. */
+        isPrivate: Schema.optional<typeof Schema.Boolean>;
+        /** Arbitrary caller-attached metadata. */
+        metadata: Schema.optional<Schema.NullOr<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>>;
+        /** SDK-native creation timestamp (ISO string). */
+        createdAt: Schema.optional<typeof Schema.String>;
+        /** Legacy contract v1 upload timestamp (alias of createdAt). */
+        uploadedAt: Schema.optional<typeof Schema.String>;
+    }>>;
+    nextCursor: Schema.NullOr<typeof Schema.String>;
+    /** True if there are more files beyond this page. */
+    hasMore: Schema.optional<typeof Schema.Boolean>;
+}>;
+export type ListFilesResult = typeof ListFilesResult.Type;
+export declare const DeleteFileResult: Schema.Struct<{
+    success: typeof Schema.Boolean;
+}>;
+export type DeleteFileResult = typeof DeleteFileResult.Type;
+/**
+ * Signed download URL input. Returns a short-lived URL for private files
+ * without exposing permanent credentials.
+ */
+export declare const SignedUrlInput: Schema.Struct<{
+    fileId: typeof Schema.String;
+    /** Seconds until the URL expires (default: 3600, max: 604800 = 7 days). */
+    expiresIn: Schema.optional<typeof Schema.Number>;
+    /** `attachment` forces download, `inline` displays in browser. */
+    disposition: Schema.optional<Schema.Literal<["attachment", "inline"]>>;
+    /** Restrict URL access to a specific user. */
+    userId: Schema.optional<typeof Schema.String>;
+}>;
+export type SignedUrlInput = typeof SignedUrlInput.Type;
+export declare const SignedUrlResult: Schema.Struct<{
+    url: typeof Schema.String;
+    expiresAt: typeof Schema.String;
+    file: Schema.Struct<{
+        id: typeof Schema.String;
+        filename: typeof Schema.String;
+        mimeType: typeof Schema.String;
+        sizeBytes: typeof Schema.Number;
+        isPrivate: typeof Schema.Boolean;
+    }>;
+}>;
+export type SignedUrlResult = typeof SignedUrlResult.Type;
+/**
+ * A single version of a file. Append-only per-file history — every
+ * upload creates one row with a monotonic `versionNumber`. Restore
+ * creates a NEW version row pointing at the old object (never mutates
+ * history).
+ */
+export declare const StorageFileVersion: Schema.Struct<{
+    id: typeof Schema.String;
+    fileId: typeof Schema.String;
+    versionNumber: typeof Schema.Number;
+    sizeBytes: typeof Schema.Number;
+    contentType: Schema.NullOr<typeof Schema.String>;
+    checksumSha256: Schema.NullOr<typeof Schema.String>;
+    createdAt: typeof Schema.String;
+    createdBy: Schema.NullOr<typeof Schema.String>;
+    isCurrent: typeof Schema.Boolean;
+}>;
+export type StorageFileVersion = typeof StorageFileVersion.Type;
+export declare const ListFileVersionsResult: Schema.Struct<{
+    versions: Schema.Array$<Schema.Struct<{
+        id: typeof Schema.String;
+        fileId: typeof Schema.String;
+        versionNumber: typeof Schema.Number;
+        sizeBytes: typeof Schema.Number;
+        contentType: Schema.NullOr<typeof Schema.String>;
+        checksumSha256: Schema.NullOr<typeof Schema.String>;
+        createdAt: typeof Schema.String;
+        createdBy: Schema.NullOr<typeof Schema.String>;
+        isCurrent: typeof Schema.Boolean;
+    }>>;
+}>;
+export type ListFileVersionsResult = typeof ListFileVersionsResult.Type;
+export declare const RestoreVersionResult: Schema.Struct<{
+    success: Schema.Literal<[true]>;
+    version: Schema.Struct<{
+        id: typeof Schema.String;
+        fileId: typeof Schema.String;
+        versionNumber: typeof Schema.Number;
+        sizeBytes: typeof Schema.Number;
+        contentType: Schema.NullOr<typeof Schema.String>;
+        checksumSha256: Schema.NullOr<typeof Schema.String>;
+        createdAt: typeof Schema.String;
+        createdBy: Schema.NullOr<typeof Schema.String>;
+        isCurrent: typeof Schema.Boolean;
+    }>;
+}>;
+export type RestoreVersionResult = typeof RestoreVersionResult.Type;
+export declare const SoftDeleteFileResult: Schema.Struct<{
+    success: Schema.Literal<[true]>;
+    isDeleted: Schema.Literal<[true]>;
+}>;
+export type SoftDeleteFileResult = typeof SoftDeleteFileResult.Type;
+export declare const RestoreFileResult: Schema.Struct<{
+    success: Schema.Literal<[true]>;
+    file: Schema.Struct<{
+        id: typeof Schema.String;
+        size: typeof Schema.Number;
+        /** SDK-native filename (preferred). Alias of `filename` on newer servers. */
+        name: Schema.optional<typeof Schema.String>;
+        /** OpenAPI-native filename. Alias of `name` on older servers. */
+        filename: Schema.optional<typeof Schema.String>;
+        /** Folder path or storage key. */
+        path: Schema.optional<typeof Schema.String>;
+        /** Legacy storage object key (contract v1). */
+        key: Schema.optional<typeof Schema.String>;
+        /** Public URL — null for private files, absent on some delete responses. */
+        url: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        /** SDK-native MIME type. */
+        contentType: Schema.optional<typeof Schema.String>;
+        /** OpenAPI-native MIME type (alias of `contentType`). */
+        mimeType: Schema.optional<typeof Schema.String>;
+        /** Private/public visibility flag. Absent => treat as public. */
+        isPrivate: Schema.optional<typeof Schema.Boolean>;
+        /** Arbitrary caller-attached metadata. */
+        metadata: Schema.optional<Schema.NullOr<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>>;
+        /** SDK-native creation timestamp (ISO string). */
+        createdAt: Schema.optional<typeof Schema.String>;
+        /** Legacy contract v1 upload timestamp (alias of createdAt). */
+        uploadedAt: Schema.optional<typeof Schema.String>;
+    }>;
+}>;
+export type RestoreFileResult = typeof RestoreFileResult.Type;
+//# sourceMappingURL=storage.d.ts.map

package/dist/schemas/storage.d.ts.map

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

package/dist/schemas/storage.js

@@ -0,0 +1,173 @@
+/**
+ * Storage — BaaS plane file upload / download. Uses presigned URLs per AWS
+ * S3 convention. Mirrors `@sylphx/sdk/storage.ts`.
+ *
+ * Shape policy (ADR-084 Wave 2d): schemas here are the UNION superset of
+ * all production SDK / OpenAPI-generated wire shapes. Any field that is not
+ * universally present on the wire is `optional`, so contract consumers
+ * never have to narrow to parse a legitimate server response. When the
+ * server response narrows in future, tighten the optional in a dedicated
+ * wave — never break existing callers by removing a field.
+ */
+import { Schema } from 'effect';
+export const FileId = Schema.String.pipe(Schema.brand('FileId'));
+/**
+ * File metadata superset — reconciles three historical shapes:
+ *
+ * - SDK `FileInfo` interface: `{ id, url, name, size, contentType,
+ *   isPrivate, createdAt }`
+ * - Generated OpenAPI `FileInfo` / `GetFileResponse`: `{ id, filename,
+ *   path, url, mimeType, size, metadata, createdAt }`
+ * - Previous contract shape: `{ id, key, size, contentType, url?,
+ *   uploadedAt }`
+ *
+ * Every historical field is preserved as optional so older and newer
+ * clients can both parse server responses. `id` and `size` are the only
+ * guaranteed-present fields across all three shapes.
+ */
+export const FileInfo = Schema.Struct({
+    id: Schema.String,
+    size: Schema.Number,
+    /** SDK-native filename (preferred). Alias of `filename` on newer servers. */
+    name: Schema.optional(Schema.String),
+    /** OpenAPI-native filename. Alias of `name` on older servers. */
+    filename: Schema.optional(Schema.String),
+    /** Folder path or storage key. */
+    path: Schema.optional(Schema.String),
+    /** Legacy storage object key (contract v1). */
+    key: Schema.optional(Schema.String),
+    /** Public URL — null for private files, absent on some delete responses. */
+    url: Schema.optional(Schema.NullOr(Schema.String)),
+    /** SDK-native MIME type. */
+    contentType: Schema.optional(Schema.String),
+    /** OpenAPI-native MIME type (alias of `contentType`). */
+    mimeType: Schema.optional(Schema.String),
+    /** Private/public visibility flag. Absent => treat as public. */
+    isPrivate: Schema.optional(Schema.Boolean),
+    /** Arbitrary caller-attached metadata. */
+    metadata: Schema.optional(Schema.NullOr(Schema.Record({ key: Schema.String, value: Schema.Unknown }))),
+    /** SDK-native creation timestamp (ISO string). */
+    createdAt: Schema.optional(Schema.String),
+    /** Legacy contract v1 upload timestamp (alias of createdAt). */
+    uploadedAt: Schema.optional(Schema.String),
+});
+/**
+ * Input for the richer `/storage/upload` token flow used by the SDK for
+ * client-direct uploads (Vercel Blob pattern). Server mints an upload
+ * endpoint + client payload, and the SDK performs the actual PUT against
+ * storage. Superset of `UploadUrlInput`.
+ */
+export const UploadTokenInput = Schema.Struct({
+    filename: Schema.String,
+    contentType: Schema.optional(Schema.String),
+    size: Schema.optional(Schema.Number),
+    /** Folder path for organizing the file. */
+    path: Schema.optional(Schema.String),
+    /** `file` | `avatar` — avatars apply user-scoped policy. */
+    type: Schema.optional(Schema.Literal('file', 'avatar')),
+    /** User ID (required for `type: 'avatar'`). */
+    userId: Schema.optional(Schema.String),
+    /** Arbitrary caller-attached metadata persisted alongside the blob. */
+    metadata: Schema.optional(Schema.Record({ key: Schema.String, value: Schema.Unknown })),
+});
+/**
+ * Upload token response. Supports both the simple `{ uploadUrl, publicUrl,
+ * fileId, expiresAt }` shape and the richer Vercel-Blob-style
+ * `{ uploadEndpoint, clientPayload, instructions, ... }` shape.
+ */
+export const UploadTokenResult = Schema.Struct({
+    // Simple flow
+    uploadUrl: Schema.optional(Schema.String),
+    publicUrl: Schema.optional(Schema.String),
+    fileId: Schema.optional(Schema.String),
+    expiresAt: Schema.optional(Schema.String),
+    // Vercel Blob client-upload flow
+    uploadEndpoint: Schema.optional(Schema.String),
+    clientPayload: Schema.optional(Schema.String),
+    maxSize: Schema.optional(Schema.Number),
+    maxMultipartSize: Schema.optional(Schema.Number),
+    multipartThreshold: Schema.optional(Schema.Number),
+    allowedContentTypes: Schema.optional(Schema.Array(Schema.String)),
+    instructions: Schema.optional(Schema.Record({ key: Schema.String, value: Schema.Unknown })),
+});
+export const UploadUrlInput = Schema.Struct({
+    filename: Schema.String,
+    contentType: Schema.String,
+    size: Schema.optional(Schema.Number),
+});
+export const UploadUrlResult = Schema.Struct({
+    uploadUrl: Schema.String,
+    fileId: Schema.String,
+    expiresAt: Schema.String,
+});
+export const ListFilesQuery = Schema.Struct({
+    prefix: Schema.optional(Schema.String),
+    limit: Schema.optional(Schema.String),
+    cursor: Schema.optional(Schema.String),
+});
+export const ListFilesResult = Schema.Struct({
+    files: Schema.Array(FileInfo),
+    nextCursor: Schema.NullOr(Schema.String),
+    /** True if there are more files beyond this page. */
+    hasMore: Schema.optional(Schema.Boolean),
+});
+export const DeleteFileResult = Schema.Struct({ success: Schema.Boolean });
+/**
+ * Signed download URL input. Returns a short-lived URL for private files
+ * without exposing permanent credentials.
+ */
+export const SignedUrlInput = Schema.Struct({
+    fileId: Schema.String,
+    /** Seconds until the URL expires (default: 3600, max: 604800 = 7 days). */
+    expiresIn: Schema.optional(Schema.Number),
+    /** `attachment` forces download, `inline` displays in browser. */
+    disposition: Schema.optional(Schema.Literal('attachment', 'inline')),
+    /** Restrict URL access to a specific user. */
+    userId: Schema.optional(Schema.String),
+});
+export const SignedUrlResult = Schema.Struct({
+    url: Schema.String,
+    expiresAt: Schema.String,
+    file: Schema.Struct({
+        id: Schema.String,
+        filename: Schema.String,
+        mimeType: Schema.String,
+        sizeBytes: Schema.Number,
+        isPrivate: Schema.Boolean,
+    }),
+});
+// ============================================================================
+// ADR-089 Phase 5.8 — Versioning
+// ============================================================================
+/**
+ * A single version of a file. Append-only per-file history — every
+ * upload creates one row with a monotonic `versionNumber`. Restore
+ * creates a NEW version row pointing at the old object (never mutates
+ * history).
+ */
+export const StorageFileVersion = Schema.Struct({
+    id: Schema.String,
+    fileId: Schema.String,
+    versionNumber: Schema.Number,
+    sizeBytes: Schema.Number,
+    contentType: Schema.NullOr(Schema.String),
+    checksumSha256: Schema.NullOr(Schema.String),
+    createdAt: Schema.String,
+    createdBy: Schema.NullOr(Schema.String),
+    isCurrent: Schema.Boolean,
+});
+export const ListFileVersionsResult = Schema.Struct({
+    versions: Schema.Array(StorageFileVersion),
+});
+export const RestoreVersionResult = Schema.Struct({
+    success: Schema.Literal(true),
+    version: StorageFileVersion,
+});
+export const SoftDeleteFileResult = Schema.Struct({
+    success: Schema.Literal(true),
+    isDeleted: Schema.Literal(true),
+});
+export const RestoreFileResult = Schema.Struct({
+    success: Schema.Literal(true),
+    file: FileInfo,
+});

package/dist/schemas/tasks.d.ts

@@ -0,0 +1,178 @@
+/**
+ * Console Tasks — schemas for customer-facing background job management.
+ * Mirrors `routes/tasks/{status,one-off,cron}.ts`.
+ *
+ * Plane: `management` (Console uses this under platformAuth for customer
+ * projects). Distinct from `adminTasks*` (operator dashboard over the
+ * platform DB).
+ */
+import { Schema } from 'effect';
+export declare const TaskStatusEnum: Schema.Literal<["pending", "queued", "running", "completed", "failed", "scheduled", "paused", "cancelled", "deleted"]>;
+export type TaskStatusEnum = typeof TaskStatusEnum.Type;
+export declare const TaskTypeEnum: Schema.Literal<["one-time", "cron"]>;
+export type TaskTypeEnum = typeof TaskTypeEnum.Type;
+export declare const TaskHttpMethod: Schema.Literal<["GET", "POST", "PUT", "DELETE", "PATCH"]>;
+export type TaskHttpMethod = typeof TaskHttpMethod.Type;
+export declare const Task: Schema.Struct<{
+    id: typeof Schema.String;
+    name: Schema.NullOr<typeof Schema.String>;
+    type: Schema.Literal<["one-time", "cron"]>;
+    status: Schema.Literal<["pending", "queued", "running", "completed", "failed", "scheduled", "paused", "cancelled", "deleted"]>;
+    callbackUrl: typeof Schema.String;
+    payload: Schema.NullOr<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+    method: Schema.NullOr<Schema.Literal<["GET", "POST", "PUT", "DELETE", "PATCH"]>>;
+    headers: Schema.NullOr<Schema.Record$<typeof Schema.String, typeof Schema.String>>;
+    scheduledFor: Schema.NullOr<typeof Schema.String>;
+    startedAt: Schema.NullOr<typeof Schema.String>;
+    completedAt: Schema.NullOr<typeof Schema.String>;
+    failedAt: Schema.NullOr<typeof Schema.String>;
+    cronExpression: Schema.NullOr<typeof Schema.String>;
+    retries: typeof Schema.Number;
+    maxRetries: typeof Schema.Number;
+    lastError: Schema.NullOr<typeof Schema.String>;
+    qstashMessageId: Schema.NullOr<typeof Schema.String>;
+    qstashScheduleId: Schema.NullOr<typeof Schema.String>;
+    createdAt: typeof Schema.String;
+}>;
+export type Task = typeof Task.Type;
+export declare const TaskIdParam: Schema.Struct<{
+    jobId: typeof Schema.String;
+}>;
+export type TaskIdParam = typeof TaskIdParam.Type;
+export declare const ScheduleIdParam: Schema.Struct<{
+    scheduleId: typeof Schema.String;
+}>;
+export type ScheduleIdParam = typeof ScheduleIdParam.Type;
+export declare const TasksProjectIdQuery: Schema.Struct<{
+    projectId: typeof Schema.String;
+}>;
+export type TasksProjectIdQuery = typeof TasksProjectIdQuery.Type;
+export declare const ListTasksQuery: Schema.Struct<{
+    projectId: typeof Schema.String;
+    status: Schema.optional<Schema.Literal<["all", "pending", "queued", "running", "completed", "failed", "scheduled", "paused", "cancelled", "deleted"]>>;
+    type: Schema.optional<Schema.Literal<["all", "one-time", "cron"]>>;
+    limit: Schema.optional<typeof Schema.String>;
+    offset: Schema.optional<typeof Schema.String>;
+}>;
+export type ListTasksQuery = typeof ListTasksQuery.Type;
+export declare const ScheduleTaskInput: Schema.Struct<{
+    projectId: typeof Schema.String;
+    environmentId: Schema.optional<typeof Schema.String>;
+    callbackUrl: typeof Schema.String;
+    payload: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+    method: Schema.optional<Schema.Literal<["GET", "POST", "PUT", "DELETE", "PATCH"]>>;
+    headers: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.String>>;
+    delay: Schema.optional<typeof Schema.Number>;
+    scheduledFor: Schema.optional<typeof Schema.String>;
+    retries: Schema.optional<typeof Schema.Number>;
+    name: Schema.optional<typeof Schema.String>;
+    type: Schema.optional<typeof Schema.String>;
+    timeout: Schema.optional<typeof Schema.Number>;
+}>;
+export type ScheduleTaskInput = typeof ScheduleTaskInput.Type;
+export declare const CreateCronTaskInput: Schema.Struct<{
+    projectId: typeof Schema.String;
+    callbackUrl: typeof Schema.String;
+    cron: typeof Schema.String;
+    payload: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+    method: Schema.optional<Schema.Literal<["GET", "POST", "PUT", "DELETE", "PATCH"]>>;
+    headers: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.String>>;
+    retries: Schema.optional<typeof Schema.Number>;
+    name: typeof Schema.String;
+    type: Schema.optional<typeof Schema.String>;
+    paused: Schema.optional<typeof Schema.Boolean>;
+    environmentId: Schema.optional<typeof Schema.String>;
+    taskName: Schema.optional<typeof Schema.String>;
+    handlerPath: Schema.optional<typeof Schema.String>;
+}>;
+export type CreateCronTaskInput = typeof CreateCronTaskInput.Type;
+export declare const CancelTaskInput: Schema.Struct<{
+    projectId: typeof Schema.String;
+}>;
+export type CancelTaskInput = typeof CancelTaskInput.Type;
+export declare const CronActionInput: Schema.Struct<{
+    projectId: typeof Schema.String;
+}>;
+export type CronActionInput = typeof CronActionInput.Type;
+export declare const DeleteCronInput: Schema.Struct<{
+    projectId: typeof Schema.String;
+}>;
+export type DeleteCronInput = typeof DeleteCronInput.Type;
+export declare const TasksStatusResult: Schema.Struct<{
+    available: typeof Schema.Boolean;
+    provider: typeof Schema.String;
+}>;
+export type TasksStatusResult = typeof TasksStatusResult.Type;
+export declare const ListTasksResult: Schema.Struct<{
+    jobs: Schema.Array$<Schema.Struct<{
+        id: typeof Schema.String;
+        name: Schema.NullOr<typeof Schema.String>;
+        type: Schema.Literal<["one-time", "cron"]>;
+        status: Schema.Literal<["pending", "queued", "running", "completed", "failed", "scheduled", "paused", "cancelled", "deleted"]>;
+        callbackUrl: typeof Schema.String;
+        payload: Schema.NullOr<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+        method: Schema.NullOr<Schema.Literal<["GET", "POST", "PUT", "DELETE", "PATCH"]>>;
+        headers: Schema.NullOr<Schema.Record$<typeof Schema.String, typeof Schema.String>>;
+        scheduledFor: Schema.NullOr<typeof Schema.String>;
+        startedAt: Schema.NullOr<typeof Schema.String>;
+        completedAt: Schema.NullOr<typeof Schema.String>;
+        failedAt: Schema.NullOr<typeof Schema.String>;
+        cronExpression: Schema.NullOr<typeof Schema.String>;
+        retries: typeof Schema.Number;
+        maxRetries: typeof Schema.Number;
+        lastError: Schema.NullOr<typeof Schema.String>;
+        qstashMessageId: Schema.NullOr<typeof Schema.String>;
+        qstashScheduleId: Schema.NullOr<typeof Schema.String>;
+        createdAt: typeof Schema.String;
+    }>>;
+    total: typeof Schema.Number;
+    limit: typeof Schema.Number;
+    offset: typeof Schema.Number;
+}>;
+export type ListTasksResult = typeof ListTasksResult.Type;
+export declare const GetTaskResult: Schema.Struct<{
+    job: Schema.Struct<{
+        id: typeof Schema.String;
+        name: Schema.NullOr<typeof Schema.String>;
+        type: Schema.Literal<["one-time", "cron"]>;
+        status: Schema.Literal<["pending", "queued", "running", "completed", "failed", "scheduled", "paused", "cancelled", "deleted"]>;
+        callbackUrl: typeof Schema.String;
+        payload: Schema.NullOr<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+        method: Schema.NullOr<Schema.Literal<["GET", "POST", "PUT", "DELETE", "PATCH"]>>;
+        headers: Schema.NullOr<Schema.Record$<typeof Schema.String, typeof Schema.String>>;
+        scheduledFor: Schema.NullOr<typeof Schema.String>;
+        startedAt: Schema.NullOr<typeof Schema.String>;
+        completedAt: Schema.NullOr<typeof Schema.String>;
+        failedAt: Schema.NullOr<typeof Schema.String>;
+        cronExpression: Schema.NullOr<typeof Schema.String>;
+        retries: typeof Schema.Number;
+        maxRetries: typeof Schema.Number;
+        lastError: Schema.NullOr<typeof Schema.String>;
+        qstashMessageId: Schema.NullOr<typeof Schema.String>;
+        qstashScheduleId: Schema.NullOr<typeof Schema.String>;
+        createdAt: typeof Schema.String;
+    }>;
+}>;
+export type GetTaskResult = typeof GetTaskResult.Type;
+export declare const ScheduleTaskResult: Schema.Struct<{
+    jobId: typeof Schema.String;
+    messageId: Schema.optional<typeof Schema.String>;
+    scheduledFor: Schema.NullOr<typeof Schema.String>;
+}>;
+export type ScheduleTaskResult = typeof ScheduleTaskResult.Type;
+export declare const CreateCronTaskResult: Schema.Struct<{
+    jobId: typeof Schema.String;
+    scheduleId: typeof Schema.String;
+    cron: typeof Schema.String;
+    paused: typeof Schema.Boolean;
+}>;
+export type CreateCronTaskResult = typeof CreateCronTaskResult.Type;
+export declare const CancelTaskResult: Schema.Struct<{
+    success: typeof Schema.Boolean;
+}>;
+export type CancelTaskResult = typeof CancelTaskResult.Type;
+export declare const CronActionResult: Schema.Struct<{
+    success: typeof Schema.Boolean;
+}>;
+export type CronActionResult = typeof CronActionResult.Type;
+//# sourceMappingURL=tasks.d.ts.map

package/dist/schemas/tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/schemas/tasks.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B,eAAO,MAAM,cAAc,wHAU1B,CAAA;AACD,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC,IAAI,CAAA;AAEvD,eAAO,MAAM,YAAY,sCAAqC,CAAA;AAC9D,MAAM,MAAM,YAAY,GAAG,OAAO,YAAY,CAAC,IAAI,CAAA;AAEnD,eAAO,MAAM,cAAc,2DAA0D,CAAA;AACrF,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC,IAAI,CAAA;AAEvD,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;EAoBf,CAAA;AACF,MAAM,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,IAAI,CAAA;AAInC,eAAO,MAAM,WAAW;;EAA0C,CAAA;AAClE,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC,IAAI,CAAA;AACjD,eAAO,MAAM,eAAe;;EAA+C,CAAA;AAC3E,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC,IAAI,CAAA;AAEzD,eAAO,MAAM,mBAAmB;;EAA8C,CAAA;AAC9E,MAAM,MAAM,mBAAmB,GAAG,OAAO,mBAAmB,CAAC,IAAI,CAAA;AAEjE,eAAO,MAAM,cAAc;;;;;;EAmBzB,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC,IAAI,CAAA;AAIvD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;EAa5B,CAAA;AACF,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAC,IAAI,CAAA;AAE7D,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;EAc9B,CAAA;AACF,MAAM,MAAM,mBAAmB,GAAG,OAAO,mBAAmB,CAAC,IAAI,CAAA;AAEjE,eAAO,MAAM,eAAe;;EAA8C,CAAA;AAC1E,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC,IAAI,CAAA;AACzD,eAAO,MAAM,eAAe;;EAA8C,CAAA;AAC1E,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC,IAAI,CAAA;AACzD,eAAO,MAAM,eAAe;;EAA8C,CAAA;AAC1E,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC,IAAI,CAAA;AAIzD,eAAO,MAAM,iBAAiB;;;EAG5B,CAAA;AACF,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAC,IAAI,CAAA;AAE7D,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;EAK1B,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC,IAAI,CAAA;AAEzD,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;EAA+B,CAAA;AACzD,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC,IAAI,CAAA;AAErD,eAAO,MAAM,kBAAkB;;;;EAI7B,CAAA;AACF,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC,IAAI,CAAA;AAE/D,eAAO,MAAM,oBAAoB;;;;;EAK/B,CAAA;AACF,MAAM,MAAM,oBAAoB,GAAG,OAAO,oBAAoB,CAAC,IAAI,CAAA;AAEnE,eAAO,MAAM,gBAAgB;;EAA6C,CAAA;AAC1E,MAAM,MAAM,gBAAgB,GAAG,OAAO,gBAAgB,CAAC,IAAI,CAAA;AAC3D,eAAO,MAAM,gBAAgB;;EAA6C,CAAA;AAC1E,MAAM,MAAM,gBAAgB,GAAG,OAAO,gBAAgB,CAAC,IAAI,CAAA"}