@opengeni/contracts 0.40.0 → 0.50.0

package/dist/slack-task-policy.d.ts

@@ -0,0 +1,294 @@
+import { z } from "zod";
+export declare const SLACK_TASK_POLICY_ID_MAX_CHARS = 128;
+export declare const SLACK_TASK_POLICY_REASON_MAX_CHARS = 4096;
+export declare const SLACK_TASK_POLICY_MAX_IDS = 256;
+export declare const SlackSharedConversationMode: z.ZodEnum<{
+    deny: "deny";
+    private_handoff: "private_handoff";
+}>;
+export type SlackSharedConversationMode = z.infer<typeof SlackSharedConversationMode>;
+export declare const SlackResultPublicationMode: z.ZodEnum<{
+    allow: "allow";
+    approval_required: "approval_required";
+    never: "never";
+}>;
+export type SlackResultPublicationMode = z.infer<typeof SlackResultPublicationMode>;
+export declare const SlackTaskPolicyContent: z.ZodObject<{
+    allowedTeamIds: z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>;
+    allowedConversationIds: z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>;
+    allowGuestInitiators: z.ZodBoolean;
+    allowExternalInitiators: z.ZodBoolean;
+    allowMpim: z.ZodBoolean;
+    sharedConversationMode: z.ZodEnum<{
+        deny: "deny";
+        private_handoff: "private_handoff";
+    }>;
+    resultPublicationMode: z.ZodEnum<{
+        allow: "allow";
+        approval_required: "approval_required";
+        never: "never";
+    }>;
+}, z.core.$strict>;
+export type SlackTaskPolicyContent = z.infer<typeof SlackTaskPolicyContent>;
+export declare const DEFAULT_SLACK_TASK_POLICY: SlackTaskPolicyContent;
+export declare function canonicalizeSlackTaskPolicy(value: SlackTaskPolicyContent): SlackTaskPolicyContent;
+export declare const SlackTaskPolicyRevisionIdentity: z.ZodObject<{
+    id: z.ZodString;
+    revision: z.ZodNumber;
+    policyHash: z.ZodString;
+}, z.core.$strip>;
+export type SlackTaskPolicyRevisionIdentity = z.infer<typeof SlackTaskPolicyRevisionIdentity>;
+export declare const SlackTaskPolicyRevision: z.ZodObject<{
+    id: z.ZodString;
+    revision: z.ZodNumber;
+    policyHash: z.ZodString;
+    operationId: z.ZodString;
+    accountId: z.ZodString;
+    workspaceId: z.ZodString;
+    policy: z.ZodObject<{
+        allowedTeamIds: z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>;
+        allowedConversationIds: z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>;
+        allowGuestInitiators: z.ZodBoolean;
+        allowExternalInitiators: z.ZodBoolean;
+        allowMpim: z.ZodBoolean;
+        sharedConversationMode: z.ZodEnum<{
+            deny: "deny";
+            private_handoff: "private_handoff";
+        }>;
+        resultPublicationMode: z.ZodEnum<{
+            allow: "allow";
+            approval_required: "approval_required";
+            never: "never";
+        }>;
+    }, z.core.$strict>;
+    supersedesRevisionId: z.ZodNullable<z.ZodString>;
+    createdBySubjectId: z.ZodString;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+export type SlackTaskPolicyRevision = z.infer<typeof SlackTaskPolicyRevision>;
+export declare const SlackTaskPolicyHead: z.ZodObject<{
+    accountId: z.ZodString;
+    workspaceId: z.ZodString;
+    revisionId: z.ZodString;
+    revision: z.ZodNumber;
+    policyHash: z.ZodString;
+    activationVersion: z.ZodNumber;
+    activatedAt: z.ZodString;
+}, z.core.$strip>;
+export type SlackTaskPolicyHead = z.infer<typeof SlackTaskPolicyHead>;
+export declare const SlackTaskPolicyActivationEvent: z.ZodObject<{
+    id: z.ZodString;
+    operationId: z.ZodString;
+    accountId: z.ZodString;
+    workspaceId: z.ZodString;
+    activationVersion: z.ZodNumber;
+    oldRevision: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        revision: z.ZodNumber;
+        policyHash: z.ZodString;
+    }, z.core.$strip>>;
+    newRevision: z.ZodObject<{
+        id: z.ZodString;
+        revision: z.ZodNumber;
+        policyHash: z.ZodString;
+    }, z.core.$strip>;
+    actorSubjectId: z.ZodString;
+    reason: z.ZodString;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+export type SlackTaskPolicyActivationEvent = z.infer<typeof SlackTaskPolicyActivationEvent>;
+export declare const SlackTaskPolicyListResponse: z.ZodObject<{
+    current: z.ZodNullable<z.ZodObject<{
+        accountId: z.ZodString;
+        workspaceId: z.ZodString;
+        revisionId: z.ZodString;
+        revision: z.ZodNumber;
+        policyHash: z.ZodString;
+        activationVersion: z.ZodNumber;
+        activatedAt: z.ZodString;
+    }, z.core.$strip>>;
+    activeRevision: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        revision: z.ZodNumber;
+        policyHash: z.ZodString;
+        operationId: z.ZodString;
+        accountId: z.ZodString;
+        workspaceId: z.ZodString;
+        policy: z.ZodObject<{
+            allowedTeamIds: z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>;
+            allowedConversationIds: z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>;
+            allowGuestInitiators: z.ZodBoolean;
+            allowExternalInitiators: z.ZodBoolean;
+            allowMpim: z.ZodBoolean;
+            sharedConversationMode: z.ZodEnum<{
+                deny: "deny";
+                private_handoff: "private_handoff";
+            }>;
+            resultPublicationMode: z.ZodEnum<{
+                allow: "allow";
+                approval_required: "approval_required";
+                never: "never";
+            }>;
+        }, z.core.$strict>;
+        supersedesRevisionId: z.ZodNullable<z.ZodString>;
+        createdBySubjectId: z.ZodString;
+        createdAt: z.ZodString;
+    }, z.core.$strip>>;
+    revisions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        revision: z.ZodNumber;
+        policyHash: z.ZodString;
+        operationId: z.ZodString;
+        accountId: z.ZodString;
+        workspaceId: z.ZodString;
+        policy: z.ZodObject<{
+            allowedTeamIds: z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>;
+            allowedConversationIds: z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>;
+            allowGuestInitiators: z.ZodBoolean;
+            allowExternalInitiators: z.ZodBoolean;
+            allowMpim: z.ZodBoolean;
+            sharedConversationMode: z.ZodEnum<{
+                deny: "deny";
+                private_handoff: "private_handoff";
+            }>;
+            resultPublicationMode: z.ZodEnum<{
+                allow: "allow";
+                approval_required: "approval_required";
+                never: "never";
+            }>;
+        }, z.core.$strict>;
+        supersedesRevisionId: z.ZodNullable<z.ZodString>;
+        createdBySubjectId: z.ZodString;
+        createdAt: z.ZodString;
+    }, z.core.$strip>>;
+    activationEvents: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        operationId: z.ZodString;
+        accountId: z.ZodString;
+        workspaceId: z.ZodString;
+        activationVersion: z.ZodNumber;
+        oldRevision: z.ZodNullable<z.ZodObject<{
+            id: z.ZodString;
+            revision: z.ZodNumber;
+            policyHash: z.ZodString;
+        }, z.core.$strip>>;
+        newRevision: z.ZodObject<{
+            id: z.ZodString;
+            revision: z.ZodNumber;
+            policyHash: z.ZodString;
+        }, z.core.$strip>;
+        actorSubjectId: z.ZodString;
+        reason: z.ZodString;
+        createdAt: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SlackTaskPolicyListResponse = z.infer<typeof SlackTaskPolicyListResponse>;
+export declare const UpdateSlackTaskPolicyRequest: z.ZodObject<{
+    operationId: z.ZodOptional<z.ZodString>;
+    policy: z.ZodObject<{
+        allowedTeamIds: z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>;
+        allowedConversationIds: z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>;
+        allowGuestInitiators: z.ZodBoolean;
+        allowExternalInitiators: z.ZodBoolean;
+        allowMpim: z.ZodBoolean;
+        sharedConversationMode: z.ZodEnum<{
+            deny: "deny";
+            private_handoff: "private_handoff";
+        }>;
+        resultPublicationMode: z.ZodEnum<{
+            allow: "allow";
+            approval_required: "approval_required";
+            never: "never";
+        }>;
+    }, z.core.$strict>;
+    expectedCurrentRevisionId: z.ZodNullable<z.ZodString>;
+    expectedActivationVersion: z.ZodNumber;
+    reason: z.ZodString;
+}, z.core.$strip>;
+export type UpdateSlackTaskPolicyRequest = z.infer<typeof UpdateSlackTaskPolicyRequest>;
+export declare const SlackTaskPolicyMutationResponse: z.ZodObject<{
+    revision: z.ZodObject<{
+        id: z.ZodString;
+        revision: z.ZodNumber;
+        policyHash: z.ZodString;
+        operationId: z.ZodString;
+        accountId: z.ZodString;
+        workspaceId: z.ZodString;
+        policy: z.ZodObject<{
+            allowedTeamIds: z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>;
+            allowedConversationIds: z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>;
+            allowGuestInitiators: z.ZodBoolean;
+            allowExternalInitiators: z.ZodBoolean;
+            allowMpim: z.ZodBoolean;
+            sharedConversationMode: z.ZodEnum<{
+                deny: "deny";
+                private_handoff: "private_handoff";
+            }>;
+            resultPublicationMode: z.ZodEnum<{
+                allow: "allow";
+                approval_required: "approval_required";
+                never: "never";
+            }>;
+        }, z.core.$strict>;
+        supersedesRevisionId: z.ZodNullable<z.ZodString>;
+        createdBySubjectId: z.ZodString;
+        createdAt: z.ZodString;
+    }, z.core.$strip>;
+    head: z.ZodObject<{
+        accountId: z.ZodString;
+        workspaceId: z.ZodString;
+        revisionId: z.ZodString;
+        revision: z.ZodNumber;
+        policyHash: z.ZodString;
+        activationVersion: z.ZodNumber;
+        activatedAt: z.ZodString;
+    }, z.core.$strip>;
+    event: z.ZodObject<{
+        id: z.ZodString;
+        operationId: z.ZodString;
+        accountId: z.ZodString;
+        workspaceId: z.ZodString;
+        activationVersion: z.ZodNumber;
+        oldRevision: z.ZodNullable<z.ZodObject<{
+            id: z.ZodString;
+            revision: z.ZodNumber;
+            policyHash: z.ZodString;
+        }, z.core.$strip>>;
+        newRevision: z.ZodObject<{
+            id: z.ZodString;
+            revision: z.ZodNumber;
+            policyHash: z.ZodString;
+        }, z.core.$strip>;
+        actorSubjectId: z.ZodString;
+        reason: z.ZodString;
+        createdAt: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type SlackTaskPolicyMutationResponse = z.infer<typeof SlackTaskPolicyMutationResponse>;
+export type SlackTaskPolicyConversationFacts = Readonly<{
+    installationTeamId: string;
+    conversationId: string;
+    contextTeamId: string | null;
+    connectedTeamIds: readonly string[] | null;
+    sharedTeamIds: readonly string[] | null;
+    isShared: boolean;
+    isExternallyShared: boolean;
+    isOrgShared: boolean;
+    isPendingExternallyShared: boolean;
+    isMpim: boolean;
+}>;
+export type SlackTaskPolicyInitiatorFacts = Readonly<{
+    teamId: string | null;
+    isGuest: boolean | null;
+    isExternal: boolean | null;
+}>;
+export type SlackTaskPolicyDecision = Readonly<{
+    disposition: "ordinary" | "deny" | "private_handoff";
+    publication: SlackResultPublicationMode;
+    reason: "ordinary_conversation" | "policy_missing" | "conversation_not_allowed" | "team_not_allowed" | "ambiguous_shared_facts" | "mpim_not_allowed" | "guest_not_allowed" | "external_not_allowed" | "allowed";
+}>;
+export declare function evaluateSlackTaskPolicy(input: {
+    policy: SlackTaskPolicyContent | null;
+    conversation: SlackTaskPolicyConversationFacts;
+    initiator: SlackTaskPolicyInitiatorFacts;
+}): SlackTaskPolicyDecision;

package/dist/spreadsheet-artifact-commands.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Canonical, identity-free spreadsheet mutation commands nested inside
+ * `OGATX001`. Artifact, actor, transaction, delivery, and causal identity must
+ * never be added here: the outer authored-intent envelope is their sole wire
+ * authority.
+ */
+export declare const SPREADSHEET_ARTIFACT_COMMAND_VERSION: 1;
+export declare const SPREADSHEET_ARTIFACT_COMMAND_MAX_BYTES: number;
+export declare const SPREADSHEET_ARTIFACT_COMMAND_MAX_COMMANDS = 4096;
+export declare const SPREADSHEET_ARTIFACT_COMMAND_MAX_CELLS = 1000000;
+export declare const SPREADSHEET_ARTIFACT_COMMAND_MAX_STRING_BYTES: number;
+export declare const SPREADSHEET_ARTIFACT_SHEET_NAME_MAX_UTF16_UNITS = 31;
+declare const stableIdBrand: unique symbol;
+/** Fixed-width lowercase hexadecimal 128-bit id. Runtime helpers enforce use. */
+export type EditableArtifactStableId = string & {
+    readonly [stableIdBrand]: "EditableArtifactStableId";
+};
+/**
+ * A concrete sheet generation. The object id follows the offline allocator
+ * invariant (both 64-bit halves nonzero); a derived operation id reserves only
+ * the all-zero 128-bit value.
+ */
+export type SpreadsheetSheetGeneration = Readonly<{
+    kind: "generation";
+    sheetId: EditableArtifactStableId;
+    creationOperationId: EditableArtifactStableId;
+}>;
+/**
+ * Reference to a sheet created by an earlier command in this same batch.
+ * This avoids recursively embedding the creation operation id, which is
+ * derived from the hash of the complete outer intent.
+ */
+export type SpreadsheetPriorCreatePrecondition = Readonly<{
+    kind: "created-in-batch";
+    sheetId: EditableArtifactStableId;
+    createCommandIndex: number;
+}>;
+export type SpreadsheetSheetPrecondition = SpreadsheetSheetGeneration | SpreadsheetPriorCreatePrecondition;
+export type SpreadsheetCellPoint = Readonly<{
+    row: number;
+    column: number;
+}>;
+export type SpreadsheetCellRange = Readonly<{
+    start: SpreadsheetCellPoint;
+    end: SpreadsheetCellPoint;
+}>;
+export type SpreadsheetFormulaError = Readonly<{
+    error: string;
+}>;
+export type SpreadsheetDateValue = Readonly<{
+    date: string;
+}>;
+export type SpreadsheetCellScalar = null | boolean | number | string | SpreadsheetDateValue | SpreadsheetFormulaError;
+export type SpreadsheetFormulaCell = Readonly<{
+    formula: string;
+    cached: SpreadsheetCellScalar;
+}>;
+export type SpreadsheetCellInput = SpreadsheetCellScalar | SpreadsheetFormulaCell;
+export type SpreadsheetCreateSheetCommand = Readonly<{
+    kind: "sheet.create";
+    sheetId: EditableArtifactStableId;
+    name: string;
+    after: SpreadsheetSheetPrecondition | null;
+}>;
+export type SpreadsheetRenameSheetCommand = Readonly<{
+    kind: "sheet.rename";
+    sheet: SpreadsheetSheetPrecondition;
+    name: string;
+}>;
+export type SpreadsheetDeleteSheetCommand = Readonly<{
+    kind: "sheet.delete";
+    sheet: SpreadsheetSheetPrecondition;
+}>;
+/** Row-major rectangular write; `cells.length === rows * columns`. */
+export type SpreadsheetSetCellsCommand = Readonly<{
+    kind: "cells.set";
+    sheet: SpreadsheetSheetPrecondition;
+    anchor: SpreadsheetCellPoint;
+    rows: number;
+    columns: number;
+    cells: readonly SpreadsheetCellInput[];
+}>;
+export type SpreadsheetClearRangeCommand = Readonly<{
+    kind: "range.clear";
+    sheet: SpreadsheetSheetPrecondition;
+    range: SpreadsheetCellRange;
+}>;
+export type SpreadsheetArtifactCommand = SpreadsheetCreateSheetCommand | SpreadsheetRenameSheetCommand | SpreadsheetDeleteSheetCommand | SpreadsheetSetCellsCommand | SpreadsheetClearRangeCommand;
+export type SpreadsheetArtifactCommandBatch = Readonly<{
+    version: typeof SPREADSHEET_ARTIFACT_COMMAND_VERSION;
+    commands: readonly SpreadsheetArtifactCommand[];
+}>;
+/** Validates a generic nonzero 128-bit id and returns its nominal type. */
+export declare function editableArtifactStableId(value: string): EditableArtifactStableId;
+/** Validates a sheet object id with nonzero allocator namespace and counter. */
+export declare function spreadsheetSheetId(value: string): EditableArtifactStableId;
+export declare function encodeSpreadsheetArtifactCommandBatch(input: SpreadsheetArtifactCommandBatch): Uint8Array;
+export declare function decodeSpreadsheetArtifactCommandBatch(bytes: Uint8Array): SpreadsheetArtifactCommandBatch;
+/** Decodes, re-encodes, and proves byte-for-byte canonicality. */
+export declare function assertCanonicalSpreadsheetArtifactCommandBytes(bytes: Uint8Array): Uint8Array;
+export {};

package/dist/spreadsheet-artifact-commands.js

@@ -0,0 +1,27 @@
+import {
+  SPREADSHEET_ARTIFACT_COMMAND_MAX_BYTES,
+  SPREADSHEET_ARTIFACT_COMMAND_MAX_CELLS,
+  SPREADSHEET_ARTIFACT_COMMAND_MAX_COMMANDS,
+  SPREADSHEET_ARTIFACT_COMMAND_MAX_STRING_BYTES,
+  SPREADSHEET_ARTIFACT_COMMAND_VERSION,
+  SPREADSHEET_ARTIFACT_SHEET_NAME_MAX_UTF16_UNITS,
+  assertCanonicalSpreadsheetArtifactCommandBytes,
+  decodeSpreadsheetArtifactCommandBatch,
+  editableArtifactStableId,
+  encodeSpreadsheetArtifactCommandBatch,
+  spreadsheetSheetId
+} from "./chunk-LSB7GRLG.js";
+export {
+  SPREADSHEET_ARTIFACT_COMMAND_MAX_BYTES,
+  SPREADSHEET_ARTIFACT_COMMAND_MAX_CELLS,
+  SPREADSHEET_ARTIFACT_COMMAND_MAX_COMMANDS,
+  SPREADSHEET_ARTIFACT_COMMAND_MAX_STRING_BYTES,
+  SPREADSHEET_ARTIFACT_COMMAND_VERSION,
+  SPREADSHEET_ARTIFACT_SHEET_NAME_MAX_UTF16_UNITS,
+  assertCanonicalSpreadsheetArtifactCommandBytes,
+  decodeSpreadsheetArtifactCommandBatch,
+  editableArtifactStableId,
+  encodeSpreadsheetArtifactCommandBatch,
+  spreadsheetSheetId
+};
+//# sourceMappingURL=spreadsheet-artifact-commands.js.map

package/dist/spreadsheet-artifact-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/spreadsheet-artifact-date.d.ts

@@ -0,0 +1,4 @@
+/** Parses only the exact string form emitted by `Date.prototype.toISOString`. */
+export declare function canonicalSpreadsheetDateMilliseconds(value: unknown): number;
+/** Converts a signed wire integer to a canonical ISO instant without lossy coercion. */
+export declare function canonicalSpreadsheetDateFromMilliseconds(milliseconds: bigint): string;

package/dist/spreadsheet-artifact-query.d.ts

@@ -0,0 +1,120 @@
+import { type EditableArtifactStableId } from "./spreadsheet-artifact-commands.js";
+/** Canonical private kernel query/projection ABI shared by browser and native bindings. */
+export declare const SPREADSHEET_ARTIFACT_QUERY_VERSION: 1;
+export declare const SPREADSHEET_ARTIFACT_QUERY_MAX_BYTES = 68;
+export declare const SPREADSHEET_ARTIFACT_PROJECTION_MAX_BYTES: number;
+export declare const SPREADSHEET_ARTIFACT_VIEWPORT_MAX_AREA = 1048576;
+export declare const SPREADSHEET_ARTIFACT_VIEWPORT_MAX_CELLS = 262144;
+export declare const SPREADSHEET_ARTIFACT_METADATA_MAX_SHEETS = 10000;
+export declare const SPREADSHEET_ARTIFACT_PROJECTION_MAX_STRING_BYTES: number;
+export declare const SPREADSHEET_ARTIFACT_VIEWPORT_MIN_RESPONSE_BYTES = 92;
+export declare const SPREADSHEET_ARTIFACT_METADATA_MIN_RESPONSE_BYTES = 48;
+export type SpreadsheetArtifactViewportQuery = Readonly<{
+    sheetId: EditableArtifactStableId;
+    startRow: number;
+    startColumn: number;
+    rowCount: number;
+    columnCount: number;
+    maxCells: number;
+    /** Entire OGAKV001 envelope, not merely its payload. */
+    maxBytes: number;
+}>;
+export type SpreadsheetArtifactMetadataQuery = Readonly<{
+    maxSheets: number;
+    /** Entire OGAKV001 envelope, not merely its payload. */
+    maxBytes: number;
+}>;
+export type SpreadsheetArtifactKernelQuery = Readonly<{
+    kind: "viewport";
+    query: SpreadsheetArtifactViewportQuery;
+}> | Readonly<{
+    kind: "workbook-metadata";
+    query: SpreadsheetArtifactMetadataQuery;
+}>;
+export type SpreadsheetArtifactFormulaError = "null" | "divide_by_zero" | "value" | "reference" | "name" | "number" | "not_available" | "spill" | "calculation" | Readonly<{
+    custom: string;
+}>;
+export type SpreadsheetArtifactProjectedCellValue = Readonly<{
+    kind: "empty";
+}> | Readonly<{
+    kind: "boolean";
+    value: boolean;
+}> | Readonly<{
+    kind: "number";
+    value: number;
+}> | Readonly<{
+    kind: "date";
+    value: string;
+}> | Readonly<{
+    kind: "text";
+    value: string;
+}> | Readonly<{
+    kind: "error";
+    value: SpreadsheetArtifactFormulaError;
+}>;
+export type SpreadsheetArtifactProjectedCell = Readonly<{
+    /** Absolute zero-based row, reconstructed from the relative wire coordinate. */
+    row: number;
+    /** Absolute zero-based column, reconstructed from the relative wire coordinate. */
+    column: number;
+    formula: string | null;
+    value: SpreadsheetArtifactProjectedCellValue;
+}>;
+/** Complete and non-truncated. A limit breach is an error, never a partial response. */
+export type SpreadsheetArtifactViewportProjection = Readonly<{
+    revision: bigint;
+    sheetId: EditableArtifactStableId;
+    generationId: EditableArtifactStableId | null;
+    startRow: number;
+    startColumn: number;
+    rowCount: number;
+    columnCount: number;
+    cells: readonly SpreadsheetArtifactProjectedCell[];
+}>;
+export type SpreadsheetArtifactUsedBounds = Readonly<{
+    startRow: number;
+    startColumn: number;
+    endRow: number;
+    endColumn: number;
+}>;
+export type SpreadsheetArtifactSheetMetadata = Readonly<{
+    sheetId: EditableArtifactStableId;
+    generationId: EditableArtifactStableId | null;
+    name: string;
+    usedBounds: SpreadsheetArtifactUsedBounds | null;
+}>;
+/**
+ * Version 1 deliberately models no row/column dimensions, hidden state, or
+ * merges. It also carries no style projection. These are false capability
+ * facts, not omitted authoritative data.
+ */
+export type SpreadsheetArtifactModeledFeatures = Readonly<{
+    dimensions: false;
+    hidden: false;
+    merges: false;
+}>;
+/** Complete ordered workbook catalog; never a truncated prefix. */
+export type SpreadsheetArtifactMetadataProjection = Readonly<{
+    revision: bigint;
+    modeledFeatures: SpreadsheetArtifactModeledFeatures;
+    sheets: readonly SpreadsheetArtifactSheetMetadata[];
+}>;
+export type SpreadsheetArtifactKernelProjection = Readonly<{
+    kind: "viewport";
+    projection: SpreadsheetArtifactViewportProjection;
+}> | Readonly<{
+    kind: "workbook-metadata";
+    projection: SpreadsheetArtifactMetadataProjection;
+}>;
+export declare function encodeSpreadsheetViewportKernelQuery(input: SpreadsheetArtifactViewportQuery): Uint8Array;
+export declare function encodeSpreadsheetMetadataKernelQuery(input: SpreadsheetArtifactMetadataQuery): Uint8Array;
+export declare function encodeSpreadsheetArtifactKernelQuery(input: SpreadsheetArtifactKernelQuery): Uint8Array;
+export declare function decodeSpreadsheetArtifactKernelQuery(bytes: Uint8Array): SpreadsheetArtifactKernelQuery;
+export declare function assertCanonicalSpreadsheetArtifactKernelQueryBytes(bytes: Uint8Array): Uint8Array;
+export declare function encodeSpreadsheetViewportKernelProjection(input: SpreadsheetArtifactViewportProjection, maximumBytes?: number): Uint8Array;
+export declare function encodeSpreadsheetMetadataKernelProjection(input: SpreadsheetArtifactMetadataProjection, maximumBytes?: number): Uint8Array;
+export declare function encodeSpreadsheetArtifactKernelProjection(input: SpreadsheetArtifactKernelProjection, maximumBytes?: number): Uint8Array;
+export declare function decodeSpreadsheetArtifactKernelProjection(bytes: Uint8Array): SpreadsheetArtifactKernelProjection;
+export declare function decodeSpreadsheetViewportKernelProjection(bytes: Uint8Array, expected?: SpreadsheetArtifactViewportQuery): SpreadsheetArtifactViewportProjection;
+export declare function decodeSpreadsheetMetadataKernelProjection(bytes: Uint8Array, expected?: SpreadsheetArtifactMetadataQuery): SpreadsheetArtifactMetadataProjection;
+export declare function assertCanonicalSpreadsheetArtifactKernelProjectionBytes(bytes: Uint8Array): Uint8Array;

package/dist/spreadsheet-artifact-query.js

@@ -0,0 +1,48 @@
+import {
+  SPREADSHEET_ARTIFACT_METADATA_MAX_SHEETS,
+  SPREADSHEET_ARTIFACT_METADATA_MIN_RESPONSE_BYTES,
+  SPREADSHEET_ARTIFACT_PROJECTION_MAX_BYTES,
+  SPREADSHEET_ARTIFACT_PROJECTION_MAX_STRING_BYTES,
+  SPREADSHEET_ARTIFACT_QUERY_MAX_BYTES,
+  SPREADSHEET_ARTIFACT_QUERY_VERSION,
+  SPREADSHEET_ARTIFACT_VIEWPORT_MAX_AREA,
+  SPREADSHEET_ARTIFACT_VIEWPORT_MAX_CELLS,
+  SPREADSHEET_ARTIFACT_VIEWPORT_MIN_RESPONSE_BYTES,
+  assertCanonicalSpreadsheetArtifactKernelProjectionBytes,
+  assertCanonicalSpreadsheetArtifactKernelQueryBytes,
+  decodeSpreadsheetArtifactKernelProjection,
+  decodeSpreadsheetArtifactKernelQuery,
+  decodeSpreadsheetMetadataKernelProjection,
+  decodeSpreadsheetViewportKernelProjection,
+  encodeSpreadsheetArtifactKernelProjection,
+  encodeSpreadsheetArtifactKernelQuery,
+  encodeSpreadsheetMetadataKernelProjection,
+  encodeSpreadsheetMetadataKernelQuery,
+  encodeSpreadsheetViewportKernelProjection,
+  encodeSpreadsheetViewportKernelQuery
+} from "./chunk-CADSX6UN.js";
+import "./chunk-LSB7GRLG.js";
+export {
+  SPREADSHEET_ARTIFACT_METADATA_MAX_SHEETS,
+  SPREADSHEET_ARTIFACT_METADATA_MIN_RESPONSE_BYTES,
+  SPREADSHEET_ARTIFACT_PROJECTION_MAX_BYTES,
+  SPREADSHEET_ARTIFACT_PROJECTION_MAX_STRING_BYTES,
+  SPREADSHEET_ARTIFACT_QUERY_MAX_BYTES,
+  SPREADSHEET_ARTIFACT_QUERY_VERSION,
+  SPREADSHEET_ARTIFACT_VIEWPORT_MAX_AREA,
+  SPREADSHEET_ARTIFACT_VIEWPORT_MAX_CELLS,
+  SPREADSHEET_ARTIFACT_VIEWPORT_MIN_RESPONSE_BYTES,
+  assertCanonicalSpreadsheetArtifactKernelProjectionBytes,
+  assertCanonicalSpreadsheetArtifactKernelQueryBytes,
+  decodeSpreadsheetArtifactKernelProjection,
+  decodeSpreadsheetArtifactKernelQuery,
+  decodeSpreadsheetMetadataKernelProjection,
+  decodeSpreadsheetViewportKernelProjection,
+  encodeSpreadsheetArtifactKernelProjection,
+  encodeSpreadsheetArtifactKernelQuery,
+  encodeSpreadsheetMetadataKernelProjection,
+  encodeSpreadsheetMetadataKernelQuery,
+  encodeSpreadsheetViewportKernelProjection,
+  encodeSpreadsheetViewportKernelQuery
+};
+//# sourceMappingURL=spreadsheet-artifact-query.js.map

package/dist/spreadsheet-artifact-query.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}