@makinbakin/sdk 0.0.1-rc.4 → 0.0.1-rc.40

package/_internal/core/media/pin-data.d.ts

@@ -0,0 +1,36 @@
+/**
+ * GENERATED by scripts/generate-media-pin.ts — do not edit by hand.
+ * Regenerate: bun scripts/generate-media-pin.ts --sharp-version <v>
+ * Pin-bump runbook: .claude/knowledge/media-pipeline.md
+ * Self-contained by design: importing types from ./pin creates an import
+ * cycle (check:cycles); ./pin structurally types this object on assignment.
+ */
+export declare const SHARP_PIN_DATA: {
+    version: string;
+    shared: {
+        name: string;
+        version: string;
+        url: string;
+        sha256: string;
+    }[];
+    platform: {
+        'darwin-arm64': {
+            name: string;
+            version: string;
+            url: string;
+            sha256: string;
+        }[];
+        'linux-x64': {
+            name: string;
+            version: string;
+            url: string;
+            sha256: string;
+        }[];
+        'linux-arm64': {
+            name: string;
+            version: string;
+            url: string;
+            sha256: string;
+        }[];
+    };
+};

package/_internal/core/media/pin.d.ts

@@ -0,0 +1,22 @@
+export declare const MEDIA_PLATFORM_KEYS: readonly ["darwin-arm64", "linux-x64", "linux-arm64"];
+export type MediaPlatformKey = (typeof MEDIA_PLATFORM_KEYS)[number];
+export interface PinnedTarball {
+    name: string;
+    version: string;
+    url: string;
+    /** Lowercase hex sha256 of the npm tarball. */
+    sha256: string;
+}
+export interface SharpPin {
+    /** The pinned sharp version — also the store directory name. */
+    version: string;
+    /** Platform-neutral tarballs (sharp + its runtime JS deps). */
+    shared: PinnedTarball[];
+    /** Native + libvips tarballs per supported platform. */
+    platform: Record<MediaPlatformKey, PinnedTarball[]>;
+}
+export declare const SHARP_PIN: SharpPin;
+/** Map this process's platform/arch onto a media platform key. */
+export declare function mediaPlatformKey(): MediaPlatformKey | null;
+/** Every tarball the given platform's store needs, shared legs first. */
+export declare function pinnedTarballsFor(key: MediaPlatformKey): PinnedTarball[];

package/_internal/core/media/sharp-import.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The sharp loader's two raw import legs (#889), isolated so tests can mock
+ * them per-case (a `mock.module('sharp', …)` factory evaluates eagerly and
+ * cannot model per-test availability, and the repo's devDependency sharp
+ * would otherwise satisfy the bundled leg in every test).
+ */
+/** Bare import — resolves on dev trees/npm installs, fails in compiled binaries. */
+export declare function importBundledSharp(): Promise<unknown>;
+/** Disk import of the media store's self-contained bundle. */
+export declare function importStoreBundle(entry: string): Promise<unknown>;

package/_internal/core/media/sharp-loader.d.ts

@@ -0,0 +1,41 @@
+/**
+ * The subset of the sharp API Bakin uses, typed STRUCTURALLY — a
+ * `typeof` import of the sharp module here would put the sharp package
+ * into the declaration graph of everything that can reach this file
+ * (including the published SDK testing bundle since #703), and sharp
+ * deliberately has no declared version anywhere. Extend this interface
+ * when new call sites need more of sharp's surface.
+ */
+export interface SharpResizeOptions {
+    width?: number;
+    height?: number;
+    fit?: 'inside' | 'cover' | 'contain' | 'fill' | 'outside';
+    withoutEnlargement?: boolean;
+}
+export interface SharpPipeline {
+    rotate(): SharpPipeline;
+    resize(options: SharpResizeOptions): SharpPipeline;
+    resize(width?: number, height?: number, options?: SharpResizeOptions): SharpPipeline;
+    jpeg(options?: {
+        quality?: number;
+    }): SharpPipeline;
+    png(options?: {
+        quality?: number;
+    }): SharpPipeline;
+    webp(options?: {
+        quality?: number;
+    }): SharpPipeline;
+    metadata(): Promise<{
+        width?: number;
+        height?: number;
+        format?: string;
+    }>;
+    toFile(path: string): Promise<unknown>;
+}
+export type Sharp = (input: string) => SharpPipeline;
+/**
+ * Drop the cached load state. The installer calls this after a successful
+ * store install; tests use it between cases.
+ */
+export declare function resetSharpModuleCache(): void;
+export declare function loadSharp(): Promise<Sharp | null>;

package/_internal/core/media/store.d.ts

@@ -0,0 +1,21 @@
+import { type MediaPlatformKey } from './pin';
+export declare const MEDIA_RECEIPT_SCHEMA = 1;
+export interface MediaReceipt {
+    schema: number;
+    sharpVersion: string;
+    platform: MediaPlatformKey;
+    /** Store-relative path of the bundled sharp entry. */
+    entry: string;
+    installedAt: string;
+    tarballs: {
+        name: string;
+        version: string;
+        sha256: string;
+    }[];
+}
+/** `<bakin-home>/media/sharp/<pinned version>/` — the live store dir. */
+export declare function mediaStoreDir(): string;
+export declare function mediaReceiptPath(): string;
+export declare function readMediaReceipt(): MediaReceipt | null;
+/** The bundled sharp entry the loader imports, or null without a valid receipt. */
+export declare function mediaStoreEntry(): string | null;