@lynxship/contracts 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,154 @@
+export type Platform = "android" | "ios";
+export type BuildState = "created" | "uploading_source" | "queued" | "provisioning" | "installing_dependencies" | "building" | "signing" | "uploading_artifacts" | "success" | "failed" | "canceled" | "timed_out";
+export type Role = "owner" | "admin" | "developer" | "viewer";
+export interface ErrorDetails {
+    [key: string]: unknown;
+}
+export declare class LynxShipError extends Error {
+    readonly code: string;
+    readonly details: ErrorDetails;
+    constructor(code: string, message: string, details?: ErrorDetails);
+}
+export declare function assert(condition: unknown, code: string, message: string, details?: ErrorDetails): asserts condition;
+export interface BuildJob {
+    id: string;
+    projectId: string;
+    organizationId: string;
+    platform: Platform;
+    profile: string;
+    sourceHash: string | null;
+    runtimeVersion?: string;
+    runtimeInputs?: Record<string, unknown>;
+    state: BuildState;
+    attempts: number;
+    logs: Array<{
+        level: string;
+        message: string;
+        at: string;
+    }>;
+    transitions: Array<{
+        state: BuildState;
+        reason?: string;
+        at: string;
+    }>;
+    artifact?: {
+        name: string;
+        hash: string;
+        path?: string;
+        key?: string;
+        size?: number;
+        contentType?: string;
+        url?: string;
+        expiresAt?: string;
+    };
+}
+export interface BuildResult {
+    artifact?: {
+        name: string;
+        hash: string;
+    };
+    logs?: Array<{
+        level: string;
+        message: string;
+        at: string;
+    }>;
+}
+export interface WorkerRequest {
+    platform: Platform;
+    capabilities?: string[];
+}
+export interface WorkerHandle {
+    id: string;
+    platform: Platform;
+    providerId: string;
+}
+export interface SubmissionJob {
+    id: string;
+    projectId: string;
+    organizationId: string;
+    platform: Platform;
+    artifact: {
+        hash: string;
+    };
+    status: string;
+    createdAt: string;
+    remoteId?: string;
+    source?: string;
+    [key: string]: unknown;
+}
+export interface Worker {
+    id: string;
+    name: string;
+    organizationId: string;
+    platform: Platform;
+    capabilities: Record<string, unknown>;
+    status: "ready" | "offline" | "draining" | "revoked";
+    registeredAt: string;
+    lastHeartbeatAt: string;
+}
+export interface Artifact {
+    key: string;
+    hash: string;
+    size: number;
+    contentType: string;
+}
+export interface Release {
+    id: string;
+    manifest: OtaManifest;
+    signature: string;
+    message: string;
+    rollout: number;
+    paused: boolean;
+    createdAt: string;
+    policy: {
+        verdict: string;
+        reason: string;
+    };
+}
+export interface OtaManifest {
+    protocolVersion: number;
+    projectId: string;
+    channel: string;
+    platform: Platform;
+    runtimeVersion: string;
+    sequence: number;
+    keyId: string;
+    assets: Array<{
+        path: string;
+        hash: string;
+        size: number;
+        url?: string;
+    }>;
+}
+export interface Channel {
+    name: string;
+    projectId: string;
+    releases: string[];
+    current: string | null;
+    lastRollback?: {
+        releaseId: string;
+        reason: string;
+        at: string;
+    };
+}
+export interface Organization {
+    id: string;
+    name: string;
+    createdAt: string;
+}
+export interface Project {
+    id: string;
+    organizationId: string;
+    name: string;
+    createdAt: string;
+}
+export interface Membership {
+    organizationId: string;
+    userId: string;
+    role: Role;
+}
+export declare function canonicalize(value: unknown): string;
+export declare function sha256(value: string | Buffer): string;
+export declare function hashJson(value: unknown): string;
+export declare function createId(prefix: string): string;
+//# 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":"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"}

package/dist/index.js

@@ -0,0 +1,39 @@
+import { createHash, randomBytes } from "node:crypto";
+export class LynxShipError extends Error {
+    code;
+    details;
+    constructor(code, message, details = {}) {
+        super(message);
+        this.name = "LynxShipError";
+        this.code = code;
+        this.details = details;
+    }
+}
+export function assert(condition, code, message, details) {
+    if (!condition)
+        throw new LynxShipError(code, message, details);
+}
+export function canonicalize(value) {
+    if (value === null || typeof value !== "object")
+        return JSON.stringify(value);
+    if (Array.isArray(value))
+        return `[${value.map(canonicalize).join(",")}]`;
+    return `{${Object.keys(value)
+        .sort()
+        .map((key) => `${JSON.stringify(key)}:${canonicalize(value[key])}`)
+        .join(",")}}`;
+}
+export function sha256(value) {
+    const hash = createHash("sha256");
+    if (typeof value === "string")
+        hash.update(value);
+    else
+        hash.update(value.toString("latin1"), "latin1");
+    return hash.digest("hex");
+}
+export function hashJson(value) {
+    return sha256(canonicalize(value));
+}
+export function createId(prefix) {
+    return `${prefix}_${Date.now().toString(36)}_${randomBytes(5).toString("hex")}`;
+}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@lynxship/contracts",
+  "version": "0.1.0",
+  "description": "Shared LynxShip contracts, identifiers, hashing and validation helpers.",
+  "type": "module",
+  "license": "MIT",
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -b tsconfig.json",
+    "typecheck": "tsc -b tsconfig.json --pretty false"
+  }
+}