@clipwright/core 0.34.0 → 0.36.0

package/dist/reference-analysis.js

@@ -0,0 +1,210 @@
+import { z } from "zod";
+import { assetId } from "./asset-identity.js";
+import { ASSET_VIDEO_MAX_SECONDS } from "./assets.js";
+import { MAX_REFERENCE_TRANSCRIPT_WORDS, referenceHook, referenceProfile, referenceWord } from "./reference-profile.js";
+/** Reference analysis (reference-to-video S1c): an MP4 asset read into a `reference_profile`. Its status lives at its own */
+/** path, as an asset's processing does; its money (#927) rides a run of skill `analyze_reference` that holds and settles it. */
+export const REFERENCE_ANALYSES_PATH = "/v1/reference-analyses";
+export const REFERENCE_ANALYSIS_PATH = "/v1/reference-analyses/:id";
+export const REFERENCE_ANALYSIS_QUOTE_PATH = "/v1/reference-analyses/quote";
+export const ANALYZE_REFERENCE_TASK = "analyze-reference";
+/** The run skill that carries an analysis's hold and charge; not a `SKILLS` entry, since no `/v1/skills` route starts it. */
+export const ANALYZE_REFERENCE_SKILL = "analyze_reference";
+export const referenceAnalysisId = z.string().regex(/^ref_[a-f0-9]{32}$/);
+/** The price of a delivered analysis. */
+export const REFERENCE_ANALYSIS_CREDITS = 70;
+/** The data mode: metrics, transcript and a frame sheet without the vision pass. */
+export const REFERENCE_DATA_CREDITS = 10;
+/** `full` reads the reference into a profile; `data` hands back its numbers, words and a frame sheet, with no vision call. */
+export const REFERENCE_ANALYSIS_MODES = ["full", "data"];
+export const REFERENCE_ANALYSIS_MODE_CREDITS = {
+    full: REFERENCE_ANALYSIS_CREDITS, data: REFERENCE_DATA_CREDITS,
+};
+/** New analyses per account per hour: each costs us vendor money even when it fails, so the cap stays beside the price. */
+export const REFERENCE_ANALYSIS_PER_HOUR = 10;
+/** The data mode's own cap, scope `reference_data`: cheap enough to run on every candidate reel of a search (#921). */
+export const REFERENCE_DATA_PER_HOUR = 60;
+export const REFERENCE_DATA_SHEET_COLUMNS = 3;
+export const REFERENCE_DATA_SHEET_ROWS = 3;
+export const REFERENCE_DATA_SHEET_MAX_WIDTH = 1080;
+export const REFERENCE_ANALYSIS_WINDOW_SECONDS = 3600;
+/** The analysis stops here and fails; under the task's ceiling. */
+export const REFERENCE_ANALYSIS_WORK_SECONDS = 420;
+export const REFERENCE_ANALYSIS_TASK_MAX_DURATION_SECONDS = 600;
+/** Past this a read calls an unfinished analysis failed: a task killed at its ceiling writes nothing. */
+export const REFERENCE_ANALYSIS_DEADLINE_SECONDS = 900;
+export const REFERENCE_ANALYSIS_STATES = ["queued", "analyzing", "succeeded", "failed"];
+export const REFERENCE_ANALYSIS_ERRORS = ["timed_out", "analysis_failed", "asset_gone", "enqueue_failed"];
+export const REFERENCE_ANALYSIS_ERROR_MESSAGES = {
+    timed_out: "the analysis did not finish in time and was stopped; start it again",
+    analysis_failed: "the reference could not be analysed; start it again or use another clip",
+    asset_gone: "the asset was deleted before the analysis began",
+    enqueue_failed: "the analysis could not be started; start it again",
+};
+/** What starts an analysis: ids only, so no file name or reference text reaches a log. */
+export const analyzeReferencePayload = z.strictObject({ analysisId: referenceAnalysisId, accountId: z.string().min(1) });
+export const REFERENCE_SOURCE_PLATFORMS = ["instagram", "tiktok"];
+/** The live analysis a link replays is found by this key; a short TikTok link has none before it is resolved. */
+export const referenceSourceKey = z.string().regex(/^(instagram|tiktok):[A-Za-z0-9_-]{1,64}$/);
+export const REFERENCE_URL_YOUTUBE_REFUSAL = "YouTube gives no video file through our source; upload the MP4 with create_asset";
+export const REFERENCE_URL_ACCEPTED = "an Instagram reel or post link (instagram.com/reel/<code>, /reels/<code>, /p/<code>) or a TikTok " +
+    "video link (tiktok.com/@<user>/video/<id>, vm.tiktok.com/<code>)";
+const INSTAGRAM_HOSTS = new Set(["instagram.com", "www.instagram.com", "m.instagram.com"]);
+const TIKTOK_HOSTS = new Set(["tiktok.com", "www.tiktok.com", "m.tiktok.com"]);
+const YOUTUBE_HOSTS = new Set(["youtube.com", "www.youtube.com", "m.youtube.com", "music.youtube.com", "youtu.be", "www.youtu.be"]);
+/** Which post a link names, read from its text alone: no network, so a refusal costs nothing (#930 S3). */
+export function classifyReferenceUrl(raw) {
+    let url;
+    try {
+        url = new URL(raw);
+    }
+    catch {
+        return { ok: false, message: `source_url is not a link; pass ${REFERENCE_URL_ACCEPTED}` };
+    }
+    const host = url.hostname.toLowerCase();
+    if (YOUTUBE_HOSTS.has(host))
+        return { ok: false, message: REFERENCE_URL_YOUTUBE_REFUSAL };
+    if (url.protocol === "https:" && url.username === "" && url.password === "" && (url.port === "" || url.port === "443")) {
+        const path = url.pathname;
+        const instagram = INSTAGRAM_HOSTS.has(host) ? /^\/(?:reel|reels|p)\/([A-Za-z0-9_-]{5,64})\/?$/.exec(path) : null;
+        if (instagram)
+            return { ok: true, url: url.href, platform: "instagram", key: `instagram:${instagram[1]}` };
+        const tiktok = TIKTOK_HOSTS.has(host) ? /^\/@[A-Za-z0-9_.-]{1,64}\/video\/(\d{5,32})\/?$/.exec(path) : null;
+        if (tiktok)
+            return { ok: true, url: url.href, platform: "tiktok", key: `tiktok:${tiktok[1]}` };
+        if (host === "vm.tiktok.com" && /^\/[A-Za-z0-9]{4,32}\/?$/.test(path))
+            return { ok: true, url: url.href, platform: "tiktok", key: null };
+    }
+    return { ok: false, message: `${host} ${url.pathname} is not a link we read; pass ${REFERENCE_URL_ACCEPTED}` };
+}
+export const analyzeReferenceRequest = z.strictObject({
+    asset_id: assetId.optional().describe(`asset_id of an MP4 asset of this account, at most ${ASSET_VIDEO_MAX_SECONDS} s and 100 MiB`),
+    source_url: z.string().url().startsWith("https://").max(2048).optional()
+        .describe(`instead of asset_id: ${REFERENCE_URL_ACCEPTED}; YouTube is refused`),
+    mode: z.enum(REFERENCE_ANALYSIS_MODES).optional().describe(`full (default, ${REFERENCE_ANALYSIS_CREDITS} credits): the reference_profile. ` +
+        `data (${REFERENCE_DATA_CREDITS} credits): duration, size, timed transcript, hook and a 3×3 frame sheet, without the vision pass`),
+}).refine((request) => (request.asset_id === undefined) !== (request.source_url === undefined), {
+    message: "pass exactly one of asset_id or source_url",
+});
+const count = z.number().int().nonnegative().nullable();
+const authorMedian = z.strictObject({ views: z.number().nonnegative().nullable(), ratio: z.number().nonnegative().nullable(),
+    reels: z.number().int().nonnegative(), window: z.string().min(1) }).nullable();
+/** The post behind a link analysis (#930 S3): `null` is unknown, never 0, and each unknown is also a line in `warnings[]`. */
+export const referenceSource = z.strictObject({
+    url: z.string().url(),
+    platform: z.enum(REFERENCE_SOURCE_PLATFORMS),
+    key: referenceSourceKey,
+    measured_at: z.string().datetime(),
+    published_at: z.string().datetime().nullable(),
+    duration_s: z.number().positive().nullable(),
+    metrics: z.strictObject({ views: count, likes: count, comments: count, views_per_hour: z.number().nonnegative().nullable() }),
+    /** The median of the author's reels within ±30 days of the post, the post excluded. */
+    author_median: authorMedian,
+    /** The median of the author's 12 latest reels, the post excluded. */
+    author_recent: authorMedian,
+    top_comments: z.array(z.strictObject({ text: z.string().min(1).max(300), likes: count })).max(10),
+    code_words: z.array(z.strictObject({ word: z.string().min(1).max(24), count: z.number().int().min(2) })),
+});
+const frameSheet = z.strictObject({
+    columns: z.number().int().positive(),
+    rows: z.number().int().positive(),
+    /** Each frame's second, row by row; every one inside the reel. */
+    times_s: z.array(z.number().nonnegative()).min(1),
+});
+const dataWords = { transcript: z.array(referenceWord).max(MAX_REFERENCE_TRANSCRIPT_WORDS),
+    /** `null` when no word starts in the first seconds; no caption, since no vision pass read the screen. */
+    hook: referenceHook.nullable() };
+const dataProbe = { duration_s: z.number().positive(), width: z.number().int().positive(), height: z.number().int().positive(),
+    fps: z.number().positive() };
+/** What a succeeded data analysis hands back (#930 S4): the probe, the transcribed words as the profile writes them, and a frame sheet. */
+export const referenceData = z.strictObject({
+    ...dataProbe,
+    ...dataWords,
+    /** `url` is signed for 7 days on each read; `null` once the sheet passed the renders' 30 days in storage, said in `warnings[]`. */
+    frame_sheet: frameSheet.extend({ url: z.string().url().nullable() }),
+});
+/** What the data pass answers: the words, the sheet it uploaded and its warnings. */
+export const referenceDataPass = z.strictObject({ ...dataWords, frame_sheet: frameSheet, cost_usd: z.number().nonnegative(),
+    warnings: z.array(z.string()) });
+/** The row's `data`: the answer with the sheet's R2 key in place of its link, and our vendor cost, which no client reads. */
+export const referenceDataStored = z.strictObject({ ...dataProbe, ...dataWords, frame_sheet: frameSheet.extend({ key: z.string().min(1) }),
+    cost_usd: z.number().nonnegative() });
+export const referenceAnalysis = z.strictObject({
+    analysis_id: referenceAnalysisId,
+    asset_id: assetId,
+    /** `full` or `data` (#930 S4); an analysis started before the modes is `full`. */
+    mode: z.enum(REFERENCE_ANALYSIS_MODES),
+    state: z.enum(REFERENCE_ANALYSIS_STATES),
+    /** Set once a full analysis succeeded, `null` before, on failure and for a data analysis. */
+    reference_profile: referenceProfile.nullable(),
+    /** Set once a data analysis succeeded, `null` before, on failure and for a full analysis. */
+    data: referenceData.nullable(),
+    /** The post's numbers, comments and code words for an analysis started by `source_url`; `null` for an asset start. */
+    source: referenceSource.nullable(),
+    warnings: z.array(z.string()),
+    error: z.strictObject({ code: z.enum(REFERENCE_ANALYSIS_ERRORS), message: z.string().min(1) }).nullable(),
+    /** Held at the start; 0 for an analysis started before it was paid (#927). */
+    credits_reserved: z.number().int().nonnegative(),
+    /** Set at settlement: the price once succeeded, 0 once failed; `null` while it runs. */
+    credits_charged: z.number().int().nonnegative().nullable(),
+    /** The account's balance right after the settlement, read in its transaction; `null` until settled. */
+    balance_after_credits: z.number().int().nullable(),
+    created_at: z.string().datetime(),
+    finished_at: z.string().datetime().nullable(),
+});
+export const analysisQuoteResponse = z.strictObject({
+    /** The quoted asset; for a `source_url`, the asset of the analysis it replays, else `null` (its asset is made at the start). */
+    asset_id: assetId.nullable(),
+    /** What starting it now holds and, once it succeeds, charges: 0 when the asset already has a live analysis to answer. */
+    credits_estimate: z.number().int().nonnegative(),
+    /** The analysis a start would answer for free, or `null` when a start would begin a new, paid one. */
+    replays_analysis_id: referenceAnalysisId.nullable(),
+    warnings: z.array(z.string()),
+});
+/** What a client reads: a new state, error code or profile field must not break an installed client. */
+export const referenceAnalysisRead = referenceAnalysis.extend({
+    state: z.string(),
+    reference_profile: z.record(z.string(), z.unknown()).nullable(),
+    error: z.object({ code: z.string(), message: z.string() }).nullable(),
+    // A server from before #930 S3 sends no source; a later one may add metrics this client does not know.
+    source: z.record(z.string(), z.unknown()).nullable().optional(),
+    // A server from before #930 S4 sends neither mode nor data.
+    mode: z.string().optional(),
+    data: z.record(z.string(), z.unknown()).nullable().optional(),
+    // A server from before #927 sends no money fields.
+    credits_reserved: referenceAnalysis.shape.credits_reserved.optional(),
+    credits_charged: referenceAnalysis.shape.credits_charged.optional(),
+    balance_after_credits: referenceAnalysis.shape.balance_after_credits.optional(),
+});
+/** Rule 3: every element we cannot draw is said in `warnings[]` too, not only inside the profile. */
+export function referenceAnalysisWarnings(profile) {
+    return [...profile.unmapped.map((entry) => `beat ${entry.beat_index}: ${entry.what} is not drawn by our templates; substitute: ${entry.suggested_substitute}`), ...profile.analysis.warnings ?? []];
+}
+export const ANALYZE_REFERENCE_DESCRIPTION = "Read a reference ad into a reference_profile: its beats (role, timing as shares of the clip, whether the presenter " +
+    "speaks, listens or is off screen), the graphics in our template vocabulary, captions, pacing, palette and music. " +
+    "It keeps the reference's words: transcript (timed words), hook (the words of its first 3 s, through the end of that sentence), each beat's spoken_summary " +
+    "and each graphic's label_hint. " +
+    "What we cannot draw is in unmapped with a substitute and in warnings. Pass asset_id of an MP4 asset (create_asset " +
+    `with kind: "video"), at most ${ASSET_VIDEO_MAX_SECONDS} s and 100 MiB, or source_url: ${REFERENCE_URL_ACCEPTED}. ` +
+    "A link becomes an analysis-only asset of this account (asset_id in the answer) and the answer's source carries the " +
+    "post's views, likes, comments, views per hour, the author's median views around it and over their 12 latest reels, each with the ratio, the top comments " +
+    "and the code words commenters repeat; a number the platform did not give is null and named in warnings. A YouTube " +
+    "link is refused: upload its MP4 with create_asset. " +
+    `mode: "data" skips the vision pass and answers data instead of a profile: duration, size and fps, the timed ` +
+    "transcript, the hook and a 3×3 frame sheet (a signed JPEG link), with source for a link as above; a reel with no " +
+    `speech gives an empty transcript and a warning. ${REFERENCE_ANALYSIS_CREDITS} credits for full, ${REFERENCE_DATA_CREDITS} ` +
+    "for data, held at the start and charged once it succeeds; a failed analysis costs nothing. " +
+    `${REFERENCE_ANALYSIS_PER_HOUR} new full and ${REFERENCE_DATA_PER_HOUR} new data analyses per hour per account. ` +
+    "Answers at once with state queued; call get_reference_analysis every 10 seconds until succeeded (about a minute) or " +
+    "failed. The same asset, or the same reel by its full link, in the same mode returns the same analysis, free, unless it " +
+    "failed; a short vm.tiktok.com link always starts a new one. The asset is not changed. The profile names techniques; it " +
+    "copies no face, voice, music or brand of the reference.";
+export const GET_REFERENCE_ANALYSIS_DESCRIPTION = "Read an analysis started by analyze_reference: state queued or analyzing, succeeded with reference_profile (mode full) " +
+    "or data (mode data) and warnings, or failed with error.code and error.message (timed_out, analysis_failed, asset_gone, " +
+    "enqueue_failed); source holds the post's metrics for an analysis started by source_url. " +
+    "credits_charged is the price once succeeded, 0 once failed. Free.";
+export const QUOTE_ANALYSIS_DESCRIPTION = "Price analyze_reference for an asset_id or a source_url and a mode before starting it: credits_estimate is what a start " +
+    `holds and charges once it succeeds (${REFERENCE_ANALYSIS_CREDITS} full, ${REFERENCE_DATA_CREDITS} data), 0 when the ` +
+    "asset or the reel already has an analysis in that mode that a start would answer (replays_analysis_id). A YouTube or " +
+    "unknown link is refused here too. Free; starts nothing.";
+//# sourceMappingURL=reference-analysis.js.map

package/dist/reference-analysis.js.map

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

package/dist/reference-kinds.d.ts

@@ -0,0 +1,8 @@
+/** Our template kinds, media laid over or instead of the presenter, a split layout, and what we cannot draw yet. */
+export declare const REFERENCE_GRAPHIC_KINDS: readonly ["tag", "lower_third", "end_card", "title_card", "quote", "stat", "callout", "checklist", "phone_call", "compare", "notification", "progress", "rating", "overlay_media", "insert_media", "layout_split", "particles", "unmapped"];
+export type ReferenceGraphicKind = (typeof REFERENCE_GRAPHIC_KINDS)[number];
+/** Kinds an analysis also reads from an element's description when the model said other: what the Ana reel's answer called other (#930). */
+export declare const REFERENCE_DESCRIBED_KINDS: readonly ["banner", "logo_card", "comment_box", "price_card", "concept_card"];
+/** The analyser's names for a graphic: its prompt's own list, plus ours. */
+export declare const REFERENCE_SOURCE_KINDS: readonly ["toggle_checklist", "phone_call", "notification", "before_after_split", "split_screen", "stat", "product_ui", "screenshot", "title_card", "end_card", "particles", "banner", "logo_card", "comment_box", "price_card", "concept_card", "tag", "lower_third", "end_card", "title_card", "quote", "stat", "callout", "checklist", "phone_call", "compare", "notification", "progress", "rating", "overlay_media", "insert_media", "layout_split", "particles", "unmapped", "other"];
+export type ReferenceSourceKind = (typeof REFERENCE_SOURCE_KINDS)[number];

package/dist/reference-kinds.js

@@ -0,0 +1,10 @@
+import { TEMPLATE_KIND_IDS } from "./templates/index.js";
+// A reference graphic's kinds, shared by the profile's beats and its staging (#914): their own module, so neither imports the other.
+/** Our template kinds, media laid over or instead of the presenter, a split layout, and what we cannot draw yet. */
+export const REFERENCE_GRAPHIC_KINDS = [...TEMPLATE_KIND_IDS, "overlay_media", "insert_media", "layout_split", "particles", "unmapped"];
+/** Kinds an analysis also reads from an element's description when the model said other: what the Ana reel's answer called other (#930). */
+export const REFERENCE_DESCRIBED_KINDS = ["banner", "logo_card", "comment_box", "price_card", "concept_card"];
+/** The analyser's names for a graphic: its prompt's own list, plus ours. */
+export const REFERENCE_SOURCE_KINDS = ["toggle_checklist", "phone_call", "notification", "before_after_split", "split_screen", "stat", "product_ui",
+    "screenshot", "title_card", "end_card", "particles", ...REFERENCE_DESCRIBED_KINDS, ...REFERENCE_GRAPHIC_KINDS, "other"];
+//# sourceMappingURL=reference-kinds.js.map

package/dist/reference-kinds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-kinds.js","sourceRoot":"","sources":["../src/reference-kinds.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,qIAAqI;AAErI,oHAAoH;AACpH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,GAAG,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,CAAU,CAAC;AAEjJ,4IAA4I;AAC5I,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,CAAU,CAAC;AACvH,4EAA4E;AAC5E,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,kBAAkB,EAAE,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,EAAE,YAAY;IACjJ,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,yBAAyB,EAAE,GAAG,uBAAuB,EAAE,OAAO,CAAU,CAAC"}