@spacefast/common 0.2.2 → 0.4.1

package/dist/contracts/runtime-storage.js

@@ -22,11 +22,32 @@ export const runtimeStorageListQuerySchema = z
         .describe("Maximum objects to return."),
 })
     .strict();
+/**
+ * The uploader's own name for an object: presentation only, never a path.
+ *
+ * The id is the identity — this is what a person reads in a list and what a
+ * download is saved as. Separators are refused rather than stripped so the
+ * value the caller sent is the value that comes back.
+ */
+export const runtimeStorageFilenameSchema = z
+    .string()
+    .trim()
+    .min(1)
+    .max(255)
+    .refine((value) => value !== "." &&
+    value !== ".." &&
+    // oxlint-disable-next-line no-control-regex -- refusing control characters in a header-borne name is the point.
+    !/[\u0000-\u001f\u007f/\\]/.test(value), { message: "Filename must be a single name, without path separators." });
 export const runtimeStorageObjectSchema = z
     .object({
     id: runtimeStorageObjectIdSchema,
     contentType: z.string().min(1).max(255),
     createdAt: z.string().datetime(),
+    /**
+     * Absent on objects stored before names existed, and on any upload that
+     * declared none. Never null — a nameless object simply has no filename.
+     */
+    filename: runtimeStorageFilenameSchema.optional(),
     size: z.number().int().nonnegative(),
     uploaderId: z.string().min(1).max(255),
     sha256: z.string().regex(/^[a-f0-9]{64}$/),
@@ -46,6 +67,22 @@ export const runtimeStorageListResponseSchema = z
     hasMore: z.boolean(),
 })
     .strict();
+/**
+ * The upload's metadata rides the URL because the body is the file.
+ *
+ * `contentType` comes from the request's own `Content-Type`, which is where a
+ * raw-body upload already states it; only the name has nowhere else to go.
+ */
+export const runtimeStorageUploadQuerySchema = z
+    .object({
+    filename: runtimeStorageFilenameSchema
+        .optional()
+        .describe("Name to store the object under, for display and downloads."),
+})
+    .strict();
+export const runtimeStorageUploadPublicResponseSchema = z.object({
+    data: runtimeStorageObjectSchema,
+});
 export const runtimeStorageListPublicResponseSchema = z.object({
     data: z.array(runtimeStorageObjectSchema),
     pagination: CursorPaginationSchema,

package/dist/contracts/source-workspaces.d.ts

@@ -0,0 +1,511 @@
+import { z } from "zod";
+export declare const sourceCommitShaSchema: z.ZodString;
+export declare const sourceWorkspacePathSchema: z.ZodString;
+export declare const sourceWorkspaceAuthorSchema: z.ZodObject<{
+    name: z.ZodString;
+    email: z.ZodString;
+}, z.core.$strip>;
+export declare const sourceWorkspaceFileOperationSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    action: z.ZodLiteral<"upsert">;
+    path: z.ZodString;
+    contents: z.ZodString;
+    encoding: z.ZodOptional<z.ZodEnum<{
+        base64: "base64";
+        utf8: "utf8";
+        hex: "hex";
+    }>>;
+    mode: z.ZodOptional<z.ZodEnum<{
+        100644: "100644";
+        100755: "100755";
+        120000: "120000";
+        160000: "160000";
+    }>>;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"delete">;
+    path: z.ZodString;
+}, z.core.$strip>], "action">;
+export declare const sourceWorkspaceMutationSchema: z.ZodObject<{
+    expectedRevision: z.ZodNumber;
+    operationId: z.ZodString;
+}, z.core.$strip>;
+export declare const sourceWorkspaceCreateSchema: z.ZodObject<{
+    operationId: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    targetBranch: z.ZodOptional<z.ZodString>;
+    originalUploadVersionId: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        email: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const sourceWorkspaceEditSchema: z.ZodObject<{
+    expectedRevision: z.ZodNumber;
+    operationId: z.ZodString;
+    operations: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        action: z.ZodLiteral<"upsert">;
+        path: z.ZodString;
+        contents: z.ZodString;
+        encoding: z.ZodOptional<z.ZodEnum<{
+            base64: "base64";
+            utf8: "utf8";
+            hex: "hex";
+        }>>;
+        mode: z.ZodOptional<z.ZodEnum<{
+            100644: "100644";
+            100755: "100755";
+            120000: "120000";
+            160000: "160000";
+        }>>;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"delete">;
+        path: z.ZodString;
+    }, z.core.$strip>], "action">>;
+}, z.core.$strip>;
+export declare const sourceWorkspaceSelectionSchema: z.ZodObject<{
+    expectedRevision: z.ZodNumber;
+    operationId: z.ZodString;
+    paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    hunkIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    all: z.ZodOptional<z.ZodLiteral<true>>;
+}, z.core.$strip>;
+export declare const sourceWorkspaceCommitSchema: z.ZodObject<{
+    expectedRevision: z.ZodNumber;
+    operationId: z.ZodString;
+    message: z.ZodString;
+    author: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        email: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const sourceWorkspaceRestoreSchema: z.ZodObject<{
+    expectedRevision: z.ZodNumber;
+    operationId: z.ZodString;
+    paths: z.ZodArray<z.ZodString>;
+    sourceCommitSha: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const sourceWorkspaceUndoSchema: z.ZodObject<{
+    expectedRevision: z.ZodNumber;
+    operationId: z.ZodString;
+    sourceCommitSha: z.ZodString;
+}, z.core.$strip>;
+export declare const sourceWorkspaceCloseSchema: z.ZodObject<{
+    expectedRevision: z.ZodNumber;
+    operationId: z.ZodString;
+    discardPending: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const sourceWorkspaceResolutionSchema: z.ZodUnion<readonly [z.ZodObject<{
+    path: z.ZodString;
+    contents: z.ZodString;
+    encoding: z.ZodOptional<z.ZodEnum<{
+        base64: "base64";
+        utf8: "utf8";
+        hex: "hex";
+    }>>;
+    mode: z.ZodOptional<z.ZodEnum<{
+        100644: "100644";
+        100755: "100755";
+        120000: "120000";
+        160000: "160000";
+    }>>;
+}, z.core.$strict>, z.ZodObject<{
+    path: z.ZodString;
+    delete: z.ZodLiteral<true>;
+}, z.core.$strict>, z.ZodObject<{
+    path: z.ZodString;
+    side: z.ZodEnum<{
+        base: "base";
+        ours: "ours";
+        theirs: "theirs";
+    }>;
+}, z.core.$strict>]>;
+export declare const sourceWorkspaceResolveSchema: z.ZodObject<{
+    expectedRevision: z.ZodNumber;
+    operationId: z.ZodString;
+    resolutions: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        path: z.ZodString;
+        contents: z.ZodString;
+        encoding: z.ZodOptional<z.ZodEnum<{
+            base64: "base64";
+            utf8: "utf8";
+            hex: "hex";
+        }>>;
+        mode: z.ZodOptional<z.ZodEnum<{
+            100644: "100644";
+            100755: "100755";
+            120000: "120000";
+            160000: "160000";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        path: z.ZodString;
+        delete: z.ZodLiteral<true>;
+    }, z.core.$strict>, z.ZodObject<{
+        path: z.ZodString;
+        side: z.ZodEnum<{
+            base: "base";
+            ours: "ours";
+            theirs: "theirs";
+        }>;
+    }, z.core.$strict>]>>;
+}, z.core.$strip>;
+export declare const sourceWorkspaceDiffQuerySchema: z.ZodObject<{
+    view: z.ZodDefault<z.ZodEnum<{
+        staged: "staged";
+        working: "working";
+        unstaged: "unstaged";
+    }>>;
+    path: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const sourceWorkspaceListQuerySchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    cursor: z.ZodOptional<z.ZodString>;
+    status: z.ZodDefault<z.ZodEnum<{
+        open: "open";
+        closed: "closed";
+    }>>;
+}, z.core.$strip>;
+export declare const SourceWorkspaceSchema: z.ZodObject<{
+    id: z.ZodString;
+    spaceId: z.ZodString;
+    repositoryId: z.ZodString;
+    targetBranch: z.ZodString;
+    name: z.ZodString;
+    revision: z.ZodNumber;
+    state: z.ZodEnum<{
+        active: "active";
+        closed: "closed";
+        initializing: "initializing";
+        conflicted: "conflicted";
+    }>;
+    baseCommitSha: z.ZodNullable<z.ZodString>;
+    indexCommitSha: z.ZodNullable<z.ZodString>;
+    workingCommitSha: z.ZodNullable<z.ZodString>;
+    headCommitSha: z.ZodNullable<z.ZodString>;
+    originalUploadVersionId: z.ZodNullable<z.ZodString>;
+    hasStagedChanges: z.ZodBoolean;
+    hasUnstagedChanges: z.ZodBoolean;
+    hasPendingChanges: z.ZodBoolean;
+    needsSync: z.ZodBoolean;
+    pendingOperationId: z.ZodNullable<z.ZodString>;
+    autoDeploy: z.ZodBoolean;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export declare const sourceWorkspaceHunkSchema: z.ZodObject<{
+    id: z.ZodString;
+    oldStart: z.ZodNumber;
+    oldLines: z.ZodNumber;
+    newStart: z.ZodNumber;
+    newLines: z.ZodNumber;
+    patch: z.ZodString;
+}, z.core.$strip>;
+export declare const sourceWorkspaceDiffFileSchema: z.ZodObject<{
+    path: z.ZodString;
+    oldPath: z.ZodNullable<z.ZodString>;
+    state: z.ZodString;
+    additions: z.ZodNumber;
+    deletions: z.ZodNumber;
+    changes: z.ZodNumber;
+    patch: z.ZodString;
+    patchTruncated: z.ZodBoolean;
+    wholeFileOnly: z.ZodBoolean;
+    hunks: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        oldStart: z.ZodNumber;
+        oldLines: z.ZodNumber;
+        newStart: z.ZodNumber;
+        newLines: z.ZodNumber;
+        patch: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const sourceWorkspaceDiffSchema: z.ZodObject<{
+    workspace: z.ZodObject<{
+        id: z.ZodString;
+        spaceId: z.ZodString;
+        repositoryId: z.ZodString;
+        targetBranch: z.ZodString;
+        name: z.ZodString;
+        revision: z.ZodNumber;
+        state: z.ZodEnum<{
+            active: "active";
+            closed: "closed";
+            initializing: "initializing";
+            conflicted: "conflicted";
+        }>;
+        baseCommitSha: z.ZodNullable<z.ZodString>;
+        indexCommitSha: z.ZodNullable<z.ZodString>;
+        workingCommitSha: z.ZodNullable<z.ZodString>;
+        headCommitSha: z.ZodNullable<z.ZodString>;
+        originalUploadVersionId: z.ZodNullable<z.ZodString>;
+        hasStagedChanges: z.ZodBoolean;
+        hasUnstagedChanges: z.ZodBoolean;
+        hasPendingChanges: z.ZodBoolean;
+        needsSync: z.ZodBoolean;
+        pendingOperationId: z.ZodNullable<z.ZodString>;
+        autoDeploy: z.ZodBoolean;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, z.core.$strip>;
+    view: z.ZodEnum<{
+        staged: "staged";
+        working: "working";
+        unstaged: "unstaged";
+    }>;
+    baseCommitSha: z.ZodString;
+    targetCommitSha: z.ZodString;
+    stats: z.ZodObject<{
+        files: z.ZodNumber;
+        additions: z.ZodNumber;
+        deletions: z.ZodNumber;
+        changes: z.ZodNumber;
+    }, z.core.$strip>;
+    files: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        oldPath: z.ZodNullable<z.ZodString>;
+        state: z.ZodString;
+        additions: z.ZodNumber;
+        deletions: z.ZodNumber;
+        changes: z.ZodNumber;
+        patch: z.ZodString;
+        patchTruncated: z.ZodBoolean;
+        wholeFileOnly: z.ZodBoolean;
+        hunks: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            oldStart: z.ZodNumber;
+            oldLines: z.ZodNumber;
+            newStart: z.ZodNumber;
+            newLines: z.ZodNumber;
+            patch: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    filteredFiles: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        oldPath: z.ZodNullable<z.ZodString>;
+        state: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const sourceWorkspaceConflictSideSchema: z.ZodObject<{
+    sourceCommitSha: z.ZodString;
+    content: z.ZodNullable<z.ZodString>;
+    exists: z.ZodBoolean;
+    binary: z.ZodBoolean;
+    truncated: z.ZodBoolean;
+    mode: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const sourceWorkspaceConflictsSchema: z.ZodObject<{
+    phase: z.ZodEnum<{
+        staged: "staged";
+        working: "working";
+        undo: "undo";
+    }>;
+    labels: z.ZodObject<{
+        ours: z.ZodString;
+        theirs: z.ZodString;
+    }, z.core.$strip>;
+    files: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        result: z.ZodString;
+        base: z.ZodObject<{
+            sourceCommitSha: z.ZodString;
+            content: z.ZodNullable<z.ZodString>;
+            exists: z.ZodBoolean;
+            binary: z.ZodBoolean;
+            truncated: z.ZodBoolean;
+            mode: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+        ours: z.ZodObject<{
+            sourceCommitSha: z.ZodString;
+            content: z.ZodNullable<z.ZodString>;
+            exists: z.ZodBoolean;
+            binary: z.ZodBoolean;
+            truncated: z.ZodBoolean;
+            mode: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+        theirs: z.ZodObject<{
+            sourceCommitSha: z.ZodString;
+            content: z.ZodNullable<z.ZodString>;
+            exists: z.ZodBoolean;
+            binary: z.ZodBoolean;
+            truncated: z.ZodBoolean;
+            mode: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const sourceWorkspaceReceiptSchema: z.ZodObject<{
+    workspace: z.ZodObject<{
+        id: z.ZodString;
+        spaceId: z.ZodString;
+        repositoryId: z.ZodString;
+        targetBranch: z.ZodString;
+        name: z.ZodString;
+        revision: z.ZodNumber;
+        state: z.ZodEnum<{
+            active: "active";
+            closed: "closed";
+            initializing: "initializing";
+            conflicted: "conflicted";
+        }>;
+        baseCommitSha: z.ZodNullable<z.ZodString>;
+        indexCommitSha: z.ZodNullable<z.ZodString>;
+        workingCommitSha: z.ZodNullable<z.ZodString>;
+        headCommitSha: z.ZodNullable<z.ZodString>;
+        originalUploadVersionId: z.ZodNullable<z.ZodString>;
+        hasStagedChanges: z.ZodBoolean;
+        hasUnstagedChanges: z.ZodBoolean;
+        hasPendingChanges: z.ZodBoolean;
+        needsSync: z.ZodBoolean;
+        pendingOperationId: z.ZodNullable<z.ZodString>;
+        autoDeploy: z.ZodBoolean;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, z.core.$strip>;
+    commit: z.ZodOptional<z.ZodObject<{
+        sourceCommitSha: z.ZodString;
+        parentSourceCommitSha: z.ZodString;
+        message: z.ZodString;
+        autoDeploy: z.ZodBoolean;
+    }, z.core.$strip>>;
+    conflicts: z.ZodOptional<z.ZodObject<{
+        phase: z.ZodEnum<{
+            staged: "staged";
+            working: "working";
+            undo: "undo";
+        }>;
+        labels: z.ZodObject<{
+            ours: z.ZodString;
+            theirs: z.ZodString;
+        }, z.core.$strip>;
+        files: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            result: z.ZodString;
+            base: z.ZodObject<{
+                sourceCommitSha: z.ZodString;
+                content: z.ZodNullable<z.ZodString>;
+                exists: z.ZodBoolean;
+                binary: z.ZodBoolean;
+                truncated: z.ZodBoolean;
+                mode: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>;
+            ours: z.ZodObject<{
+                sourceCommitSha: z.ZodString;
+                content: z.ZodNullable<z.ZodString>;
+                exists: z.ZodBoolean;
+                binary: z.ZodBoolean;
+                truncated: z.ZodBoolean;
+                mode: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>;
+            theirs: z.ZodObject<{
+                sourceCommitSha: z.ZodString;
+                content: z.ZodNullable<z.ZodString>;
+                exists: z.ZodBoolean;
+                binary: z.ZodBoolean;
+                truncated: z.ZodBoolean;
+                mode: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const sourceWorkspaceListSchema: z.ZodObject<{
+    workspaces: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        spaceId: z.ZodString;
+        repositoryId: z.ZodString;
+        targetBranch: z.ZodString;
+        name: z.ZodString;
+        revision: z.ZodNumber;
+        state: z.ZodEnum<{
+            active: "active";
+            closed: "closed";
+            initializing: "initializing";
+            conflicted: "conflicted";
+        }>;
+        baseCommitSha: z.ZodNullable<z.ZodString>;
+        indexCommitSha: z.ZodNullable<z.ZodString>;
+        workingCommitSha: z.ZodNullable<z.ZodString>;
+        headCommitSha: z.ZodNullable<z.ZodString>;
+        originalUploadVersionId: z.ZodNullable<z.ZodString>;
+        hasStagedChanges: z.ZodBoolean;
+        hasUnstagedChanges: z.ZodBoolean;
+        hasPendingChanges: z.ZodBoolean;
+        needsSync: z.ZodBoolean;
+        pendingOperationId: z.ZodNullable<z.ZodString>;
+        autoDeploy: z.ZodBoolean;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, z.core.$strip>>;
+    pagination: z.ZodObject<{
+        nextCursor: z.ZodNullable<z.ZodString>;
+        hasMore: z.ZodBoolean;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const sourceWorkspaceConflictResponseSchema: z.ZodObject<{
+    workspace: z.ZodObject<{
+        id: z.ZodString;
+        spaceId: z.ZodString;
+        repositoryId: z.ZodString;
+        targetBranch: z.ZodString;
+        name: z.ZodString;
+        revision: z.ZodNumber;
+        state: z.ZodEnum<{
+            active: "active";
+            closed: "closed";
+            initializing: "initializing";
+            conflicted: "conflicted";
+        }>;
+        baseCommitSha: z.ZodNullable<z.ZodString>;
+        indexCommitSha: z.ZodNullable<z.ZodString>;
+        workingCommitSha: z.ZodNullable<z.ZodString>;
+        headCommitSha: z.ZodNullable<z.ZodString>;
+        originalUploadVersionId: z.ZodNullable<z.ZodString>;
+        hasStagedChanges: z.ZodBoolean;
+        hasUnstagedChanges: z.ZodBoolean;
+        hasPendingChanges: z.ZodBoolean;
+        needsSync: z.ZodBoolean;
+        pendingOperationId: z.ZodNullable<z.ZodString>;
+        autoDeploy: z.ZodBoolean;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, z.core.$strip>;
+    conflicts: z.ZodNullable<z.ZodObject<{
+        phase: z.ZodEnum<{
+            staged: "staged";
+            working: "working";
+            undo: "undo";
+        }>;
+        labels: z.ZodObject<{
+            ours: z.ZodString;
+            theirs: z.ZodString;
+        }, z.core.$strip>;
+        files: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            result: z.ZodString;
+            base: z.ZodObject<{
+                sourceCommitSha: z.ZodString;
+                content: z.ZodNullable<z.ZodString>;
+                exists: z.ZodBoolean;
+                binary: z.ZodBoolean;
+                truncated: z.ZodBoolean;
+                mode: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>;
+            ours: z.ZodObject<{
+                sourceCommitSha: z.ZodString;
+                content: z.ZodNullable<z.ZodString>;
+                exists: z.ZodBoolean;
+                binary: z.ZodBoolean;
+                truncated: z.ZodBoolean;
+                mode: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>;
+            theirs: z.ZodObject<{
+                sourceCommitSha: z.ZodString;
+                content: z.ZodNullable<z.ZodString>;
+                exists: z.ZodBoolean;
+                binary: z.ZodBoolean;
+                truncated: z.ZodBoolean;
+                mode: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SourceWorkspace = z.infer<typeof SourceWorkspaceSchema>;
+export type SourceWorkspaceReceipt = z.infer<typeof sourceWorkspaceReceiptSchema>;
+export type SourceWorkspaceDiff = z.infer<typeof sourceWorkspaceDiffSchema>;
+export type SourceWorkspaceConflicts = z.infer<typeof sourceWorkspaceConflictsSchema>;