target-supabase-sdk 0.2.20 → 0.2.22

package/dist/shared/feed/feed.build.d.ts

@@ -3,9 +3,11 @@ import type { Link } from "../../link/link.interface";
 import { type FeedSource, type FeedValue } from "./feed.interface";
 export interface BuildFeedLinkDraftInput {
     value: FeedValue;
+    /** When set, used as Link `name` (skips {@link buildFeedLinkName}). */
+    name?: string;
     /** Dots are normalized to spaces in {@link buildFeedLinkName} before joining with `feedKey`. */
-    platformName: string;
-    feedKey: string;
+    platformName?: string;
+    feedKey?: string;
     source: FeedSource;
     locator: string;
     /**

package/dist/shared/feed/feed.build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feed.build.d.ts","sourceRoot":"","sources":["../../../src/shared/feed/feed.build.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAGH,KAAK,UAAU,EACf,KAAK,SAAS,EAGjB,MAAM,kBAAkB,CAAC;AAG1B,MAAM,WAAW,uBAAuB;IACpC,KAAK,EAAE,SAAS,CAAC;IACjB,gGAAgG;IAChG,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sFAAsF;IACtF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,qEAAqE;AACrE,wBAAgB,qBAAqB,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,SAAS,CAK/E;AAED,iFAAiF;AACjF,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,UAAU,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,CAcvG;AAED,gGAAgG;AAChG,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAKjF;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,GAAG,WAAW,CAAC,IAAI,CAAC,CA+BpF"}
+{"version":3,"file":"feed.build.d.ts","sourceRoot":"","sources":["../../../src/shared/feed/feed.build.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAGH,KAAK,UAAU,EACf,KAAK,SAAS,EAGjB,MAAM,kBAAkB,CAAC;AAG1B,MAAM,WAAW,uBAAuB;IACpC,KAAK,EAAE,SAAS,CAAC;IACjB,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gGAAgG;IAChG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sFAAsF;IACtF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,qEAAqE;AACrE,wBAAgB,qBAAqB,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,SAAS,CAK/E;AAED,iFAAiF;AACjF,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,UAAU,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,CAcvG;AAED,gGAAgG;AAChG,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAKjF;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,GAAG,WAAW,CAAC,IAAI,CAAC,CAgCpF"}

package/dist/shared/feed/node/feed.access.d.ts

@@ -23,12 +23,20 @@ export interface FeedAvailabilityResult {
  * **Node-only**
  */
 export declare function checkFeedLocalAvailability(input: CheckFeedLocalAvailabilityInput): Promise<FeedAvailabilityResult>;
+export interface CheckFeedOssAvailabilityOptions {
+    /** Override global `fetch` (proxied outbound, etc.). Default: SDK `fetchWithRetry`. */
+    fetch?: (url: string, init?: RequestInit) => Promise<Response>;
+    /** When true, skip HTTP (co-located Files sandbox, etc.). */
+    tryLocalResolve?: (locator: string) => Promise<boolean>;
+    timeoutMs?: number;
+}
 /**
  * Remote reachability for feed ingest (`.oss` source) via HTTP(S).
  *
- * Tries `HEAD`, then `GET` with `Range: bytes=0-0` when `HEAD` is not allowed.
+ * Optional `tryLocalResolve` first (same-host Files). Then `HEAD`, then `GET` with
+ * `Range: bytes=0-0` when `HEAD` is not allowed. Pass `fetch` for proxied outbound.
  *
  * **Node-only**
  */
-export declare function checkFeedOssAvailability(locator: string): Promise<FeedAvailabilityResult>;
+export declare function checkFeedOssAvailability(locator: string, options?: CheckFeedOssAvailabilityOptions): Promise<FeedAvailabilityResult>;
 //# sourceMappingURL=feed.access.d.ts.map

package/dist/shared/feed/node/feed.access.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feed.access.d.ts","sourceRoot":"","sources":["../../../../src/shared/feed/node/feed.access.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,WAAW,+BAA+B;IAC5C,KAAK,EAAE,SAAS,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,oBAAoB,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,sBAAsB;IACnC,EAAE,EAAE,OAAO,CAAC;IACZ,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAUD;;;;;;;;;GASG;AACH,wBAAsB,0BAA0B,CAC5C,KAAK,EAAE,+BAA+B,GACvC,OAAO,CAAC,sBAAsB,CAAC,CA0CjC;AAoBD;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAsB/F"}
+{"version":3,"file":"feed.access.d.ts","sourceRoot":"","sources":["../../../../src/shared/feed/node/feed.access.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,WAAW,+BAA+B;IAC5C,KAAK,EAAE,SAAS,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,oBAAoB,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,sBAAsB;IACnC,EAAE,EAAE,OAAO,CAAC;IACZ,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAUD;;;;;;;;;GASG;AACH,wBAAsB,0BAA0B,CAC5C,KAAK,EAAE,+BAA+B,GACvC,OAAO,CAAC,sBAAsB,CAAC,CA0CjC;AAKD,MAAM,WAAW,+BAA+B;IAC5C,uFAAuF;IACvF,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/D,6DAA6D;IAC7D,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAsBD;;;;;;;GAOG;AACH,wBAAsB,wBAAwB,CAC1C,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,+BAA+B,GAC1C,OAAO,CAAC,sBAAsB,CAAC,CAgCjC"}

package/dist/shared/feed/node/feed.service.d.ts

@@ -1,4 +1,5 @@
-import { type FeedIngestSource } from "../feed.interface";
+import { type FeedIngestSource, type FeedValue } from "../feed.interface";
+import { type CheckFeedOssAvailabilityOptions } from "./feed.access";
 export interface RegisterFeedInput {
     /** Existing feed Link row id (must still be `.public` unless already ingested with same payload). */
     id: string;
@@ -7,6 +8,8 @@ export interface RegisterFeedInput {
     locator: string;
     /** Required when `source` is `.local` (e.g. `process.env.LOCAL_STORAGE_PROVIDER`). Ignored for `.oss`. */
     localStorageProvider?: string;
+    /** `.oss` HTTP check: inject `fetch` / same-host resolve. */
+    ossCheck?: CheckFeedOssAvailabilityOptions;
 }
 export interface RegisterFeedResult {
     id: string;
@@ -20,4 +23,26 @@ export interface RegisterFeedResult {
  * **Node-only** — under `shared/feed/node/`; do not import from the browser entry.
  */
 export declare function registerFeed(input: RegisterFeedInput): Promise<RegisterFeedResult>;
+export interface CreateFeedInput {
+    /** Full Link `name` (Filter itemName, etc.). */
+    name: string;
+    value: FeedValue;
+    source: FeedIngestSource;
+    storageProvider: string;
+    locator: string;
+    description?: string;
+    preview?: string;
+    tagList?: string[];
+    localStorageProvider?: string;
+    ossCheck?: CheckFeedOssAvailabilityOptions;
+}
+export interface CreateFeedResult {
+    id: string;
+    created: boolean;
+}
+/**
+ * Insert a new feed Link already on `.local` or `.oss` (not a `.public` promote).
+ * Dedup: `category` + `value` + `name`. Same original → `{ created: false }`.
+ */
+export declare function createFeed(input: CreateFeedInput): Promise<CreateFeedResult>;
 //# sourceMappingURL=feed.service.d.ts.map

package/dist/shared/feed/node/feed.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feed.service.d.ts","sourceRoot":"","sources":["../../../../src/shared/feed/node/feed.service.ts"],"names":[],"mappings":"AAKA,OAAO,EACH,KAAK,gBAAgB,EAKxB,MAAM,mBAAmB,CAAC;AAK3B,MAAM,WAAW,iBAAiB;IAC9B,qGAAqG;IACrG,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,gBAAgB,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,0GAA0G;IAC1G,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,kBAAkB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,gGAAgG;IAChG,OAAO,EAAE,OAAO,CAAC;CACpB;AAmDD;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA+FxF"}
+{"version":3,"file":"feed.service.d.ts","sourceRoot":"","sources":["../../../../src/shared/feed/node/feed.service.ts"],"names":[],"mappings":"AAWA,OAAO,EACH,KAAK,gBAAgB,EAErB,KAAK,SAAS,EAGjB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACH,KAAK,+BAA+B,EAGvC,MAAM,eAAe,CAAC;AAIvB,MAAM,WAAW,iBAAiB;IAC9B,qGAAqG;IACrG,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,gBAAgB,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,0GAA0G;IAC1G,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,+BAA+B,CAAC;CAC9C;AAED,MAAM,WAAW,kBAAkB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,gGAAgG;IAChG,OAAO,EAAE,OAAO,CAAC;CACpB;AAmDD;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA+FxF;AAED,MAAM,WAAW,eAAe;IAC5B,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,gBAAgB,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,EAAE,+BAA+B,CAAC;CAC9C;AAED,MAAM,WAAW,gBAAgB;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAyFlF"}

package/dist/shared/feed/node/index.d.ts

@@ -4,8 +4,8 @@
  */
 export type { FeedIngestSource } from "../feed.interface";
 export { FEED_INGEST_SOURCES, isFeedIngestSource } from "../feed.interface";
-export type { CheckFeedLocalAvailabilityInput, FeedAvailabilityResult } from "./feed.access";
+export type { CheckFeedLocalAvailabilityInput, CheckFeedOssAvailabilityOptions, FeedAvailabilityResult, } from "./feed.access";
 export { checkFeedLocalAvailability, checkFeedOssAvailability } from "./feed.access";
-export type { RegisterFeedInput, RegisterFeedResult } from "./feed.service";
-export { registerFeed } from "./feed.service";
+export type { CreateFeedInput, CreateFeedResult, RegisterFeedInput, RegisterFeedResult } from "./feed.service";
+export { createFeed, registerFeed } from "./feed.service";
 //# sourceMappingURL=index.d.ts.map

package/dist/shared/feed/node/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared/feed/node/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5E,YAAY,EAAE,+BAA+B,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAC7F,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACrF,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared/feed/node/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5E,YAAY,EACR,+BAA+B,EAC/B,+BAA+B,EAC/B,sBAAsB,GACzB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACrF,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC/G,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/shared/http/fetch-retry.d.ts

@@ -15,6 +15,8 @@ export interface FetchRetryOptions {
     /** When set, retry/success lines are logged via SDK logger. */
     logger?: LoggerWithScope;
     hint?: string;
+    /** Override global `fetch` (e.g. proxied outbound fetch). Ignores `dispatcher`. */
+    fetch?: (url: string, init?: RequestInit) => Promise<Response>;
 }
 export declare function fetchWithRetry(url: string, initOrFactory: RequestInit | FetchInitFactory, options: FetchRetryOptions): Promise<Response>;
 export declare function fetchBinaryWithRetry(url: string, init: RequestInit, options: FetchRetryOptions): Promise<ArrayBuffer>;

package/dist/shared/http/fetch-retry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-retry.d.ts","sourceRoot":"","sources":["../../../src/shared/http/fetch-retry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAOpD,2DAA2D;AAC3D,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED,MAAM,MAAM,gBAAgB,GAAG,MAAM,WAAW,CAAC;AAEjD,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAEzD;AAED,MAAM,WAAW,iBAAiB;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6FAA6F;IAC7F,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAChD,+DAA+D;IAC/D,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AA8BD,wBAAsB,cAAc,CAChC,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,WAAW,GAAG,gBAAgB,EAC7C,OAAO,EAAE,iBAAiB,GAC3B,OAAO,CAAC,QAAQ,CAAC,CAoEnB;AAED,wBAAsB,oBAAoB,CACtC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,iBAAiB,GAC3B,OAAO,CAAC,WAAW,CAAC,CAMtB"}
+{"version":3,"file":"fetch-retry.d.ts","sourceRoot":"","sources":["../../../src/shared/http/fetch-retry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAOpD,2DAA2D;AAC3D,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED,MAAM,MAAM,gBAAgB,GAAG,MAAM,WAAW,CAAC;AAEjD,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAEzD;AAED,MAAM,WAAW,iBAAiB;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6FAA6F;IAC7F,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAChD,+DAA+D;IAC/D,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mFAAmF;IACnF,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;CAClE;AAuCD,wBAAsB,cAAc,CAChC,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,WAAW,GAAG,gBAAgB,EAC7C,OAAO,EAAE,iBAAiB,GAC3B,OAAO,CAAC,QAAQ,CAAC,CAoEnB;AAED,wBAAsB,oBAAoB,CACtC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,iBAAiB,GAC3B,OAAO,CAAC,WAAW,CAAC,CAMtB"}

package/dist/shared/media/node/media.service.d.ts

@@ -1,4 +1,4 @@
-import type { Link } from "../../../link/link.interface";
+import { type Link } from "../../../link/link.interface";
 import { type MediaValue } from "../media.interface";
 export interface FindMediaLinkInput {
     value: MediaValue;
@@ -13,6 +13,11 @@ export interface RegisterMediaLinkInput {
     locator: string;
     /** This host id for availability (e.g. `process.env.LOCAL_STORAGE_PROVIDER`). */
     localStorageProvider: string;
+    /**
+     * Local file to probe when `locator` is http(s) (OSS ingest).
+     * Availability uses this path + `localStorageProvider`.
+     */
+    localLocator?: string;
     description?: string;
     tagList?: string[];
 }
@@ -22,7 +27,8 @@ export interface RegisterMediaLinkResult {
 }
 /**
  * Register a media Link: dedup → availability → probe → `postTarget`.
- * Idempotent when `category`+`value`+`name` already exist.
+ * Idempotent when `category`+`value`+`name` already exist (local path).
+ * HTTP `locator` + `localLocator`: probe local file, persist remote URL; patch if name exists.
  *
  * **Node-only** — under `shared/media/node/`; do not import from the browser entry.
  */

package/dist/shared/media/node/media.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"media.service.d.ts","sourceRoot":"","sources":["../../../../src/shared/media/node/media.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AAGzD,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAMnE,MAAM,WAAW,kBAAkB;IAC/B,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,wDAAwD;AACxD,wBAAsB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAYnF;AAED,MAAM,WAAW,sBAAsB;IACnC,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,oBAAoB,EAAE,MAAM,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CA4EvG"}
+{"version":3,"file":"media.service.d.ts","sourceRoot":"","sources":["../../../../src/shared/media/node/media.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,IAAI,EAAoB,MAAM,8BAA8B,CAAC;AAIzF,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAMnE,MAAM,WAAW,kBAAkB;IAC/B,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,wDAAwD;AACxD,wBAAsB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAYnF;AAED,MAAM,WAAW,sBAAsB;IACnC,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,oBAAoB,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;CACpB;AA6CD;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CA6FvG"}

package/dist/shared/review/index.d.ts

@@ -3,5 +3,5 @@
  */
 export type { BuildReviewLinkDraftInput } from "./review.build";
 export { buildReviewLinkDraft } from "./review.build";
-export { reviewLinksForTargetFilters } from "./review.query";
+export { reviewLinksForNameFilters } from "./review.query";
 //# sourceMappingURL=index.d.ts.map

package/dist/shared/review/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/review/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/review/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/shared/review/review.build.d.ts

@@ -1,11 +1,8 @@
 import type { TargetDraft } from "../../core.interface";
 import type { Link } from "../../link/link.interface";
-import { type ReviewValue } from "./review.interface";
 export interface BuildReviewLinkDraftInput {
-    /** Must be {@link REVIEW_VALUE}. */
-    value: ReviewValue;
-    /** Associated Target id — written to `Link.name`. */
-    refId: string;
+    /** Written to `Link.name` (caller-defined; often a subject Target id). */
+    name: string;
     /** Interaction payload — written to `Link.details.original`. */
     original: unknown;
     tagList?: string[];
@@ -13,7 +10,7 @@ export interface BuildReviewLinkDraftInput {
 }
 /**
  * Assemble a review {@link Link} draft (`category=link`, `loaderKey === value === "review"`).
- * Does not validate `refId` existence or write to Supabase.
+ * Does not validate `name` or write to Supabase.
  */
 export declare function buildReviewLinkDraft(input: BuildReviewLinkDraftInput): TargetDraft<Link>;
 //# sourceMappingURL=review.build.d.ts.map

package/dist/shared/review/review.build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"review.build.d.ts","sourceRoot":"","sources":["../../../src/shared/review/review.build.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAA+B,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEnF,MAAM,WAAW,yBAAyB;IACtC,oCAAoC;IACpC,KAAK,EAAE,WAAW,CAAC;IACnB,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,yBAAyB,GAAG,WAAW,CAAC,IAAI,CAAC,CAkBxF"}
+{"version":3,"file":"review.build.d.ts","sourceRoot":"","sources":["../../../src/shared/review/review.build.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,2BAA2B,CAAC;AAGtD,MAAM,WAAW,yBAAyB;IACtC,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,yBAAyB,GAAG,WAAW,CAAC,IAAI,CAAC,CAexF"}

package/dist/shared/review/review.interface.d.ts

@@ -2,8 +2,8 @@
  * Review Link protocol — Link rows with `value` / `loaderKey` === {@link REVIEW_VALUE}.
  * No separate Target category; category remains `link`.
  *
- * A Review records one user interaction with a subject Target (`Link.name` = that Target's id).
- * Many review Links may share the same subject id.
+ * A Review records one user interaction; `Link.name` is caller-defined (often a subject Target id).
+ * Many review Links may share the same `name`.
  */
 export declare const REVIEW_VALUE: "review";
 /** Discriminator stored in both `Link.value` and `details.loaderKey`. */

package/dist/shared/review/review.query.d.ts

@@ -1,7 +1,7 @@
 import type { QueryFilter } from "../../core.interface";
 /**
- * Filters for all review Links whose subject Target is `refId` (`Link.name === refId`).
+ * Filters for review Links with `Link.name === name`.
  * Many rows may match — the SDK does not define dedup for reviews.
  */
-export declare function reviewLinksForTargetFilters(refId: string): QueryFilter[];
+export declare function reviewLinksForNameFilters(name: string): QueryFilter[];
 //# sourceMappingURL=review.query.d.ts.map

package/dist/shared/review/review.query.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"review.query.d.ts","sourceRoot":"","sources":["../../../src/shared/review/review.query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAIxD;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE,CAOxE"}
+{"version":3,"file":"review.query.d.ts","sourceRoot":"","sources":["../../../src/shared/review/review.query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAIxD;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CAOrE"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "target-supabase-sdk",
-    "version": "0.2.20",
+    "version": "0.2.22",
     "description": "Supabase client initializer and data access APIs",
     "license": "MIT",
     "author": "KyLoc20",

package/src/browser.ts

@@ -242,7 +242,7 @@ export {
     mediaLinkDedupFilters,
 } from "./shared/media";
 export type { BuildReviewLinkDraftInput } from "./shared/review";
-export { buildReviewLinkDraft, reviewLinksForTargetFilters } from "./shared/review";
+export { buildReviewLinkDraft, reviewLinksForNameFilters } from "./shared/review";
 export { isHttpUrl, resolveFetchUrl } from "./shared/utils/fetch-url";
 export { getValueAtPath } from "./shared/utils/get-value-at-path";
 export type {

package/src/node.ts

@@ -160,6 +160,9 @@ export {
 export { RepoManager } from "./repo/repo-manager";
 export type {
     CheckFeedLocalAvailabilityInput,
+    CheckFeedOssAvailabilityOptions,
+    CreateFeedInput,
+    CreateFeedResult,
     FeedAvailabilityResult,
     FeedIngestSource,
     RegisterFeedInput,
@@ -168,6 +171,7 @@ export type {
 export {
     checkFeedLocalAvailability,
     checkFeedOssAvailability,
+    createFeed,
     FEED_INGEST_SOURCES,
     isFeedIngestSource,
     registerFeed,

package/src/shared/feed/README.md

@@ -36,7 +36,7 @@ import {
 } from "target-supabase-sdk";
 
 // Node — ingest after .public draft exists
-import { registerFeed, FEED_INGEST_SOURCES } from "target-supabase-sdk/node";
+import { registerFeed, createFeed, checkFeedOssAvailability, FEED_INGEST_SOURCES } from "target-supabase-sdk/node";
 ```
 
 ---
@@ -45,6 +45,7 @@ import { registerFeed, FEED_INGEST_SOURCES } from "target-supabase-sdk/node";
 
 1. **Create (browser or any host)** — `buildFeedLinkDraft` with `source: ".public"`, public `locator` (often a platform URL), `original.storageProvider: ""`. Persist via `postTarget` / `createTarget`.
 2. **Ingest (Node)** — `registerFeed` on an existing row `id`: validate the new locator, then promote `tagList` from `.public` to `.local` or `.oss` and update `original.storageProvider` + `locator`. Preserves `twinList` and other non-source tags.
+3. **Create already ingested (Node)** — `createFeed` inserts a new row already tagged `.local` or `.oss` (Filter / OSS-first). Dedup on `category` + `value` + `name`.
 
 ---
 
@@ -108,7 +109,7 @@ Leading `.` marks **system** tags (not user tags).
 3. Require `tagList` to include `.public` (not already ingested with different state).
 4. **Availability**
    - `.local` — `checkFeedLocalAvailability`: `storageProvider === localStorageProvider`, absolute path, file (or directory for `feed.image-list`) exists and is non-empty where applicable.
-   - `.oss` — `checkFeedOssAvailability`: `http(s)` URL; `HEAD`, then `GET` with `Range: bytes=0-0` if `HEAD` is not supported.
+   - `.oss` — `checkFeedOssAvailability`: `http(s)` URL; optional `tryLocalResolve` then `HEAD`, then `GET` with `Range: bytes=0-0` if `HEAD` is not supported. Pass `ossCheck.fetch` for proxied outbound.
 5. **Update** — `updateTarget` with optimistic lock `details->original->>storageProvider` eq `""` (still `.public` tier). Sets `tagList` via `buildFeedTagList`, updates `original.storageProvider` and `locator`, keeps `twinList`.
 
 **Errors (representative)**
@@ -149,7 +150,7 @@ Same variable as media register — see `src/shared/media/README.md`.
 
 | Topic | Current behavior | Possible follow-up |
 |-------|------------------|-------------------|
-| OSS auth | Only anonymous `HEAD`/`GET` | Signed URLs or provider-specific probes |
+| OSS HTTP | Default global `fetch`; inject `fetch` / `tryLocalResolve` | Signed URLs or provider-specific probes |
 | `.local` on another host | Fails availability (by design, like media) | Remote agent ingest |
 | `twinList` on ingest | Not re-validated | Optional probe per twin |
 | Re-ingest / migrate `.local` → `.oss` | Not supported | New API with lock on prior source tag |

package/src/shared/feed/feed.build.ts

@@ -13,9 +13,11 @@ import { buildFeedLinkName } from "./feed.name";
 
 export interface BuildFeedLinkDraftInput {
     value: FeedValue;
+    /** When set, used as Link `name` (skips {@link buildFeedLinkName}). */
+    name?: string;
     /** Dots are normalized to spaces in {@link buildFeedLinkName} before joining with `feedKey`. */
-    platformName: string;
-    feedKey: string;
+    platformName?: string;
+    feedKey?: string;
     source: FeedSource;
     locator: string;
     /**
@@ -75,7 +77,8 @@ export function buildFeedLinkDraft(input: BuildFeedLinkDraftInput): TargetDraft<
         throw new Error(`buildFeedLinkDraft: unsupported feed source: ${String(input.source)}`);
     }
 
-    const name = buildFeedLinkName(input.platformName, input.feedKey);
+    const explicitName = input.name?.trim() ?? "";
+    const name = explicitName !== "" ? explicitName : buildFeedLinkName(input.platformName ?? "", input.feedKey ?? "");
     const locator = input.locator.trim();
     if (locator === "") {
         throw new Error("buildFeedLinkDraft: locator is empty");

package/src/shared/feed/node/feed.access.ts

@@ -87,7 +87,19 @@ export async function checkFeedLocalAvailability(
 const OSS_CHECK_TIMEOUT_MS = 15_000;
 const OSS_CHECK_MAX_ATTEMPTS = 2;
 
-async function probeHttpLocator(locator: string, method: "HEAD" | "GET"): Promise<Response> {
+export interface CheckFeedOssAvailabilityOptions {
+    /** Override global `fetch` (proxied outbound, etc.). Default: SDK `fetchWithRetry`. */
+    fetch?: (url: string, init?: RequestInit) => Promise<Response>;
+    /** When true, skip HTTP (co-located Files sandbox, etc.). */
+    tryLocalResolve?: (locator: string) => Promise<boolean>;
+    timeoutMs?: number;
+}
+
+async function probeHttpLocator(
+    locator: string,
+    method: "HEAD" | "GET",
+    options?: CheckFeedOssAvailabilityOptions,
+): Promise<Response> {
     return fetchWithRetry(
         locator,
         {
@@ -96,8 +108,9 @@ async function probeHttpLocator(locator: string, method: "HEAD" | "GET"): Promis
         },
         {
             label: "feed-oss-check",
-            timeoutMs: OSS_CHECK_TIMEOUT_MS,
+            timeoutMs: options?.timeoutMs ?? OSS_CHECK_TIMEOUT_MS,
             maxAttempts: OSS_CHECK_MAX_ATTEMPTS,
+            ...(options?.fetch != null ? { fetch: options.fetch } : {}),
         },
     );
 }
@@ -105,11 +118,15 @@ async function probeHttpLocator(locator: string, method: "HEAD" | "GET"): Promis
 /**
  * Remote reachability for feed ingest (`.oss` source) via HTTP(S).
  *
- * Tries `HEAD`, then `GET` with `Range: bytes=0-0` when `HEAD` is not allowed.
+ * Optional `tryLocalResolve` first (same-host Files). Then `HEAD`, then `GET` with
+ * `Range: bytes=0-0` when `HEAD` is not allowed. Pass `fetch` for proxied outbound.
  *
  * **Node-only**
  */
-export async function checkFeedOssAvailability(locator: string): Promise<FeedAvailabilityResult> {
+export async function checkFeedOssAvailability(
+    locator: string,
+    options?: CheckFeedOssAvailabilityOptions,
+): Promise<FeedAvailabilityResult> {
     const trimmed = locator.trim();
     if (trimmed === "") {
         return { ok: false, reason: "locator is empty" };
@@ -118,10 +135,20 @@ export async function checkFeedOssAvailability(locator: string): Promise<FeedAva
         return { ok: false, reason: `oss locator must be an http(s) URL: ${trimmed}` };
     }
 
+    if (options?.tryLocalResolve != null) {
+        try {
+            if (await options.tryLocalResolve(trimmed)) {
+                return { ok: true };
+            }
+        } catch {
+            // fall through to HTTP
+        }
+    }
+
     try {
-        let response = await probeHttpLocator(trimmed, "HEAD");
+        let response = await probeHttpLocator(trimmed, "HEAD", options);
         if (response.status === 405 || response.status === 501) {
-            response = await probeHttpLocator(trimmed, "GET");
+            response = await probeHttpLocator(trimmed, "GET", options);
         }
         if (response.ok || (response.status >= 200 && response.status < 400)) {
             return { ok: true };

package/src/shared/feed/node/feed.service.ts

@@ -1,8 +1,14 @@
-import { getTarget, updateTarget } from "../../../core.api";
+import {
+    getPossibleTarget,
+    getTarget,
+    isCreateTargetAlreadyExistsError,
+    postTarget,
+    updateTarget,
+} from "../../../core.api";
 import type { Target } from "../../../core.interface";
 import { CategoryLink, type Link, type LinkDetails } from "../../../link/link.interface";
 import { createLogger } from "../../log/core/create-logger";
-import { buildFeedTagList, resolveFeedOriginalStorageProvider } from "../feed.build";
+import { buildFeedLinkDraft, buildFeedTagList, resolveFeedOriginalStorageProvider } from "../feed.build";
 import {
     type FeedIngestSource,
     type FeedOriginal,
@@ -10,7 +16,12 @@ import {
     isFeedIngestSource,
     isFeedValue,
 } from "../feed.interface";
-import { checkFeedLocalAvailability, checkFeedOssAvailability } from "./feed.access";
+import { feedLinkDedupFilters } from "../feed.query";
+import {
+    type CheckFeedOssAvailabilityOptions,
+    checkFeedLocalAvailability,
+    checkFeedOssAvailability,
+} from "./feed.access";
 
 const logger = createLogger({ module: "feed" });
 
@@ -22,6 +33,8 @@ export interface RegisterFeedInput {
     locator: string;
     /** Required when `source` is `.local` (e.g. `process.env.LOCAL_STORAGE_PROVIDER`). Ignored for `.oss`. */
     localStorageProvider?: string;
+    /** `.oss` HTTP check: inject `fetch` / same-host resolve. */
+    ossCheck?: CheckFeedOssAvailabilityOptions;
 }
 
 export interface RegisterFeedResult {
@@ -137,7 +150,7 @@ export async function registerFeed(input: RegisterFeedInput): Promise<RegisterFe
             throw new Error(`registerFeed: local locator unavailable — ${availability.reason ?? "unknown"}`);
         }
     } else {
-        const availability = await checkFeedOssAvailability(locator);
+        const availability = await checkFeedOssAvailability(locator, input.ossCheck);
         if (!availability.ok) {
             throw new Error(`registerFeed: oss locator unavailable — ${availability.reason ?? "unknown"}`);
         }
@@ -181,3 +194,117 @@ export async function registerFeed(input: RegisterFeedInput): Promise<RegisterFe
     });
     return { id, updated: true };
 }
+
+export interface CreateFeedInput {
+    /** Full Link `name` (Filter itemName, etc.). */
+    name: string;
+    value: FeedValue;
+    source: FeedIngestSource;
+    storageProvider: string;
+    locator: string;
+    description?: string;
+    preview?: string;
+    tagList?: string[];
+    localStorageProvider?: string;
+    ossCheck?: CheckFeedOssAvailabilityOptions;
+}
+
+export interface CreateFeedResult {
+    id: string;
+    created: boolean;
+}
+
+/**
+ * Insert a new feed Link already on `.local` or `.oss` (not a `.public` promote).
+ * Dedup: `category` + `value` + `name`. Same original → `{ created: false }`.
+ */
+export async function createFeed(input: CreateFeedInput): Promise<CreateFeedResult> {
+    if (!isFeedValue(input.value)) {
+        throw new Error(`createFeed: unsupported feed value: ${String(input.value)}`);
+    }
+    if (!isFeedIngestSource(input.source)) {
+        throw new Error(`createFeed: source must be .local or .oss, got ${String(input.source)}`);
+    }
+
+    const name = input.name.trim();
+    if (name === "") {
+        throw new Error("createFeed: name is empty");
+    }
+
+    const resolvedStorageProvider = resolveFeedOriginalStorageProvider(input.source, input.storageProvider);
+    const locator = input.locator.trim();
+    if (locator === "") {
+        throw new Error("createFeed: locator is empty");
+    }
+
+    const { data: existing } = await getPossibleTarget({
+        filterList: feedLinkDedupFilters({ value: input.value, name }),
+    });
+    if (existing != null) {
+        const link = existing as Link;
+        if (isSameIngestState(link, input.source, resolvedStorageProvider, locator)) {
+            return { id: existing.id, created: false };
+        }
+        throw new Error("createFeed: feed name already exists with different source, storageProvider, or locator");
+    }
+
+    if (input.source === ".local") {
+        const localStorageProvider = input.localStorageProvider?.trim() ?? "";
+        if (localStorageProvider === "") {
+            throw new Error("createFeed: localStorageProvider is required when source is .local");
+        }
+        const availability = await checkFeedLocalAvailability({
+            value: input.value,
+            storageProvider: resolvedStorageProvider,
+            locator,
+            localStorageProvider,
+        });
+        if (!availability.ok) {
+            throw new Error(`createFeed: local locator unavailable — ${availability.reason ?? "unknown"}`);
+        }
+    } else {
+        const availability = await checkFeedOssAvailability(locator, input.ossCheck);
+        if (!availability.ok) {
+            throw new Error(`createFeed: oss locator unavailable — ${availability.reason ?? "unknown"}`);
+        }
+    }
+
+    const draft = buildFeedLinkDraft({
+        name,
+        value: input.value,
+        source: input.source,
+        storageProvider: resolvedStorageProvider,
+        locator,
+        description: input.description,
+        preview: input.preview ?? locator,
+        tagList: input.tagList,
+    });
+
+    try {
+        const { data, error } = await postTarget({
+            name: draft.name,
+            value: draft.value,
+            category: draft.category,
+            tagList: draft.tagList,
+            details: draft.details,
+        });
+        if (error != null || data == null) {
+            throw new Error(error?.message ?? "createFeed: postTarget failed");
+        }
+        logger.info("feed created", {
+            topic: "register",
+            data: { id: data.id, source: input.source, name, locator },
+        });
+        return { id: data.id, created: true };
+    } catch (error) {
+        if (isCreateTargetAlreadyExistsError(error)) {
+            const raced = await getPossibleTarget({
+                filterList: feedLinkDedupFilters({ value: input.value, name }),
+            });
+            if (raced.data != null) {
+                return { id: raced.data.id, created: false };
+            }
+        }
+        throw error;
+    }
+}

package/src/shared/feed/node/index.ts

@@ -5,7 +5,11 @@
 
 export type { FeedIngestSource } from "../feed.interface";
 export { FEED_INGEST_SOURCES, isFeedIngestSource } from "../feed.interface";
-export type { CheckFeedLocalAvailabilityInput, FeedAvailabilityResult } from "./feed.access";
+export type {
+    CheckFeedLocalAvailabilityInput,
+    CheckFeedOssAvailabilityOptions,
+    FeedAvailabilityResult,
+} from "./feed.access";
 export { checkFeedLocalAvailability, checkFeedOssAvailability } from "./feed.access";
-export type { RegisterFeedInput, RegisterFeedResult } from "./feed.service";
-export { registerFeed } from "./feed.service";
+export type { CreateFeedInput, CreateFeedResult, RegisterFeedInput, RegisterFeedResult } from "./feed.service";
+export { createFeed, registerFeed } from "./feed.service";