@cephla/types 0.1.0

package/dist/file.d.ts

@@ -0,0 +1,48 @@
+import { z } from "zod";
+export declare const MAX_UPLOAD_BYTES: number;
+export declare const InitUploadInput: z.ZodObject<{
+    name: z.ZodString;
+    sizeBytes: z.ZodNumber;
+    contentType: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    sizeBytes: number;
+    contentType: string;
+}, {
+    name: string;
+    sizeBytes: number;
+    contentType: string;
+}>;
+export type InitUploadInput = z.infer<typeof InitUploadInput>;
+export declare const InitUploadResponse: z.ZodObject<{
+    fileId: z.ZodString;
+    sessionUri: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    fileId: string;
+    sessionUri: string;
+}, {
+    fileId: string;
+    sessionUri: string;
+}>;
+export type InitUploadResponse = z.infer<typeof InitUploadResponse>;
+export declare const FileSummary: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    sizeBytes: z.ZodNumber;
+    contentType: z.ZodString;
+    uploadedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    sizeBytes: number;
+    contentType: string;
+    id: string;
+    uploadedAt: string;
+}, {
+    name: string;
+    sizeBytes: number;
+    contentType: string;
+    id: string;
+    uploadedAt: string;
+}>;
+export type FileSummary = z.infer<typeof FileSummary>;
+//# sourceMappingURL=file.d.ts.map

package/dist/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../src/file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,gBAAgB,QAA0B,CAAC;AAExD,eAAO,MAAM,eAAe;;;;;;;;;;;;EAI1B,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,eAAO,MAAM,kBAAkB;;;;;;;;;EAG7B,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;EAMtB,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC"}

package/dist/file.js

@@ -0,0 +1,22 @@
+import { z } from "zod";
+// 50 GB. Matches the 100 GB max-file scale target with breathing room while
+// the upload path is still single-PUT (no chunked/resumable client support).
+// Bump after Plan 2 introduces chunked uploads.
+export const MAX_UPLOAD_BYTES = 50 * 1024 * 1024 * 1024;
+export const InitUploadInput = z.object({
+    name: z.string().min(1).max(500),
+    sizeBytes: z.number().int().positive().max(MAX_UPLOAD_BYTES),
+    contentType: z.string().min(1).max(200),
+});
+export const InitUploadResponse = z.object({
+    fileId: z.string().uuid(),
+    sessionUri: z.string().url(),
+});
+export const FileSummary = z.object({
+    id: z.string().uuid(),
+    name: z.string(),
+    sizeBytes: z.number(),
+    contentType: z.string(),
+    uploadedAt: z.string().datetime(),
+});
+//# sourceMappingURL=file.js.map

package/dist/file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../src/file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,4EAA4E;AAC5E,6EAA6E;AAC7E,gDAAgD;AAChD,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAExD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAC5D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;CACxC,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACzB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;CAC7B,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACrB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * as ProjectTypes from "./project.js";
+export * as FileTypes from "./file.js";
+export * as ShareTypes from "./share.js";
+export * as UploadTypes from "./upload.js";
+export * as UploadRules from "./upload-rules.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,OAAO,KAAK,YAAY,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,SAAS,MAAM,WAAW,CAAC;AACvC,OAAO,KAAK,UAAU,MAAM,YAAY,CAAC;AACzC,OAAO,KAAK,WAAW,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export * as ProjectTypes from "./project.js";
+export * as FileTypes from "./file.js";
+export * as ShareTypes from "./share.js";
+export * as UploadTypes from "./upload.js";
+export * as UploadRules from "./upload-rules.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":"AAAA,OAAO,KAAK,YAAY,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,SAAS,MAAM,WAAW,CAAC;AACvC,OAAO,KAAK,UAAU,MAAM,YAAY,CAAC;AACzC,OAAO,KAAK,WAAW,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC"}

package/dist/project.d.ts

@@ -0,0 +1,42 @@
+import { z } from "zod";
+export declare const CreateProjectInput: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    description?: string | undefined;
+}, {
+    name: string;
+    description?: string | undefined;
+}>;
+export type CreateProjectInput = z.infer<typeof CreateProjectInput>;
+export declare const Project: z.ZodObject<{
+    id: z.ZodString;
+    slug: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    ownerId: z.ZodString;
+    gcsPrefix: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    id: string;
+    description: string | null;
+    slug: string;
+    ownerId: string;
+    gcsPrefix: string;
+    createdAt: string;
+    updatedAt: string;
+}, {
+    name: string;
+    id: string;
+    description: string | null;
+    slug: string;
+    ownerId: string;
+    gcsPrefix: string;
+    createdAt: string;
+    updatedAt: string;
+}>;
+export type Project = z.infer<typeof Project>;
+//# sourceMappingURL=project.d.ts.map

package/dist/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kBAAkB;;;;;;;;;EAG7B,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;EASlB,CAAC;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,OAAO,CAAC,CAAC"}

package/dist/project.js

@@ -0,0 +1,16 @@
+import { z } from "zod";
+export const CreateProjectInput = z.object({
+    name: z.string().min(1).max(200),
+    description: z.string().max(2000).optional(),
+});
+export const Project = z.object({
+    id: z.string().uuid(),
+    slug: z.string(),
+    name: z.string(),
+    description: z.string().nullable(),
+    ownerId: z.string().uuid(),
+    gcsPrefix: z.string(),
+    createdAt: z.string().datetime(),
+    updatedAt: z.string().datetime(),
+});
+//# sourceMappingURL=project.js.map

package/dist/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAChC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;CAC7C,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACrB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC1B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC"}

package/dist/share.d.ts

@@ -0,0 +1,36 @@
+import { z } from "zod";
+export declare const CreateShareInput: z.ZodObject<{
+    recipientEmail: z.ZodString;
+    expiresInDays: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    recipientEmail: string;
+    expiresInDays?: number | undefined;
+}, {
+    recipientEmail: string;
+    expiresInDays?: number | undefined;
+}>;
+export type CreateShareInput = z.infer<typeof CreateShareInput>;
+export declare const ShareSummary: z.ZodObject<{
+    id: z.ZodString;
+    recipientEmail: z.ZodString;
+    createdAt: z.ZodString;
+    expiresAt: z.ZodNullable<z.ZodString>;
+    revokedAt: z.ZodNullable<z.ZodString>;
+    lastOpenedAt: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    createdAt: string;
+    recipientEmail: string;
+    expiresAt: string | null;
+    revokedAt: string | null;
+    lastOpenedAt: string | null;
+}, {
+    id: string;
+    createdAt: string;
+    recipientEmail: string;
+    expiresAt: string | null;
+    revokedAt: string | null;
+    lastOpenedAt: string | null;
+}>;
+export type ShareSummary = z.infer<typeof ShareSummary>;
+//# sourceMappingURL=share.d.ts.map

package/dist/share.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"share.d.ts","sourceRoot":"","sources":["../src/share.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,gBAAgB;;;;;;;;;EAG3B,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;EAOvB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC"}

package/dist/share.js

@@ -0,0 +1,14 @@
+import { z } from "zod";
+export const CreateShareInput = z.object({
+    recipientEmail: z.string().email().max(320),
+    expiresInDays: z.number().int().min(1).max(365).optional(), // null = no expiry
+});
+export const ShareSummary = z.object({
+    id: z.string().uuid(),
+    recipientEmail: z.string(),
+    createdAt: z.string().datetime(),
+    expiresAt: z.string().datetime().nullable(),
+    revokedAt: z.string().datetime().nullable(),
+    lastOpenedAt: z.string().datetime().nullable(),
+});
+//# sourceMappingURL=share.js.map

package/dist/share.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"share.js","sourceRoot":"","sources":["../src/share.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC;IAC3C,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,mBAAmB;CAChF,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACrB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC3C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC3C,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAC/C,CAAC,CAAC"}

package/dist/upload-rules.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Filename / path patterns that the upload flow always ignores, regardless of
+ * the --include-hidden flag. These are OS-junk and VCS metadata that nobody
+ * intends to upload.
+ *
+ * Used by both the browser folder-walker (when computing display totals in the
+ * upload modal) and the CLI walker (when building the declare list). Keeping
+ * them in @cephla/types means a single source of truth.
+ */
+export declare const DEFAULT_IGNORE_PATTERNS: readonly RegExp[];
+export interface IgnoreOptions {
+    /** When false (default), any path segment starting with "." is ignored. */
+    includeHidden: boolean;
+}
+export declare function shouldIgnore(relativePath: string, opts: IgnoreOptions): boolean;
+//# sourceMappingURL=upload-rules.d.ts.map

package/dist/upload-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-rules.d.ts","sourceRoot":"","sources":["../src/upload-rules.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,MAAM,EAQpD,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,2EAA2E;IAC3E,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAM/E"}

package/dist/upload-rules.js

@@ -0,0 +1,28 @@
+/**
+ * Filename / path patterns that the upload flow always ignores, regardless of
+ * the --include-hidden flag. These are OS-junk and VCS metadata that nobody
+ * intends to upload.
+ *
+ * Used by both the browser folder-walker (when computing display totals in the
+ * upload modal) and the CLI walker (when building the declare list). Keeping
+ * them in @cephla/types means a single source of truth.
+ */
+export const DEFAULT_IGNORE_PATTERNS = [
+    /(^|\/)\.DS_Store$/,
+    /(^|\/)Thumbs\.db$/,
+    /(^|\/)desktop\.ini$/,
+    /(^|\/)\.git\//,
+    /(^|\/)\.svn\//,
+    /(^|\/)\.hg\//,
+    /(^|\/)node_modules\//,
+];
+export function shouldIgnore(relativePath, opts) {
+    if (DEFAULT_IGNORE_PATTERNS.some((re) => re.test(relativePath)))
+        return true;
+    if (!opts.includeHidden) {
+        if (relativePath.split("/").some((s) => s.startsWith(".")))
+            return true;
+    }
+    return false;
+}
+//# sourceMappingURL=upload-rules.js.map

package/dist/upload-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-rules.js","sourceRoot":"","sources":["../src/upload-rules.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAsB;IACxD,mBAAmB;IACnB,mBAAmB;IACnB,qBAAqB;IACrB,eAAe;IACf,eAAe;IACf,cAAc;IACd,sBAAsB;CACvB,CAAC;AAOF,MAAM,UAAU,YAAY,CAAC,YAAoB,EAAE,IAAmB;IACpE,IAAI,uBAAuB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7E,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;QACxB,IAAI,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;IAC1E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/upload.d.ts

@@ -0,0 +1,170 @@
+import { z } from "zod";
+export declare const MAX_UPLOAD_FILE_BYTES: number;
+export declare const DECLARE_BATCH_MAX = 200;
+export declare const InitUploadSessionInput: z.ZodEffects<z.ZodObject<{
+    projectId: z.ZodOptional<z.ZodString>;
+    projectName: z.ZodOptional<z.ZodString>;
+    projectDescription: z.ZodOptional<z.ZodString>;
+    sourceFolderName: z.ZodString;
+    expectedFileCount: z.ZodNumber;
+    expectedTotalBytes: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    sourceFolderName: string;
+    expectedFileCount: number;
+    expectedTotalBytes: number;
+    projectId?: string | undefined;
+    projectName?: string | undefined;
+    projectDescription?: string | undefined;
+}, {
+    sourceFolderName: string;
+    expectedFileCount: number;
+    expectedTotalBytes: number;
+    projectId?: string | undefined;
+    projectName?: string | undefined;
+    projectDescription?: string | undefined;
+}>, {
+    sourceFolderName: string;
+    expectedFileCount: number;
+    expectedTotalBytes: number;
+    projectId?: string | undefined;
+    projectName?: string | undefined;
+    projectDescription?: string | undefined;
+}, {
+    sourceFolderName: string;
+    expectedFileCount: number;
+    expectedTotalBytes: number;
+    projectId?: string | undefined;
+    projectName?: string | undefined;
+    projectDescription?: string | undefined;
+}>;
+export type InitUploadSessionInput = z.infer<typeof InitUploadSessionInput>;
+export declare const InitUploadSessionResponse: z.ZodObject<{
+    sessionId: z.ZodString;
+    projectId: z.ZodString;
+    command: z.ZodString;
+    expiresAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    expiresAt: string;
+    projectId: string;
+    sessionId: string;
+    command: string;
+}, {
+    expiresAt: string;
+    projectId: string;
+    sessionId: string;
+    command: string;
+}>;
+export type InitUploadSessionResponse = z.infer<typeof InitUploadSessionResponse>;
+export declare const DeclareInput: z.ZodObject<{
+    files: z.ZodArray<z.ZodObject<{
+        relativePath: z.ZodPipeline<z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>, string, string>>;
+        sizeBytes: z.ZodNumber;
+        contentType: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        sizeBytes: number;
+        contentType: string;
+        relativePath: string;
+    }, {
+        sizeBytes: number;
+        contentType: string;
+        relativePath: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    files: {
+        sizeBytes: number;
+        contentType: string;
+        relativePath: string;
+    }[];
+}, {
+    files: {
+        sizeBytes: number;
+        contentType: string;
+        relativePath: string;
+    }[];
+}>;
+export type DeclareInput = z.infer<typeof DeclareInput>;
+export declare const DeclareResponse: z.ZodObject<{
+    files: z.ZodArray<z.ZodObject<{
+        fileId: z.ZodString;
+        relativePath: z.ZodString;
+        sessionUri: z.ZodNullable<z.ZodString>;
+        alreadyUploaded: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        fileId: string;
+        sessionUri: string | null;
+        relativePath: string;
+        alreadyUploaded: boolean;
+    }, {
+        fileId: string;
+        sessionUri: string | null;
+        relativePath: string;
+        alreadyUploaded: boolean;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    files: {
+        fileId: string;
+        sessionUri: string | null;
+        relativePath: string;
+        alreadyUploaded: boolean;
+    }[];
+}, {
+    files: {
+        fileId: string;
+        sessionUri: string | null;
+        relativePath: string;
+        alreadyUploaded: boolean;
+    }[];
+}>;
+export type DeclareResponse = z.infer<typeof DeclareResponse>;
+export declare const CompleteFileInput: z.ZodObject<{
+    fileId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    fileId: string;
+}, {
+    fileId: string;
+}>;
+export type CompleteFileInput = z.infer<typeof CompleteFileInput>;
+export declare const FinishInput: z.ZodObject<{
+    cancelled: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    cancelled?: boolean | undefined;
+}, {
+    cancelled?: boolean | undefined;
+}>;
+export type FinishInput = z.infer<typeof FinishInput>;
+export declare const SessionInfoResponse: z.ZodObject<{
+    projectId: z.ZodString;
+    projectName: z.ZodString;
+    sourceFolderName: z.ZodString;
+    expectedFileCount: z.ZodNumber;
+    expectedTotalBytes: z.ZodNumber;
+    status: z.ZodEnum<["pending", "active", "complete", "revoked", "expired"]>;
+    expiresAt: z.ZodString;
+    filesDeclared: z.ZodNumber;
+    filesCompleted: z.ZodNumber;
+    bytesCompleted: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    status: "pending" | "active" | "complete" | "revoked" | "expired";
+    expiresAt: string;
+    projectId: string;
+    projectName: string;
+    sourceFolderName: string;
+    expectedFileCount: number;
+    expectedTotalBytes: number;
+    filesDeclared: number;
+    filesCompleted: number;
+    bytesCompleted: number;
+}, {
+    status: "pending" | "active" | "complete" | "revoked" | "expired";
+    expiresAt: string;
+    projectId: string;
+    projectName: string;
+    sourceFolderName: string;
+    expectedFileCount: number;
+    expectedTotalBytes: number;
+    filesDeclared: number;
+    filesCompleted: number;
+    bytesCompleted: number;
+}>;
+export type SessionInfoResponse = z.infer<typeof SessionInfoResponse>;
+//# sourceMappingURL=upload.d.ts.map

package/dist/upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../src/upload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,qBAAqB,QAA2B,CAAC;AAG9D,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAoBrC,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EASjC,CAAC;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE5E,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;EAKpC,CAAC;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAElF,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;EAWvB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS1B,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,eAAO,MAAM,iBAAiB;;;;;;EAA0C,CAAC;AACzE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE,eAAO,MAAM,WAAW;;;;;;EAAkD,CAAC;AAC3E,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAW9B,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/upload.js

@@ -0,0 +1,70 @@
+import { z } from "zod";
+// Cap individual file at 100 GB. Project-aggregate caps live elsewhere.
+export const MAX_UPLOAD_FILE_BYTES = 100 * 1024 * 1024 * 1024;
+// Cap a single declare batch at 200 entries — keeps Cloud Run request size
+// bounded and matches the recommendation in the spec (§4 step 5).
+export const DECLARE_BATCH_MAX = 200;
+// Apply NFC normalization first so macOS (NFD) and Linux (NFC) callers
+// produce byte-identical paths for the same logical file. Required for
+// the partial-unique-index dedup property (spec §5.3, §6.2 declare).
+const RelativePath = z
+    .string()
+    .min(1)
+    .max(1024)
+    .transform((p) => p.normalize("NFC"))
+    .pipe(z
+    .string()
+    .regex(/^[^/]/, "must not start with /")
+    .refine((p) => !p.includes("\\"), { message: "must not contain backslashes" })
+    .refine((p) => !p.split("/").includes(".."), { message: "must not contain .." })
+    .refine((p) => !p.includes("\0"), { message: "must not contain NUL bytes" })
+    .refine((p) => !p.endsWith("/"), { message: "must not end with /" }));
+export const InitUploadSessionInput = z.object({
+    projectId: z.string().uuid().optional(),
+    projectName: z.string().min(1).max(200).optional(),
+    projectDescription: z.string().max(2000).optional(),
+    sourceFolderName: z.string().min(1).max(200),
+    expectedFileCount: z.number().int().nonnegative(),
+    expectedTotalBytes: z.number().int().nonnegative(),
+}).refine((v) => Boolean(v.projectId) !== Boolean(v.projectName), {
+    message: "exactly one of projectId or projectName is required",
+});
+export const InitUploadSessionResponse = z.object({
+    sessionId: z.string().uuid(),
+    projectId: z.string().uuid(),
+    command: z.string(),
+    expiresAt: z.string().datetime(),
+});
+export const DeclareInput = z.object({
+    files: z
+        .array(z.object({
+        relativePath: RelativePath,
+        sizeBytes: z.number().int().nonnegative().max(MAX_UPLOAD_FILE_BYTES),
+        contentType: z.string().min(1).max(200),
+    }))
+        .min(1)
+        .max(DECLARE_BATCH_MAX),
+});
+export const DeclareResponse = z.object({
+    files: z.array(z.object({
+        fileId: z.string().uuid(),
+        relativePath: z.string(),
+        sessionUri: z.string().url().nullable(),
+        alreadyUploaded: z.boolean(),
+    })),
+});
+export const CompleteFileInput = z.object({ fileId: z.string().uuid() });
+export const FinishInput = z.object({ cancelled: z.boolean().optional() });
+export const SessionInfoResponse = z.object({
+    projectId: z.string().uuid(),
+    projectName: z.string(),
+    sourceFolderName: z.string(),
+    expectedFileCount: z.number().int().nonnegative(),
+    expectedTotalBytes: z.number().int().nonnegative(),
+    status: z.enum(["pending", "active", "complete", "revoked", "expired"]),
+    expiresAt: z.string().datetime(),
+    filesDeclared: z.number().int().nonnegative(),
+    filesCompleted: z.number().int().nonnegative(),
+    bytesCompleted: z.number().int().nonnegative(),
+});
+//# sourceMappingURL=upload.js.map

package/dist/upload.js.map

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

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@cephla/types",
+  "version": "0.1.0",
+  "private": false,
+  "description": "Shared Zod schemas and small utilities for the Cephla file-sharing platform.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "zod": "3.23.8"
+  },
+  "devDependencies": {
+    "typescript": "5.5.4",
+    "vitest": "2.0.5"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch --preserveWatchOutput",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}