@sequenceholdings/managed-functions 0.1.1

package/dist/storage.d.ts

@@ -0,0 +1,398 @@
+export declare function createFunctionStorageClient({ baseUrl, headers, mode, }: {
+    baseUrl: string;
+    headers: Record<string, string | string[] | undefined>;
+    mode?: 'user' | 'service';
+}): {
+    capabilities: () => Promise<{
+        canProvision: boolean;
+        uploadMethods: string[];
+    }>;
+    list: (options?: import("@sequenceholdings/storage").StorageListOptions) => Promise<{
+        items: {
+            id: string;
+            name: string;
+            description: string;
+            environment: string;
+            state: "active" | "trashed" | "purging";
+            revision: number;
+            createdAt: string;
+            role: "viewer" | "editor" | "admin" | "owner";
+            quotaBytes: number;
+            usedBytes: number;
+            reservedBytes: number;
+        }[];
+        nextCursor: string | null;
+    }>;
+    shared: (options?: import("@sequenceholdings/storage").StorageListOptions & {
+        trash?: boolean;
+    }) => Promise<{
+        items: {
+            id: string;
+            workspaceId: string;
+            parentId: string | null;
+            name: string;
+            kind: "file" | "folder";
+            state: "active" | "trashed" | "purging";
+            restricted: boolean;
+            revision: number;
+            currentVersionId: string | null;
+            metadata: Record<string, string>;
+            createdAt: string;
+            updatedAt: string;
+            role: "viewer" | "editor" | "admin";
+            size: number | null;
+            contentType: string | null;
+        }[];
+        nextCursor: string | null;
+    }>;
+    apply: (manifest: import("@sequenceholdings/storage").WorkspaceManifest) => Promise<{
+        id: string;
+        name: string;
+        description: string;
+        environment: string;
+        state: "active" | "trashed" | "purging";
+        revision: number;
+        createdAt: string;
+        role: "viewer" | "editor" | "admin" | "owner";
+        quotaBytes: number;
+        usedBytes: number;
+        reservedBytes: number;
+    }>;
+    workspace(id: string): {
+        get: () => Promise<{
+            id: string;
+            name: string;
+            description: string;
+            environment: string;
+            state: "active" | "trashed" | "purging";
+            revision: number;
+            createdAt: string;
+            role: "viewer" | "editor" | "admin" | "owner";
+            quotaBytes: number;
+            usedBytes: number;
+            reservedBytes: number;
+        }>;
+        delete: (expectedRevision: number) => Promise<{
+            id: string;
+            workspaceId: string;
+            targetId: string | null;
+            kind: "purge" | "delete_version";
+            status: "queued" | "running" | "succeeded" | "failed";
+            completed: number;
+            total: number;
+            error: string | null;
+            createdAt: string;
+            updatedAt: string;
+            canRetry: boolean;
+        }>;
+        list: (options?: import("@sequenceholdings/storage").StorageListOptions & {
+            parentId?: string | null;
+            trash?: boolean;
+        }) => Promise<{
+            items: {
+                id: string;
+                workspaceId: string;
+                parentId: string | null;
+                name: string;
+                kind: "file" | "folder";
+                state: "active" | "trashed" | "purging";
+                restricted: boolean;
+                revision: number;
+                currentVersionId: string | null;
+                metadata: Record<string, string>;
+                createdAt: string;
+                updatedAt: string;
+                role: "viewer" | "editor" | "admin";
+                size: number | null;
+                contentType: string | null;
+            }[];
+            nextCursor: string | null;
+        }>;
+        getNode: (id: string) => Promise<{
+            id: string;
+            workspaceId: string;
+            parentId: string | null;
+            name: string;
+            kind: "file" | "folder";
+            state: "active" | "trashed" | "purging";
+            restricted: boolean;
+            revision: number;
+            currentVersionId: string | null;
+            metadata: Record<string, string>;
+            createdAt: string;
+            updatedAt: string;
+            role: "viewer" | "editor" | "admin";
+            size: number | null;
+            contentType: string | null;
+        }>;
+        createFolder: (name: string, parentId?: string | null, { idempotencyKey, }?: {
+            idempotencyKey?: string;
+        }) => Promise<{
+            id: string;
+            workspaceId: string;
+            parentId: string | null;
+            name: string;
+            kind: "file" | "folder";
+            state: "active" | "trashed" | "purging";
+            restricted: boolean;
+            revision: number;
+            currentVersionId: string | null;
+            metadata: Record<string, string>;
+            createdAt: string;
+            updatedAt: string;
+            role: "viewer" | "editor" | "admin";
+            size: number | null;
+            contentType: string | null;
+        }>;
+        update: (id: string, input: import("zod").input<typeof import("@sequenceholdings/storage").updateNodeSchema>) => Promise<{
+            id: string;
+            workspaceId: string;
+            parentId: string | null;
+            name: string;
+            kind: "file" | "folder";
+            state: "active" | "trashed" | "purging";
+            restricted: boolean;
+            revision: number;
+            currentVersionId: string | null;
+            metadata: Record<string, string>;
+            createdAt: string;
+            updatedAt: string;
+            role: "viewer" | "editor" | "admin";
+            size: number | null;
+            contentType: string | null;
+        }>;
+        trash: (id: string, expectedRevision: number) => Promise<{
+            id: string;
+            workspaceId: string;
+            parentId: string | null;
+            name: string;
+            kind: "file" | "folder";
+            state: "active" | "trashed" | "purging";
+            restricted: boolean;
+            revision: number;
+            currentVersionId: string | null;
+            metadata: Record<string, string>;
+            createdAt: string;
+            updatedAt: string;
+            role: "viewer" | "editor" | "admin";
+            size: number | null;
+            contentType: string | null;
+        }>;
+        restore: (id: string, expectedRevision: number) => Promise<{
+            id: string;
+            workspaceId: string;
+            parentId: string | null;
+            name: string;
+            kind: "file" | "folder";
+            state: "active" | "trashed" | "purging";
+            restricted: boolean;
+            revision: number;
+            currentVersionId: string | null;
+            metadata: Record<string, string>;
+            createdAt: string;
+            updatedAt: string;
+            role: "viewer" | "editor" | "admin";
+            size: number | null;
+            contentType: string | null;
+        }>;
+        purge: (id: string, expectedRevision: number) => Promise<{
+            id: string;
+            workspaceId: string;
+            targetId: string | null;
+            kind: "purge" | "delete_version";
+            status: "queued" | "running" | "succeeded" | "failed";
+            completed: number;
+            total: number;
+            error: string | null;
+            createdAt: string;
+            updatedAt: string;
+            canRetry: boolean;
+        }>;
+        download: (id: string, options?: {
+            versionId?: string;
+            preview?: boolean;
+        }) => Promise<{
+            url: string;
+            expiresAt: string;
+            preview: boolean;
+        }>;
+        versions: (id: string, options?: {
+            before?: number;
+            limit?: number;
+        }) => Promise<{
+            items: {
+                id: string;
+                fileId: string;
+                revision: number;
+                size: number;
+                checksum: string;
+                contentType: string;
+                createdAt: string;
+                createdBy: string;
+                state: "active" | "purging";
+            }[];
+            nextRevision: number | null;
+        }>;
+        restoreVersion: (id: string, versionId: string, expectedRevision: number) => Promise<{
+            id: string;
+            fileId: string;
+            revision: number;
+            size: number;
+            checksum: string;
+            contentType: string;
+            createdAt: string;
+            createdBy: string;
+            state: "active" | "purging";
+        }>;
+        deleteVersion: (id: string, versionId: string, expectedRevision: number) => Promise<{
+            id: string;
+            workspaceId: string;
+            targetId: string | null;
+            kind: "purge" | "delete_version";
+            status: "queued" | "running" | "succeeded" | "failed";
+            completed: number;
+            total: number;
+            error: string | null;
+            createdAt: string;
+            updatedAt: string;
+            canRetry: boolean;
+        }>;
+        access: (id?: string) => Promise<{
+            revision: number;
+            restricted: boolean;
+            grants: {
+                type: "user" | "group" | "organization" | "service_account";
+                id: string;
+                role: "viewer" | "editor" | "admin";
+            }[];
+            owner: string | null;
+            inherited: boolean;
+            workspaceAdminOverride: true;
+            displayNames: Record<string, string>;
+        }>;
+        setAccess: (input: import("zod").input<typeof import("@sequenceholdings/storage").updateStorageAccessSchema>, id?: string) => Promise<{
+            revision: number;
+            restricted: boolean;
+            grants: {
+                type: "user" | "group" | "organization" | "service_account";
+                id: string;
+                role: "viewer" | "editor" | "admin";
+            }[];
+            owner: string | null;
+            inherited: boolean;
+            workspaceAdminOverride: true;
+            displayNames: Record<string, string>;
+        }>;
+        transferOwner: (principal: {
+            type: "user" | "service_account";
+            id: string;
+        }, expectedRevision: number) => Promise<{
+            revision: number;
+            restricted: boolean;
+            grants: {
+                type: "user" | "group" | "organization" | "service_account";
+                id: string;
+                role: "viewer" | "editor" | "admin";
+            }[];
+            owner: string | null;
+            inherited: boolean;
+            workspaceAdminOverride: true;
+            displayNames: Record<string, string>;
+        }>;
+        operations: (options?: {
+            before?: string;
+            limit?: number;
+            scope?: import("@sequenceholdings/storage").StorageOperationScope;
+        }) => Promise<{
+            items: {
+                id: string;
+                workspaceId: string;
+                targetId: string | null;
+                kind: "purge" | "delete_version";
+                status: "queued" | "running" | "succeeded" | "failed";
+                completed: number;
+                total: number;
+                error: string | null;
+                createdAt: string;
+                updatedAt: string;
+                canRetry: boolean;
+            }[];
+            nextCursor: string | null;
+        }>;
+        retryOperation: (id: string) => Promise<{
+            id: string;
+            workspaceId: string;
+            targetId: string | null;
+            kind: "purge" | "delete_version";
+            status: "queued" | "running" | "succeeded" | "failed";
+            completed: number;
+            total: number;
+            error: string | null;
+            createdAt: string;
+            updatedAt: string;
+            canRetry: boolean;
+        }>;
+        uploads: {
+            start: (input: import("@sequenceholdings/storage").StartStorageUpload) => Promise<{
+                id: string;
+                fileId: string;
+                uploadUrl: string | null;
+                expiresAt: string;
+                state: "pending" | "complete" | "aborted";
+                versionId: string | null;
+                maxBytes: number;
+            }>;
+            get: (id: string) => Promise<{
+                id: string;
+                fileId: string;
+                uploadUrl: string | null;
+                expiresAt: string;
+                state: "pending" | "complete" | "aborted";
+                versionId: string | null;
+                maxBytes: number;
+            }>;
+            complete: (id: string, input?: import("@sequenceholdings/storage").CompleteStorageUpload) => Promise<{
+                id: string;
+                fileId: string;
+                uploadUrl: string | null;
+                expiresAt: string;
+                state: "pending" | "complete" | "aborted";
+                versionId: string | null;
+                maxBytes: number;
+            }>;
+            abort: (id: string) => Promise<{
+                id: string;
+                fileId: string;
+                uploadUrl: string | null;
+                expiresAt: string;
+                state: "pending" | "complete" | "aborted";
+                versionId: string | null;
+                maxBytes: number;
+            }>;
+            resume(id: string, source: import("@sequenceholdings/storage").StorageUploadSource, options?: import("@sequenceholdings/storage").StorageTransferOptions & {
+                size?: number;
+            }): Promise<{
+                id: string;
+                fileId: string;
+                uploadUrl: string | null;
+                expiresAt: string;
+                state: "pending" | "complete" | "aborted";
+                versionId: string | null;
+                maxBytes: number;
+            }>;
+            put(input: Omit<import("@sequenceholdings/storage").StartStorageUpload, "idempotencyKey"> & {
+                idempotencyKey?: string;
+            }, source: import("@sequenceholdings/storage").StorageUploadSource, { keepSessionOnFailure, ...options }?: import("@sequenceholdings/storage").StorageTransferOptions & {
+                keepSessionOnFailure?: boolean;
+            }): Promise<{
+                id: string;
+                fileId: string;
+                uploadUrl: string | null;
+                expiresAt: string;
+                state: "pending" | "complete" | "aborted";
+                versionId: string | null;
+                maxBytes: number;
+            }>;
+        };
+    };
+};

package/dist/storage.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createFunctionStorageClient = createFunctionStorageClient;
+const storage_1 = require("@sequenceholdings/storage");
+function createFunctionStorageClient({ baseUrl, headers, mode = 'user', }) {
+    const token = headers[mode === 'service' ? storage_1.STORAGE_SERVICE_TOKEN_HEADER : storage_1.STORAGE_TOKEN_HEADER];
+    if (typeof token !== 'string' || !token)
+        throw new Error('Storage access is not declared for this function invocation');
+    return (0, storage_1.createStorageClient)({
+        baseUrl,
+        getHeaders: () => ({ [storage_1.STORAGE_TOKEN_HEADER]: token }),
+    });
+}

package/dist/tracing.d.ts

@@ -0,0 +1,6 @@
+import type { ServerResponse } from 'node:http';
+export declare function installFunctionTracing(): void;
+export declare function runWithFunctionTracing<T>(request: {
+    headers?: Record<string, string | string[] | undefined>;
+}, run: () => Promise<T>, response?: ServerResponse): Promise<T>;
+export declare const FUNCTION_EGRESS_SUMMARY = "traces.function_egress.summary";